Measurement Protocol kullanım alanları

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:

  1. 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.

  2. 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ı:

  1. 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.

  2. 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 veya app_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.