Measurement Protocol Referansı

Genel Bakış

Ölçüm aracını kullanarak Google Analytics'e veri göndermenin iki bölümü vardır Protokol:

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

Bu belgede, taşıma ve yükün nasıl biçimlendirildiği açıklanmaktadır.

Taşıma

URL uç noktası

Verileri, takip eden uç nokta:

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>

  • İsteğin BODY. Yük bölümünü inceleyin.

Yanıt kodları

HTTP değeri şu durumlarda Measurement Protocol her zaman bir 2xx durum kodu döndürür: alındı. Measurement Protocol aşağıdaki durumlarda hata kodu döndürmez: yük verilerinin hatalı biçimlendirilmiş olması veya yükteki verilerin yanlış ya da , Google Analytics tarafından işlenmedi.

Yük

Veriler, Measurement Protocol Verileri kullanılarak Google Analytics'e iki parçalar:

  1. Sorgu parametreleri
  2. JSON POST gövdesi

sorgu parametreleri

Parametre Adı Açıklama

api_secret

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

Yeni bir gizli anahtar oluşturmak için Google Analytics kullanıcı arayüzünde şu işlemleri yapın:
. Yönetici > Veri Akışları > yayınınızı seçin &gt; Measurement Protocol > Oluştur

Bu adresleri kuruluşunuza özel tutmanızı öneririz. Eğer Measurement Protocol'ü istemci tarafında dağıtıyorsanız Aşırı SPAM'den kaçınmak için api_secret öğelerini düzenli olarak rotasyona sokmak.

JSON yayın gövdesi

Anahtar Tür Açıklama

user_id

 string

İsteğe bağlı. Kullanıcının benzersiz tanımlayıcısıdır. Şunlar için User-ID'ye bakın: platformlar arası analiz bölümüne bakın.

timestamp_micros

 number

İsteğe bağlı. İlişkilendirileceği zaman için bir Unix zaman damgası (mikrosaniye cinsinden) bu etkinliği tamamladınız. Bu ayar yalnızca gerçekleşen etkinlikleri kaydetmek için ayarlanmalıdır tercih edebilir. Bu değer, user_property veya etkinlik zaman damgaları. Etkinlikler geriye dönük olabilir Tesisin saat dilimine göre en fazla 3 takvim günü.

user_properties

 object İsteğe bağlı. Ölçümle ilgili kullanıcı özellikleri. Kullanıcı özellikleri hakkında daha fazla bilgi edinin.
object İsteğe bağlı. İsteğin izin ayarlarını belirler. Daha fazla bilgi için izin bölümünü inceleyin.

non_personalized_ads

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

events[]

 array Zorunludur. Etkinlik öğeleri dizisi. Her biri için en fazla 25 etkinlik gönderilebilir isteğinde bulunabilirsiniz. Etkinlikleri görüntüleyin .

events[].name

 string Zorunludur. Etkinliğin adı. Etkinlikleri görüntüleyin referans olarak kullanabilirsiniz.

events[].params

 object İsteğe bağlı. Etkinliğin parametreleri. Etkinlikleri göster kullanabilirsiniz.

consent özelliği, consent türlerini ve durumlarını yapılandırır. consent özelliğini belirtmezseniz Google Analytics, izni kullanır kullanıcı veya uygulama örneği için karşılık gelen online etkileşimlerden ayarlar.

Anahtar Tür Açıklama

ad_user_data

 string

İsteğe bağlıdır. İsteğin alanından kullanıcı verilerinin gönderilmesine yönelik izni belirler. etkinliklerini ve kullanıcı özelliklerini Google'a iletebilir.

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

Öngörülen parametrelere ek olarak, özel kullanıcı kapsamlı, etkinlik kapsamlı ve öğe kapsamlı parametreleri Measurement Protocol yüküne dahil edilir.

  • Kullanıcı kapsamlı özel parametreler, yükün user_properties nesnesine eklenebilir.
  • Etkinlik kapsamlı özel parametreler, events[].params içine eklenebilir yük nesnesidir.
  • Öğe kapsamlı özel parametreler items dizisi tıklayın.

Bazı etkinliklerde önerilen parametreler vardır. Önerilenler için etkinliklere göz atın parametrelerini kullanabilirsiniz.

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_