Mobil uygulamalar için sunucu tarafı etiketleme

Mobil uygulamalarınızı, Google Etiket Yöneticisi'nde sunucu tarafı etiketlemeyle çalışacak şekilde Firebase için Google Analytics SDK'sını kullanarak yapılandırabilirsiniz.

Sunucu tarafı etiketleme, verilerinizi Google Analytics gibi hedef ürünlere göndermeden önce hazırlamanızı, çıkartmanızı ve artırmanızı sağlar. Sunucu tarafı etiketleme hakkında daha fazla bilgi edinin.

Mobil uygulamalar için sunucu tarafı etiketlemeyi ayarlamak üzere:

1. Uygulamanızı sunucu tarafı etiketlemeye hazırlama
2. Sunucu kapsayıcınızı mobil trafiği destekleyecek şekilde yapılandırma
3. GA4 mülkünüzde sunucu tarafı etiketlemeyi etkinleştirme

Ön koşullar

• Firebase için Google Analytics SDK'sını uygulamanıza eklemeniz ve Google Analytics 4 mülkünüze bağlamanız gerekir. Firebase için Google Analytics SDK'sı hakkında daha fazla bilgi edinin.
• Bir Google Etiket Yöneticisi hesabına ve sunucu kapsayıcısına ihtiyacınız vardır. Hesabınız yoksa yeni bir Etiket Yöneticisi hesabı ve kapsayıcısı oluşturun.
• Etiketleme sunucusu oluşturmanız gerekir.

1. Adım: Uygulamanızı sunucu tarafı etiketleme için hazırlayın

iOS

1. Info.plist dosyasında sunucu tarafı etiketleme yükleme özelliğini etkinleştirin ve sunucu tarafı etiketleme hata ayıklama modu için özel URL şemasını ayarlayın. Aşağıdaki BUNDLE_ID ifadesini uygulamanın paket tanımlayıcısıyla 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>
   

2. Hata ayıklama veya önizleme modunu etkinleştirmek için, başlatma URL'sini iletmek üzere yaşam döngüsü yönteminde Analytics.handleOpen(_:) çağrısı ekleyin.

   Hızlı Kullanıcı Arayüzü

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

   UIScene

   class SceneDelegate: UIResponder, UIWindowSceneDelegate {
   func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
           options connectionOptions: UIScene.ConnectionOptions) {
   ...
       if let urlContext = connectionOptions.urlContexts.first {
           let url = urlContext.url
           Analytics.handleOpen(url)
       }
     }
   }
   

   SwiftUI veya UIScene kullanmayan uygulamalar için herhangi bir işlem yapmanız gerekmez. SDK, ApplicationDidFinishLaunchingNotification'ten başlatma URL'sini alır.

Yapay Zeka

1. Firebase için Google Analytics SDK'sının en son sürümünü yükleyin.

2. Uygulamanın AndroidManifest.xml dosyasına aşağıdakileri ekleyerek sGTM'yi etkinleştirin.

   <!-- Preview Activity to enable preview mode –->
     <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>
   
   <!-- Meta-data that enables uploads to sGTM –->
     <meta-data android:name="google_analytics_sgtm_upload_enabled" android:value="true" />
   

2. Adım: Sunucu kapsayıcınızı mobil trafiği destekleyecek şekilde yapılandırın

Aşağıdaki bölümde, mevcut bir sunucu tarafı etiketleme dağıtımınız olduğu ve bu dağıtımın kavramlarına aşina olduğunuz varsayılmıştır. Sunucu tarafı etiketleme konusunda yeniyseniz sunucu tarafı etiketlemeyle ilgili temel bilgiler kursuna katılabilirsiniz.

Google Analytics: GA4 (uygulama) istemcisini ayarlama

İstemci, belirli türde gelen isteklerin yolunu kesen ve Google Analytics 4 gibi bir hedefe iletilebilecek etkinlikler oluşturan bir Etiket Yöneticisi kaynak türüdür. Bu durumda HTTP isteği bir Google Analytics 4 etkinliği olduğundan yerleşik Google Analytics: GA4 (uygulama) istemcisini yapılandırmanız gerekir. GA SDK'sı ve web sitesi gibi her veri kaynağı için yalnızca bir GA4 istemcisine ihtiyacınız vardır. İstemcilerin işleyiş şekli hakkında daha fazla bilgi edinin.

1. Sunucu kapsayıcınızda İstemciler'e gidip Yeni'yi tıklayın.

2. İstemci Yapılandırması'nı tıklayın, ardından Google Analytics: GA4 (Uygulama) seçeneğini belirleyin.

   

3. Müşteriniz için bir ad girin ve Kaydet'i tıklayın.

Google Analytics: GA4 etiketinizi yapılandırma

Google Analytics'e veri göndermek için sunucu kapsayıcısında bir Google Analytics: GA4 etiketi oluşturmanız gerekir. İstemci, gelen HTTP isteğini bir etkinlik verileri nesnesine ayırır. Etiket, bu etkinlik verileri nesnesini alır, doğru biçimle eşler ve ardından Google Analytics 4'e gönderir.

1. Sunucu kapsayıcınızda Etiketler'e gidin ve Yeni'yi tıklayın.

2. Etiket Yapılandırması'nı tıklayın, ardından Google Analytics: GA4'ü seçin.

   

Etiket, varsayılan olarak istemci tarafından oluşturulan etkinlik verileri nesnesinden tüm ilgili alanları ve parametreleri devralır:

• Gelen Google Analytics 4 isteği Google Analytics: GA4 (Uygulama) istemcisini geçerse etiket, uygulama kimliğini ve etkinlik parametrelerini devralır.
• Gelen Google Analytics 4 istekleri Google Analytics: GA4 (Web) istemcisinden geçerse etiket, Ölçüm Kimliği ve etkinlik parametrelerini devralır.

İpucu: İsteğe bağlı olarak, istemcinizden etiketlere sunulmadan önce etkinlik parametrelerini dahil etmek, hariç tutmak veya değiştirmek için dönüşümleri kullanabilirsiniz. Dönüşümlerden yararlanarak hassas bilgileri teminat altına alabilir ve hangi etkinlik parametrelerinin daha fazla işlenebileceği üzerinde ayrıntılı kontrol sahibi olabilirsiniz.

Mobil trafik için tetikleyiciler oluşturma

Ardından GA4 etiketinin ne zaman tetiklenmesi gerektiğini belirlemeniz gerekir. Google Analytics: GA4 (uygulama) istemcisi, gelen isteği bir etkinlik verileri nesnesine ayırır ve etiket, değerlerini devralır. Bu nedenle, GA4 istemcisi isteği talep ettiğinde etiketin tetiklenmesini genellikle istersiniz.

Tetikleyicileri ayarlamak için:

1. Etiket ayarlarında Tetikleyici'yi tıklayın.
2. Yeni bir tetikleyici oluşturmak için sağ üst köşedeki + simgesini tıklayın.
3. Tetikleyici türünü seçmek için Tetikleyici Yapılandırması'nı tıklayın.

4. Listeden Özel veya Özel Etkinlik'i seçin.

   • Özel tetikleyici türü, varsayılan olarak bir sunucu tarafı istemci tarafından herhangi bir etkinlik oluşturulduğunda etiketi tetikler.
   • Özel Etkinlik tetikleyici türü, etiketi belirli bir etkinlik adında veya normal ifade kalıbıyla eşleşen bir etkinlikte tetiklemek için kullanılabilir.

5. Bu tetikleyicinin etkinleşme koşullarının listesini (ör. yalnızca mobil veya web etkinliği verilerinde tetiklenmesi) etkinleştirmek için Bazı Etkinlikler'i seçin.

   1. Etkinlik Adı önceden seçilidir. Bu seçiciyi tıklayın ve listeden Yerleşik Değişken Seç'i belirleyin.
   2. Etkinliği oluşturan istemcinin adını otomatik olarak döndürmek için İstemci Adı'nı seçin.

   3. Koşulu uygun şekilde ayarlamak için daha önce yapılandırdığınız istemcinin adını kullanın. Tetikleyiciniz şu şekilde görünmelidir:

      

      Not: İstemcinin adı, önceki adımda belirttiğiniz addır. İstemci türü Google Analytics: GA4 (Uygulama). İstemci Adı değişkeni, istemcinin türünü değil adını döndürür.

6. Tetikleyiciyi kaydedin ve açıklayıcı bir ad girin. Örneğin, "Tüm GA4 Uygulama Etkinlikleri"ni kullanabilirsiniz.

7. Artık yeni tetikleyicinin bulunduğu etiket ayarlarına geri dönmüş olmanız gerekir. Etiketi kaydedin ve açıklayıcı bir ad girin (ör. "GA4"). Etiketiniz şu şekilde görünmelidir:

   

İpucu: Belirli etkinliklerin gönderilmesini atlamak için etkinlik adına (veya başka bir değişkene) dayalı koşullu mantık içeren özel tetikleyiciler kullanmayı veya tetikleyici istisnaları eklemeyi seçebilirsiniz. Tetikleyicileri tetikleme ve tetikleyici istisnaları hakkında daha fazla bilgi edinin.

Kapsayıcınızı önizleme

Değişiklikleri yayınlamadan önce sunucu kapsayıcınızı önizlemek ve hata ayıklamak için Google Etiket Yöneticisi'ni kullanabilirsiniz. GA4 mülkünüzde sunucu tarafı etiketlemeyi etkinleştirmediğiniz sürece önizlemenin çalışmadığını unutmayın.

Uygulama isteklerinizin önizleme yapılandırmasını tetiklemesi için:

1. Google Etiket Yöneticisi sunucu kapsayıcınızdayken Önizle'yi seçin.
2. Sağ üstteki Diğer İşlemler simgesini ⋮ tıklayın ve Uygulamadan istek gönder'i seçin.

3. Uygulama kimliğinizi girin ve QR kodu oluştur'u tıklayın.

   

4. Telefonunuzun kamera uygulamasıyla QR kodunu tarayın. Önizleme etkinlikleri oluşturmak için uygulamanızla her zamanki şekilde etkileşim kurmaya devam edin.

5. İletişim kutusunu kapatmak için Tamam'ı tıklayın.

Kapsayıcınızı yayınlama

Değişikliklerinizi doğruladıktan sonra, bu değişikliklerin tüm trafik için geçerli olması amacıyla kapsayıcıyı yayınlayın. Yayınlama, sürümler ve onaylar hakkında daha fazla bilgi edinin.

3. adım: GA4 mülkünüzde sunucu tarafı etiketlemeyi etkinleştirin

1. Google Analytics 4 mülkünüzde Yönetici'ye gidin.
2. Veri akışları'nı açın.

3. iOS veya Android sekmesinden uygulamanızın akış yapılandırmasını seçin.

   

4. SDK ayarlarını yapılandır'ı ve ardından Sunucu tarafı Etiket Yöneticisi'ni yapılandır'ı tıklayın.

   

5. SDK'nın sunucu kapsayıcı URL'sine ölçüm verileri göndermesini etkinleştirmek için:

   1. Sunucu tarafı Etiket Yöneticisi kapsayıcısına veri gönder seçeneğini etkinleştirin veya devre dışı bırakın.
   2. Sunucu kapsayıcısı URL'sini kopyalayın. Bu ayarı Google Etiket Yöneticisi'nde Yönetici > Kapsayıcı Ayarları > Sunucu kapsayıcı URL'leri'ne giderek bulabilirsiniz.

   3. Sunucu kapsayıcısına yönlendirmek istediğiniz trafiğin yüzdesini seçin. Tüm trafiğiniz için sunucu tarafı etiketlemeyi kullanmadan önce sunucu kurulumunuzu ve yapılandırmanızı doğrulamak üzere% 100'ün altında bir seçenek belirleyebilirsiniz.

      Not: Sunucunuza veri göndermek üzere yalnızca Önizleme modu kullanılarak açılan uygulamaları etkinleştirmek için Yalnızca cihazlarda hata ayıkla seçeneğini kullanın.

   

6. Kaydet'i tıklayın. SDK, güncellenmiş sunucu kapsayıcı URL'sini ve doğrudan ölçüm verilerini buraya alır.

Bilinen sınırlamalar

• Android uygulamaları için:

  • Sunucu kapsayıcıları ve Google Play Hizmetleri ile ilgili olası güvenlik açıklarını önlemek için etkinlikler, SDK ile sunucu kapsayıcınız arasında durum bilgisi olmayan bir proxy sunucusu üzerinden gönderilir. Bu proxy, isteğin kaynağını ve uç noktasını doğrular ancak etkinliklerle ilgili hiçbir veriyi incelemez veya saklamaz. GA4'ün AB'de bulunan cihazlardan veri toplama yöntemine uygun olarak, AB'de bulunan trafik için proxy AB'de olur.
  • Otomatik olarak kaydedilen uygulama içi satın alma işlemleri, Google Play arka ucu ile entegrasyona dayanır ve sunucu kapsayıcısına gönderilmez.
  • app_remove etkinliği Android'de raporlanmaz.

• SDK verilerinizin ve dönüşümlerinizin Google Ads'e aktarılmasını sağlamak için Google Analytics'teki uygulama veri akışlarınızı Google Ads hesabınıza bağlamanız gerekir. Sunucu tarafı etiketleme, SDK'nız ile Google Ads arasında doğal bir entegrasyon sunmaz.

API

Etiket Yöneticisi yapılandırma verilerine erişmek için Etiket Yöneticisi REST API'sini kullanabilirsiniz. API hakkında daha fazla bilgi için:

• API ile nasıl çalışacağınızı öğrenmek için Geliştirici Kılavuzu'na bakın.
• Etiket Yöneticisi kaynakları ve mevcut işlemler hakkında bilgi edinmek için Etiket Yöneticisi API Referansı'nı inceleyin.