Measurement Protocol etkinliklerini Google Analytics'e gönderme

Bu kılavuzda, Google Analytics raporlarınızda Measurement Protocol etkinliklerini görüntüleyebilmeniz için Google Analytics Measurement Totocol web ve uygulama veri akışı etkinliklerini bir Google Analytics sunucusuna nasıl gönderebileceğiniz açıklanmıştır.

Bu kılavuzda görmek istediğiniz platformu seçin:

İsteği biçimlendirme

Google Analytics 4 için Measurement Protocol yalnızca HTTP POST isteklerini destekler.

Etkinlik göndermek için aşağıdaki biçimi kullanın:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>

İstek URL'sinde aşağıdakileri sağlamanız gerekir:

  • api_secret: Google Analytics kullanıcı arayüzünde oluşturulan API GÜVENLİĞİ.

    Yeni bir gizli anahtar oluşturmak için Yönetici > Veri Akışları > yayınınızı seçin > Measurement Protocol > Oluştur'a gidin.

  • measurement_id: Bir akışla ilişkilendirilen Google Analytics kullanıcı arayüzünde Yönetici > Veri Akışları > yayınınızı seçin > Ölçüm Kimliği'nde bulunan ölçüm kimliği.

    measurement_id, Akış Kimliğiniz değil.

Tam referans için sorgu parametrelerine bakın.

İstek gövdesinde aşağıdakileri sağlamanız gerekir:

  • client_id: İstemci için benzersiz tanımlayıcı. Bu, Firebase app_instance_id ürününden farklıdır. gtag.js('get') kodunu kullanın.

  • user_id: İsteğe bağlı. Kullanıcının benzersiz tanımlayıcısı. Yalnızca utf-8 karakterlerini içerebilir. Bu tanımlayıcı hakkında daha fazla bilgi için Platformlar arası analiz için User-ID bölümüne bakın.

  • events: Etkinlik öğeleri dizisi. Tek bir isteğe birden fazla etkinlik ekleyebilirsiniz.

    Kullanıcı etkinliğinin Gerçek zamanlı gibi raporlarda gösterilebilmesi için event için params kapsamında engagement_time_msec ve session_id sağlanmalıdır.

    Aşağıda bir örnek verilmiştir:

    {
 "client_id": "x",
 "events": [
   {
     "name": "offline_purchase",
     "params": {
       "engagement_time_msec": "100",
       "session_id": "123"
     }
   }
 ]
}

    session_start ayrılmış bir etkinlik adı olsa da yeni bir session_id oluşturmak, session_start öğesini göndermeye gerek kalmadan yeni bir oturum oluşturur. Oturumların nasıl sayıldığını anlayın.

Deneyin

Aşağıda, Google Analytics sunucunuza bir tutorial_begin etkinliği göndermek için kullanabileceğiniz bir örnek verilmiştir:

const measurement_id = `G-XXXXXXXXXX`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurement_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    client_id: 'XXXXXXXXXX.YYYYYYYYYY',
    events: [{
      name: 'tutorial_begin',
      params: {},
    }]
  })
});

Sınırlamalar

Google Analytics'e Measurement Protocol etkinlikleri göndermek için aşağıdaki sınırlamalar geçerlidir:

  • İstekler en fazla 25 etkinlik içerebilir.
  • Etkinlikler en fazla 25 parametreye sahip olabilir.
  • Etkinlikler en fazla 25 kullanıcı özelliğine sahip olabilir.
  • Kullanıcı özelliği adları en fazla 24 karakterden oluşmalıdır.
  • Kullanıcı özelliği değerleri en fazla 36 karakterden oluşmalıdır.
  • Etkinlik adları en fazla 40 karakterden oluşmalıdır. Yalnızca alfanümerik karakterler ve alt çizgiler içerebilir ve alfabetik karakterle başlaması gerekir.
  • Öğe parametrelerini içeren parametre adları en fazla 40 karakterden oluşmalıdır. Yalnızca alfanümerik karakterler ve alt çizgiler içerebilir ve alfabetik karakterle başlaması gerekir.
  • Öğe parametresi değerleri dahil olmak üzere parametre değerleri 100 karakterden uzun olamaz.
  • Öğe parametreleri en fazla 10 özel parametre içerebilir.
  • Gönderi gövdesi 130 KB'tan küçük olmalıdır.