Measurement Protocol Referansı

Genel bakış

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

  1. Taşıma - Verileri nereye ve nasıl gönderdiğiniz
  2. Yük - gönderdiğiniz veriler

Bu belge, aktarım ve yükün nasıl biçimlendirildiğini açıklar.

Ulaşım

URL uç noktası

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

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

Bir 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üne bakın.

Yanıt kodları

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

Yük

Veriler, Measurement Protocol verileri kullanılarak Google Analytics'e iki bölümde 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 şu işlemleri yapın:
Yönetici > Veri Akışları > yayınınızı seçin > Measurement Protocol > Oluştur

Bu verileri kuruluşunuza özel tutmanızı öneririz. Measurement Protocol'u istemci tarafında dağıtırsanız aşırı SPAM olmaması için api_secret öğelerini düzenli olarak döndürmeniz gerekir.

firebase_app_id

 Zorunludur. Firebase Uygulama Kimliği. Firebase uygulaması için tanımlayıcı. Firebase konsolunda şurada bulunur:
Proje Ayarları > Genel > Uygulamalarınız > Uygulama Kimliği

measurement_id

 Ölçüm Kimliği. Veri Akışı tanımlayıcısıdır. Google Analytics kullanıcı arayüzünde şunları bulabilirsiniz:
Yönetici > Veri Akışları > yayınınızı seçin > Ölçüm Kimliği

JSON yayın gövdesi

Anahtar Tür Açıklama

app_instance_id

 string

Zorunludur. Belirli bir Firebase uygulaması yüklemesini benzersiz olarak tanımlar. Bu değerin Firebase SDK'sı aracılığıyla alınması gerekir.

client_id

 string

Zorunludur. Bir web istemcisinin bir kullanıcı örneğini benzersiz olarak tanımlar. Etkinliği Measurement Protocol'a gönderme bölümünü inceleyin.

user_id

 string

İsteğe bağlı. Bir kullanıcıya ait benzersiz tanımlayıcı. Bu tanımlayıcı hakkında daha fazla bilgi edinmek amacıyla Platformlar arası analiz için User-ID konulu makaleyi inceleyin.

timestamp_micros

 number

İsteğe bağlı. Etkinlikle ilişkilendirilecek zamanın 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. Tesisin saat dilimine göre etkinlikler en fazla 3 takvim günüyle güncellenebilir.

user_properties

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

non_personalized_ads

 boolean İsteğe bağlı. Bu etkinliklerin kişiselleştirilmiş reklamlarda kullanılmaması gerektiğini belirtmek için true olarak ayarlayın.

events[]

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

events[].name

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

events[].params

 object İsteğe bağlı. Etkinliğin parametreleri. Her bir etkinliğin önerilen parametreleri için etkinliklere bakın.

Bazı etkinliklerde önerilen parametreler var. Desteklenen tüm etkinlikler için önerilen parametrelere göz atın: etkinlikler.

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_impression
  • 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
  • screen_view
  • 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_