Measurement Protocol Referansı

Genel Bakış

Measurement Protocol'ü kullanarak Google Analytics'e veri göndermenin iki bölümü vardır:

  1. Aktarım: Verileri nereye ve nasıl göndereceğiniz
  2. Yük: Gönderdiğiniz veriler

Bu dokümanda, aktarım ve yükün nasıl biçimlendirildiği açıklanmaktadır.

Taşıma

URL uç noktası

Aşağıdaki uç noktaya HTTP POST istekleri göndererek Measurement Protocol'ü kullanarak veri gönderiyorsunuz:

https://www.google-analytics.com/mp/collect

Etkinlik göndermek için aşağıdaki POST isteğini gönderin:

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

Yanıt kodları

Measurement Protocol, HTTP isteği alındıysa her zaman bir 2xx durum kodu döndürür. Yük verileri hatalıysa veya yükteki veriler yanlışsa ya da Google Analytics tarafından işlenmemişse Measurement Protocol bir hata kodu döndürmez.

Yük

Veriler, Measurement Protocol Verileri kullanılarak Google Analytics'e iki bölümden gönderilir:

  1. Sorgu parametreleri
  2. JSON POST gövdesi

sorgu parametreleri

Parametre Adı Açıklama

api_secret

Zorunludur. Google Analytics kullanıcı arayüzü üzerinden oluşturulan bir API Secret.

Yeni bir gizli anahtar oluşturmak için Google Analytics kullanıcı arayüzünde:
Yönetici > Veri Akışları > akışınızı seçin > Measurement Protocol > Oluştur'a gidin.

Bu bilgileri kuruluşunuza özel tutmanızı öneririz. Ölçüm protokolünü istemci tarafına dağıtırsanız aşırı spam'den kaçınmak için api_secret'leri düzenli olarak döndürmeniz gerekir.

JSON gönderi gövdesi

Anahtar Tür Açıklama

user_id

 string

İsteğe bağlı. Kullanıcının benzersiz tanımlayıcısı. Bu tanımlayıcı hakkında daha fazla bilgi edinmek istiyorsanız Platformlar arası analiz için User-ID'ye bakın.

timestamp_micros

 number

İsteğe bağlı. Etkinlikle ilişkilendirilecek zaman için Unix zaman damgası (mikrosaniye cinsinden). Bu ayar yalnızca geçmişte gerçekleşen etkinlikleri kaydedecek şekilde ayarlanmalıdır. Bu değer, user_property veya etkinlik zaman damgaları aracılığıyla geçersiz kılınabilir. Etkinlikler, tesisin saat dilimine göre 3 takvim gününe kadar geriye dönük olarak tarihlendirilebilir.

user_properties

 object İsteğe bağlı. Ölçüm için kullanıcı özellikleri. Daha fazla bilgi için Kullanıcı özellikleri bölümüne bakın.

user_data

 object İsteğe bağlı. Kullanıcı tarafından sağlanan veriler. Daha fazla bilgi için kullanıcı tarafından sağlanan verilerle ilgili kılavuzu inceleyin.
object İsteğe bağlı. İsteğin izin ayarlarını belirler. Daha fazla bilgi için izin bölümüne bakın.

non_personalized_ads

 boolean İsteğe bağlı. Kullanıcının verilerinin kişiselleştirilmiş reklamlar için kullanılmaması gerektiğini belirtmek üzere true olarak ayarlayın.

events[]

 array Zorunludur. Etkinlik öğeleri dizisi. İstek başına en fazla 25 etkinlik gönderilebilir. Tüm geçerli etkinlikler için events referansına bakın.

events[].name

 string Zorunludur. Etkinliğin adı. Tüm seçenekler için etkinlikler referansına bakın.

events[].params

 object İsteğe bağlı. Etkinliğin parametreleri. Her bir etkinlikle ilgili önerilen parametreler için etkinliklere göz atın.

consent özelliği, izin türlerini ve durumlarını yapılandırır. consent değerini belirtmezseniz Google Analytics, istemci veya uygulama örneği için ilgili online etkileşimlerdeki izin ayarlarını kullanır.

Anahtar Tür Açıklama

ad_user_data

 string

İsteğe bağlıdır. İsteğin etkinliklerindeki ve kullanıcı özelliklerindeki kullanıcı verilerinin reklam amacıyla Google'a gönderilmesine yönelik izinleri belirler.

GRANTED veya DENIED olmalıdır.

ad_personalization

 string

İsteğe bağlıdır. Kullanıcı için kişiselleştirilmiş reklamcılığa yönelik izni belirler.

GRANTED veya DENIED olmalıdır.

Özel parametreler

Belirlenen parametrelere ek olarak, Measurement Protocol yüküne özel kullanıcı kapsamlı, etkinlik kapsamlı ve öğe kapsamlı parametreler ekleyebilirsiniz.

  • Kullanıcı kapsamlı özel parametreler, yükün user_properties nesnesine dahil edilebilir.
  • Etkinlik kapsamlı özel parametreler, yükün events[].params nesnesi içine dahil edilebilir.
  • Öğe kapsamlı özel parametreler her etkinlik için items dizisine dahil edilebilir.

Bazı etkinliklerde önerilen parametreler bulunur. Desteklenen tüm etkinliklerle ilgili önerilen parametreler için etkinliklere bakın.

Ayrılmış adlar

Ayrılmış etkinlik adları

Aşağıdaki etkinlik adları ayrılmıştır ve kullanılamaz:

  • ad_activeview
  • ad_click
  • ad_exposure
  • ad_query
  • ad_reward
  • adunit_exposure
  • app_clear_data
  • app_exception
  • app_install
  • app_remove
  • app_store_refund
  • app_update
  • app_upgrade
  • dynamic_link_app_open
  • dynamic_link_app_update
  • dynamic_link_first_open
  • error
  • firebase_campaign
  • firebase_in_app_message_action
  • firebase_in_app_message_dismiss
  • firebase_in_app_message_impression
  • first_open
  • first_visit
  • in_app_purchase
  • notification_dismiss
  • notification_foreground
  • notification_open
  • notification_receive
  • notification_send
  • os_update
  • session_start
  • user_engagement

Ayrılmış parametre adları

Aşağıdaki parametre adları ayrılmıştır ve kullanılamaz:

  • firebase_conversion

Ayrıca, parametre adları şununla başlayamaz:

  • _ (underscore)
  • firebase_
  • ga_
  • google_
  • gtag.

Ayrılmış kullanıcı özelliği adları

Aşağıdaki kullanıcı özelliği adları ayrılmıştır ve kullanılamaz:

  • first_open_time
  • first_visit_time
  • last_deep_link_referrer
  • user_id
  • first_open_after_install

Ayrıca, kullanıcı özelliği adları şununla başlayamaz:

  • _ (underscore)
  • firebase_
  • ga_
  • google_