Measurement Protocol Referansı

Genel bakış

Verileri Google Analytics'e Ölçüm Protokolü'nü kullanarak göndermek iki bölümden oluşur:

  1. Taşımacılık: Verileri nereye ve nasıl gönderdiğ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.

Ulaşım

URL uç noktası

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

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

Etkinlik göndermek için şu 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 isteği alınırsa Measurement Protocol, her zaman bir 2xx durum kodu döndürür. Yük verileri bozuksa veya yükteki veriler yanlışsa ya da 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ü aracılığıyla 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ı > akışınızı seçin > Measurement Protocol > Oluştur

Bu adresleri kuruluşunuz için gizli tutmanızı öneririz. Measurement Protocol istemci tarafını dağıtıyorsanız aşırı SPAM'den kaçınmak için api_secret öğelerini düzenli aralıklarla döndürmeniz gerekir.

firebase_app_id

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

measurement_id

Ölçüm Kimliği. Veri Akışının tanımlayıcısı. Google Analytics kullanıcı arayüzünde,
Yönetici > Veri Akışları > akışınızı seçin > Ölçüm Kimliği altında bulunur

JSON yayın gövdesi

Anahtar Tür Açıklama

app_instance_id

string

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

client_id

string

Zorunludur. Benzersiz bir web istemcisi kullanıcı örneğini tanımlar. Etkinlikleri Measurement Protocol'a gönderme bölümünü inceleyin.

user_id

string

İsteğe bağlı. Bir kullanıcıya ilişkin benzersiz tanımlayıcı. Bu tanımlayıcı hakkında daha fazla bilgi için Platformlar arası analiz için User-ID bölümüne bakın.

timestamp_micros

number

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

user_properties

object İsteğe bağlı. Ölçümle ilgili kullanıcı özellikleri. Daha fazla bilgi için Kullanıcı özellikleri bölümüne bakın.
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 için 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 etkinlikler 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 etkinlik için önerilen parametreler için etkinliklere bakın.

consent özelliği, consent 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ı. İsteğin etkinliklerinden ve kullanıcı özelliklerinden kullanıcı verilerinin reklam amacıyla Google'a gönderilmesiyle ilgili izinleri belirler.

GRANTED veya DENIED olmalıdır.

ad_personalization

string

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

GRANTED veya DENIED olmalıdır.

Özel parametreler

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

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

Bazı etkinliklerde önerilen parametreler var. Desteklenen tüm etkinliklere yönelik önerilen parametreler için events konusuna 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_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_