Measurement Protocol Referansı

Genel bakış

Ölçüm Protokolü'nü kullanarak verileri Google Analytics'e 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, taşıma ve yükün nasıl biçimlendirildiği açıklanmaktadır.

Ulaşım

URL uç noktası

Verileri Measurement Protocol kullanarak, aşağıdaki uç noktaya HTTP POST istekleri göndererek 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 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

Bunları kuruluşunuz için gizli tutmanızı öneririz. Measurement Protocol istemci tarafını dağıtıyorsanız aşırı SPAM oluşmasını önlemek için api_secret öğelerini düzenli aralıklarla dönüşümlü olarak değiştirmeniz gerekir.

firebase_app_id

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

measurement_id

 Ölçüm Kimliği. Bir 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ı üzerinden alınması gerekir.

client_id

 string

Zorunludur. Bir web istemcisinin kullanıcı örneğini benzersiz şekilde tanımlar. Etkinliği Measurement Protocol'e 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 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ı belirten bir Unix zaman damgası (mikrosaniye cinsinden). Bu özellik, 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, mülkün saat dilimine bağlı olarak 3 takvim gününe kadar geri alınabilir.

user_properties

 object İsteğe bağlı. Ölçümle ilgili 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ş 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 events referansına bakın.

events[].params

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

Özel parametreler

Belirtilen parametrelere ek olarak, bir Measurement Protocol yüküne kullanıcı kapsamlı, etkinlik kapsamlı ve öğe kapsamlı özel parametreler 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 dair önerilen parametreler için etkinlikler bölümüne 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_