Google Analytics Measurement Protocol, etiketleme veya Firebase SDK ile topladığınız verilere ek olarak çevrimdışı verileri web veya uygulama akışınıza göndermenize olanak tanır.
Bu kılavuzda, Google Analytics Measurement Protocol'un yaygın kullanım alanları ve bu alanların gereksinimleri açıklanmaktadır.
Şartların özeti
Bu tabloda, her kullanım alanının şartlarıyla ilgili hızlı bir referans sunulmaktadır. Şu en iyi uygulamaları aklınızda bulundurun:
Etkinliklerin ve kullanıcı özelliklerinin
timestamp_micros
değeri varsayılan olarak istek zamanına ayarlanır. Daha önce oluşan bir etkinlik veya kullanıcı özelliği değişikliğini gönderirken, etkinlik gönderme rehberi ve kullanıcı özellikleri rehberinde açıklandığı şekilde zaman damgasını geçersiz kılın.Anlık raporların ve etkileşim metriklerinin doğru olması için önceki etkinlikten bu yana geçen süre olarak ayarlanmış
engagement_time_msec
etkinlik parametresini ekleyin.
Kullanım alanı | Oturum kimliği | İstek zamanı şartı | timestamp_micros koşulu |
---|---|---|---|
Etkinliklere User-ID atama | Zorunlu | <= oturum sonu başlangıcı iş günü | >= oturum başlangıcı ve <= oturum sonu |
Oturum ilişkilendirmesi | Zorunlu | <= oturum başlangıcı + 24 saat | >= oturum başlangıcı ve <= oturum sonu |
Etkinlikleri reklamcılık platformlarına aktarma | Zorunlu değil | <= son oturumun iş günü + 63 gün | >= istek zamanı eksi iki iş günü ve <= istek zamanı |
Kitle oluşturmak için etkinlikleri veya kullanıcı özelliklerini gönderme | Zorunlu değil | Web: <= son online etkinlik zamanı + 30 gün Uygulama: <= son online etkinlik zamanı + 42 gün |
>= istek zamanı eksi iki iş günü ve <= istek zamanı |
Etkinliklere User-ID atama
Measurement Protocol'u kullanarak online veya çevrimdışı etkinliklere User-ID atayın.
Bir etkinliğe User-ID eklemeyle ilgili bazı örnek kullanım alanları şunlardır:
Online ölçümünüzde, online etkinlikler için User-ID'yi aramak üzere gereken bilgiler eksik ancak online oturum ile User-ID arasında ilişkilendirme yapabilen bir etkinlik işleme hattınız var.
Bu senaryoda, online etkinliklere User-ID sağlamak için Measurement Protocol'u kullanıyorsunuz.
Measurement Protocol ile gönderdiğiniz etkinliklerin User-ID'si yok ancak kullanıcı oturum sırasında internette oturum açtıysa bu etkinliklerin bir User-ID ile ilişkilendirilmesini istiyorsunuz.
Bu senaryoda, Measurement Protocol etkinliklerine kullanıcı kimliği sağlamak için online etkinlikleri kullanıyorsunuz.
Bir etkinliğe User-ID eklemek için gerekenler:
- Etkinliğin parametre listesine
session_id
değerini ekleyin. - Measurement Protocol etkinliklerini, online oturumla aynı iş günü içinde gönderin.
timestamp_micros
değerini geçersiz kılarsanız bu değeri, online oturumun başlangıç ve bitiş zamanı arasındaki bir zaman damgası olarak ayarlayın.- Amacınız online etkinlikler için User-ID sağlamaksa istekte
user_id
değerini ayarlayın. - Hedefiniz, her Measurement Protocol etkinliğinin ilgili online oturumdan User-ID'ye sahip olmasıysa
user_id
değerini ayarlamanız gerekmez.
Oturum ilişkilendirmesi
Belirli koşulları karşılayan Measurement Protocol etkinlikleri, raporlarda aynı oturumdaki online etkinliklerle aynı oturum özellikleriyle (ör. coğrafi bilgiler, kaynak, ortam ve kampanya) görünür.
Oturum ilişkilendirme için gerekenler:
- Etkinliğin parametre listesine
session_id
değerini ekleyin. İsteği, online oturumun başlamasından en geç 24 saat sonra gönderin.
Örneğin, oturum mülkünüzün saat diliminde Pazartesi günü 11:15'te başladıysa isteği Salı günü 11:15'ten önce gönderin.
timestamp_micros
değerini geçersiz kılarsanız bu değeri, online oturumun başlangıç ve bitiş zamanı arasındaki bir zaman damgası olarak ayarlayın.
Etkinlikleri reklamcılık platformlarına aktarma
Google Analytics, Measurement Protocol kullanarak gönderdiğiniz etkinlikleri Google Ads veya Campaign Manager 360 gibi bağlı reklamcılık ürünlerine yapılan dışa aktarma işlemlerine dahil eder.
Bu özelliğin yararlı olduğu bazı yaygın senaryolar şunlardır:
- İşletmenizin, reklam ilişkilendirmesine ve raporlamaya dahil etmek istediğiniz çevrimdışı etkinlikleri var.
- Etiketleme veya Firebase SDK'sında kullanılamayan bir sistemde ek etkinlikleriniz var ancak bu etkinlikleri bağlı ürünlere dahil etmek istiyorsunuz.
Etkinlikleri reklamcılık platformlarına aktarmak için gerekenler:
İsteği, önemli etkinliğin ilişkilendirme penceresi 63 günden uzun olsa bile, son online etkinlikten sonraki 63. iş gününün sonuna kadar gönderin.
Örneğin,
client_id
veyaapp_instance_id
için en son online etkinlik 1 Mart'ta gerçekleştiyse Measurement Protocol etkinliğini en geç 3 Mayıs'taki iş gününün sonuna kadar gönderin.timestamp_micros
değerini geçersiz kılarsanız son üç iş günü içindeki bir zaman damgasına ayarlayın.
Kitle oluşturmak için etkinlikleri veya kullanıcı özelliklerini gönderme
Measurement Protocol kullanılarak gönderilen etkinlikler ve kullanıcı özellikleri, birkaç koşulu karşılamanız durumunda kitle koşullarının değerlendirmesine dahil edilir.
Kitle oluşturmak için etkinlik veya kullanıcı özelliği göndermeyle ilgili şartlar şunlardır:
İsteği, aynı
client_id
için en son online etkinlikten sonraki 30 gün içinde ve iş gününün sonuna kadar bir web akışına gönderin.Örneğin,
client_id
için en son online etkinlik 1 Mart'ta gerçekleştiyse Measurement Protocol etkinliğini en geç 31 Mart'taki iş gününün sonunda gönderin.İsteği, aynı
app_instance_id
için en son online etkinlikten sonraki 42 gün içinde ve iş gününün sonundan önce bir uygulama akışına gönderin.Örneğin,
app_instance_id
için en son online etkinlik 1 Mart'ta gerçekleştiyse Measurement Protocol etkinliğini en geç 12 Nisan'daki iş gününün sonuna kadar gönderin.timestamp_micros
değerini geçersiz kılarsanız son 3 iş günü içindeki bir zaman damgasına ayarlayın.