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 oturum günü + 63 gün | >= istek zamanı eksi 72 saat 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 72 saat ve <= istek zamanı |
Etkinliklere User-ID atama
Online veya çevrimdışı etkinliklere User-ID sağlamak için Measurement Protocol'u kullanın.
Bir etkinliğe User-ID eklemeyle ilgili bazı örnek kullanım alanları:
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, Measurement Protocol'ü kullanarak User-ID ile online etkinlikler sağlı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:
Önemli etkinliğin ilişkilendirme penceresi 63 günden uzun olsa bile isteği en geç son online etkinlikten 63 gün sonra 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'ta gönderin.timestamp_micros
değerini geçersiz kılarsanız son 72 saat içinde bir zaman damgası olarak ayarlayın.
Kitle oluşturmak için etkinlikleri veya kullanıcı özelliklerini gönderme
Birkaç koşula uyduğunuz takdirde Measurement Protocol kullanılarak gönderilen etkinlikler ve kullanıcı özellikleri, 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 en geç 30 gün sonra 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'ta gönderin.İsteği, aynı
app_instance_id
için en son online etkinlikten en geç 42 gün sonra 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'da gönderin.timestamp_micros
değerini geçersiz kılarsanız son 72 saat içindeki bir zaman damgası olarak ayarlayın.