Mobil Uygulamalar için sGTM

​

Genel Bakış

Server-side tagging, mobil uygulamalarınızdan toplanan verilerin analitik platformlarınıza iletilmeden önce bir server container aracılığıyla işlenmesine olanak tanır. Bu yaklaşım, geleneksel client-side uygulamalara göre çeşitli avantajlar sunar:

• Gelişmiş Gizlilik: Hassas verileri üçüncü taraf araçlara ulaşmadan önce işleyin ve filtreleyin
• Daha İyi Güvenilirlik: Ad blocker’ları ve tracking önleme tedbirlerini aşın
• Daha İyi Performans: Tracking çağrılarını birleştirerek mobil uygulama ağ yükünü azaltın
• Daha Fazla Kontrol: Verileri hedeflere göndermeden önce dönüştürün, zenginleştirin ve doğrulayın

Bu rehber, Google Tag Manager kullanarak iOS ve Android mobil uygulamalarınız için server-side tagging kurulumunu adım adım anlatacaktır.

​

Ön Koşullar

Kurulum sürecine başlamadan önce, şunlara sahip olduğunuzdan emin olun:

• Mobil uygulamanızda entegre edilmiş Google Analytics for Firebase SDK (bir Google Analytics 4 property’sine bağlı)
• Server container’lı bir Google Tag Manager hesabı
• Hardal Hesabı

Bu ön koşulları tamamlamadıysanız, lütfen aşağıdaki kaynaklara başvurun:

• Google Analytics for Firebase SDK dokümantasyonu

​

Uygulama Adımları

Mobil uygulamalar için server-side tagging kurulumu üç ana adımı içerir:

1. Mobil uygulamanızı server-side tagging için hazırlama
2. Server container’ınızı mobil trafiği destekleyecek şekilde yapılandırma
3. GA4 property’nizde server-side tagging’i etkinleştirme

Her adımı detaylı olarak inceleyelim.

​

Adım 1: Uygulamanızı Server-Side Tagging için Hazırlayın

​

iOS Kurulumu

iOS uygulamanızı server-side tagging için hazırlamak için şu adımları izleyin:

1. En son Firebase SDK’yı yükleyin

   iOS uygulamanızda Google Analytics for Firebase SDK’nın en son sürümünü kullandığınızdan emin olun.

2. Info.plist’i güncelleyin

   Server-side tagging yükleme özelliğini etkinleştirin ve Info.plist dosyanızda server-side tagging hata ayıklama modu için custom URL şemasını ayarlayın. BUNDLE_ID’yi uygulamanızın bundle tanımlayıcısı ile değiştirin.

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
   ...
           <key>CFBundleURLTypes</key>
           <array>
                   <dict>
                           <key>CFBundleTypeRole</key>
                           <string>None</string>
                           <key>CFBundleURLName</key>
                           <string>BUNDLE_ID</string>
                           <key>CFBundleURLSchemes</key>
                           <array>
                                   <string>tagmanager.sgtm.c.BUNDLE_ID</string>
                           </array>
                   </dict>
           </array>
           <key>GOOGLE_ANALYTICS_SGTM_UPLOAD_ENABLED</key>
           <true/>
   </dict>
   </plist>
   

3. URL işlemeyi yapılandırın

   Hata ayıklama veya önizleme modunu etkinleştirmek için, başlatma URL’sini iletmek üzere Analytics.handleOpen(_:) çağrısı ekleyin:

   SwiftUI uygulamaları için:

   @main
   struct MyApplication: App {
     var body: some Scene {
       WindowGroup {
         ContentView()
           .onOpenURL { url in
             Analytics.handleOpen(url)
           }
       }
     }
   }
   

​

Android Kurulumu

Android uygulamanızı server-side tagging için hazırlamak için şu adımları izleyin:

1. En son Firebase SDK’yı yükleyin

   Android uygulamanızda Google Analytics for Firebase SDK’nın en son sürümünü kullandığınızdan emin olun.

2. AndroidManifest.xml’i güncelleyin

   Uygulamanızın AndroidManifest.xml dosyasına aşağıdakileri ekleyerek server-side GTM’i etkinleştirin. <APP_PACKAGE_ID>’yi uygulamanızın paket adıyla değiştirin.

   <!-- Önizleme modunu etkinleştirmek için Preview Activity -->
   <activity
       android:name="com.google.firebase.analytics.GoogleAnalyticsServerPreviewActivity"
       android:exported="true"
       android:noHistory="true" >
     <intent-filter>
       <action android:name="android.intent.action.VIEW" />
       <category android:name="android.intent.category.DEFAULT" />
       <category android:name="android.intent.category.BROWSABLE" />
       <data android:scheme="tagmanager.sgtm.c.<APP_PACKAGE_ID>" />
     </intent-filter>
   </activity>
   
   <!-- sGTM'e yüklemeleri etkinleştiren meta-data -->
   <meta-data android:name="google_analytics_sgtm_upload_enabled" android:value="true" />
   

​

Adım 2: Server Container’ınızı Mobil Trafik için Yapılandırın

​

Adım 3: GA4 Property’nizde Server-Side Tagging’i Etkinleştirin

​

Bilinen Sınırlamalar

Mobil uygulamalar için server-side tagging’i uygularken, şu sınırlamaların farkında olun:

​

Android Uygulamaları için:

• Google Play backend’i ile entegrasyona dayanan otomatik olarak kaydedilen uygulama içi satın alımlar, server container’a gönderilmeyecektir
• app_remove event’i raporlanmayacaktır
• Google Analytics’teki uygulama veri akışlarınızı Google Ads hesabınıza bağlamak, verilerin ve dönüşümlerin Google Ads’e aktarılmasını sağlamak için hâlâ gereklidir

​

Versiyon Geçmişi

• Nisan 2025: Google’ın mobil uygulamalar için server-side tagging dokümantasyonuna (son güncelleme Şubat 2025) dayalı ilk dokümantasyon sürümü