[GA4] SKAdNetwork geri göndermelerini Google Analytics'e gönderme

Aşağıdaki makalede, Measurement Protocol kullanarak SKAdNetwork geri göndermelerini Google Analytics'e gönderme adımları açıklanmaktadır.

1. adım: SKAdNetwork geri göndermelerini ilgili iOS sürümleri için kaydedin

Daha fazla bilgi için Apple'ın belgelerini inceleyin. Firebase için Google Analytics SDK'sını kullanan müşteriler için SDK bunu uygulama adına otomatik olarak kaydeder. Siz de bu adımı atlayabilirsiniz.

2. adım: SKAdNetwork geri göndermelerini aldığınızdan ve kodunu çözdüğünüzden emin olun

Daha fazla bilgi için Apple'ın belgelerini inceleyin. SKAdNetwork uç noktası oluşturmadıysanız Apple'ın belgelerindeki talimatları uygulayarak bunu yapmanız gerekir.

Not: Google Analytics 4 şu anda uç nokta olarak yapılandırılamaz.

Google onaylı bir Uygulama İlişkilendirme Ortağı (AAP) veya şirket içi çözümle önceden bir uç nokta oluşturduysanız Measurement Protocol kullanarak sonuçları Google Analytics'e yönlendirme işlemi için size yol gösteren 3. adıma atlayabilirsiniz.

3. adım: Geri gönderme sonuçlarını, Measurement Protocol kullanarak Google Analytics'e yönlendirin

Bunu yapmak için aşağıdaki şemayı (codelab örneği) kullanarak Measurement Protocol üzerinden Google Analytics'e özel bir campaign_details etkinliği gönderebilirsiniz.

Google Analytics 4 SKAdNetwork Measurement Protocol uygulaması

İsteğe bağlı olarak belirtilmediği sürece tüm parametreler zorunludur.

İstek düzeyindeki parametreler

Parametre	Daha fazla bilgi
firebase_app_id: {GMP uygulama kimliği}	Google Analytics 4'te Yönetici > Veri Akışları > akışınızı seçin > Firebase Uygulama Kimliği'ne gidin. Yükün dışında bir değere ayarlayın.
api_secret: {API gizli anahtarı}	Yeni bir gizli anahtar oluşturmak için Google Analytics 4'te Yönetici > Veri Akışları > akışınızı seçin > Measurement Protocol > Oluştur'a gidin. Yükün dışında bir değere ayarlayın.
timestamp_micros: {alınan SKAN geri göndermesinin zaman damgası}	İsteğe bağlıdır ancak sağlanmışsa son 72 saat içinde olmalıdır. Sağlanmamışsa toplama zaman damgası kullanılır. Google Analytics 4'teki edinme etkinlikleri için önemli etkinlikler aralığı 30 gündür. Raporlamanın daha doğru olması için geri göndermelerinizi mümkün olan en kısa sürede göndermeniz önemlidir.
app_instance_id: {...}	Zorunludur. Rastgele rakamlardan oluşan benzersiz bir dize oluşturun. Bu veriler dönüşüm modellemede kullanıldıktan sonra söz konusu kimlik dizesi silinerek onun yerine gerçek uygulama örneği kimlikleri kullanılır.

GA Etkinliği

Etkinlik	Daha fazla bilgi
campaign_details	Özel etkinlik.

GA parametreleri (mevcut)

Parametre	Daha fazla bilgi
source: {kaynak}	Bunlar, manuel etiketlemede kullanılan parametrelerdir. Google Analytics 4 raporlaması, Google Analytics 4 varsayılan kanal gruplamaları kullanılarak yapılandırılır. Her bir parametreyi kategorilere ayırmak için bunları kılavuz olarak kullanmanızı öneririz. Google dışı tüm geri göndermeler için bu parametreleri gönderin. Örneğin: Facebook geri göndermesi: kaynak: facebook aracı: tbm|bgbm içerik: ad_version_name kampanya: Facebook İlkbahar 2022 Kampanyası kampanya kimliği: SKAN geri göndermesinde olduğu gibi Google geri göndermelerinde, mülkünüzün Google Ads ile entegrasyonuna göre kampanyaların kodunu çözeriz. Bu nedenle, yukarıdaki parametreler Google geri göndermeleri için isteğe bağlıdır. Google Analytics 4 mülkünüzün Google Ads reklam hesaplarınıza bağlı olduğundan emin olmanız gerekir. Not: Yalnızca Google dışı olanları değil, tüm SKAdNetwork geri göndermelerinizi Google Analytics 4'e göndermeniz önemlidir.
medium: {aracı}
term: {terim} isteğe bağlı
content: {içerik} isteğe bağlı
campaign_id: {kampanya kimliği}	SKAdNetwork geri göndermesindeki değer.
campaign: {kampanya} isteğe bağlıdır ancak girilmezse (not set) olarak gösterilir	Google Ads kampanyalarında, kimliğin kodunu çözeriz ve Google Analytics ile Google Ads bağlantınıza göre kampanya adını sağlayıp kaynak ve aracı parametrelerini güncelleriz. Hesaplarınız bağlı değilse Google kampanya kimliklerinin kodunu çözmeyiz ve belirtilen kaynak ve aracı parametrelerini kullanırız. Google Ads dışı kampanyalar için kodu çözebilir ve kampanya adlarını sağlayabilirsiniz. Kampanya adını bilmiyorsanız SKAdNetwork campaign_id parametrenizi kopyalayabilirsiniz. Not: Sağlanmazsa (not set) olarak görünür.
source_platform: "apple_skan"	Önemli: Bu dizeyi büyük/küçük harf ve "_" kullanımına uyup tam olarak belirtmeniz gerekir.
app_id: {uygulama kimliği}	SKAdNetwork geri göndermesindeki değer. Bu, uygulama paketi kimliğinizdir.
transaction_id: {işlem kimliği}	SKAdNetwork geri göndermesindeki değer.

Zorunlu yeni parametreler

Not: Bu yeni parametreler, Google Analytics 4 kullanıcı arayüzünde ayarlanabilir; ancak zorunlu değildir. Bu parametrelere dayalı olarak belirli özel boyut raporlarını görmek istiyorsanız parametrelerin Google Analytics 4'te kayıtlı olması gerekir.

Parametre	Daha fazla bilgi
version: {sürüm}	SKAdNetwork geri göndermesindeki değer.
conversion_value: {dönüşüm değeri}	SKAdNetwork geri göndermesindeki değer.
fidelity_type: {uygunluk türü}	SKAdNetwork geri göndermesindeki değer.
attribution_signature: {ilişkilendirme imzası}	SKAdNetwork geri göndermesindeki değer. Not: Bu bir güvenlik özelliğidir. SKAdNetwork geri göndermeleri kriptografik olarak imzalanır.
redownload: {yeniden indir}	SKAdNetwork geri göndermesindeki değer.
source_app_id: {kaynak uygulama kimliği}	SKAdNetwork geri göndermesindeki değer. Not: Yüklemeyle sonuçlanan reklam tıklamasının gerçekleştiği uygulamanın kimliğidir.
did_win: {kazandı}	SKAdNetwork geri göndermesindeki değer. Not: Reklamverenler yalnızca kazanan geri göndermeleri alır. Reklam teknolojileri ise kazanan geri göndermelerini ve ikinci/destek geri göndermelerini alır.
ad_network_id: {reklam ağı kimliği} Burada {reklam ağı kimliği}, geri göndermedeki değeri temsil eder.	SKAdNetwork geri göndermesindeki değer. Bu parametre, reklamınızın sunulduğu reklam ağını gösterir. Bu bilgi, "source" (kaynak) trafik boyutu için de yararlı olacaktır.

 

4. adım: Marketing Platform isabetlerinin alındığını doğrulayın

campaign_details etkinlikleri doğrudan Google Analytics'te gösterilmez. Bunun yerine, SKAdNetwork geri göndermeleri etkinliklere dönüştürülür ve first_open önemli etkinlikleri ile etkinlik raporlarına entegre edilir. Kaynak platform (source platform = SKAN) boyutu eklenerek segmentlere ayrılabilir.

İsabetlerin gönderildiğini onaylamak istiyorsanız campaign_details etkinliklerini, farklı bir etkinlik adı (ör. campaign_details_skan_test) kullanarak kopyalayıp test etkinliklerini kaydetmenizi öneririz. Ardından test etkinliklerinin Google Analytics 4 Gerçek zamanlı raporunda göründüğünü doğrulayabilirsiniz. Test etkinliğini ve parametrelerini kaydederseniz bunlar gerçek zamanlı raporlara ek olarak anlık raporlarda da gösterilir.

Notlar:

• SKAdNetwork geri göndermelerinizin tümünün raporlarda gösterilmesini istiyorsanız her birini bir campaign.details etkinliği olarak göndermenin yanı sıra, kopyalanan etkinliği ve parametreleri yukarıda belirtildiği gibi kaydetmeniz gerekir. Böyle yapmayı tercih ederseniz yine de SKAdNetwork geri göndermeleri campaign.details etkinliği kullanılarak gönderilmelidir. Aksi takdirde, Google Analytics bunları tanımaz ve iOS first_open raporlamanızı iyileştirmek için dönüşüm modelleme yapamaz.
• Google Analytics'in dönüşüm modelleme ve raporlamada yararlanabilmesi için SKAdNetwork geri göndermelerinin, alındıktan sonra 4 gün içinde gönderilmesi gerekir.

Genel doğrulama adımları hakkında daha fazla bilgi edinin.