Measurement Protocol Referansı

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Genel bakış

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

  1. Aktarım: 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ı

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

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

Yanıt kodları

HTTP isteği alındıysa Measurement Protocol her zaman 2xx durum kodu döndürür. Measurement Protocol, yük verileri bozuksa, yükteki veriler yanlışsa veya Google Analytics tarafından işlenmemişse 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 şunları yapın:
Yönetici > Veri Akışları > akışınızı seçin > Measurement Protocol > Oluştur

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

firebase_app_id

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

measurement_id

Ölçüm Kimliği. Veri Akışı tanımlayıcısı. Google Analytics kullanıcı arayüzünde şu URL'de bulunur:
Yönetici > Veri Akışları > yayınınızı seçin > Ölçüm Kimliği

JSON post gövdesi

Anahtar Tür Açıklama

app_instance_id

string

Zorunludur. Belirli bir Firebase uygulamasının yüklenmesini benzersiz şekilde tanımlar. Bu değerin Firebase SDK'sı üzerinden 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 başlıklı makaleyi inceleyin.

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 için platformlar arası analiz için User-ID konusuna bakın.

timestamp_micros

number

İsteğe bağlı. Etkinlikle ilişkilendirilmesi gereken zaman için Unix zaman damgası (mikrosaniye cinsinden). Bu, 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 3 takvim gününe kadar geri alınabilir.

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ünü inceleyin.

non_personalized_ads

boolean İsteğe bağlı. Bu etkinliklerin 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 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 etkinlik için önerilen parametrelere ilişkin etkinlikleri inceleyin.

Bazı etkinlikler için önerilen parametreler vardır. Desteklenen tüm etkinlikler için önerilen parametrelere göre etkinlikleri inceleyin.

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
  • adunit_exposure
  • app_clear_data
  • app_install
  • app_update
  • app_remove
  • error
  • first_open
  • first_visit
  • in_app_purchase
  • notification_dismiss
  • notification_foreground
  • notification_open
  • notification_receive
  • 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:

  • google_
  • ga_
  • firebase_

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:

  • google_
  • ga_
  • firebase_