Genel bakış
Verileri Google Analytics'e Ölçüm Protokolü'nü kullanarak göndermek iki bölümden oluşur:
- Taşımacılık: Verileri nereye ve nasıl gönderdiğiniz
- 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:
- Sorgu parametreleri
JSON
POST
gövdesi
sorgu parametreleri
Parametre Adı | Açıklama |
---|---|
|
Zorunludur. Google Analytics kullanıcı arayüzü aracılığıyla oluşturulan bir
Yeni bir gizli anahtar oluşturmak için Google Analytics kullanıcı arayüzünde şu işlemleri yapın:
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 |
|
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 |
|
Ö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 |
---|---|---|
|
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. |
|
string |
Zorunludur. Benzersiz bir web istemcisi kullanıcı örneğini tanımlar. Etkinlikleri Measurement Protocol'a gönderme bölümünü inceleyin. |
|
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. |
|
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, |
|
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. |
|
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.
|
|
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. |
|
string |
Zorunludur. Etkinliğin adı. Tüm seçenekler için events referansına bakın. |
|
object |
İsteğe bağlı. Etkinliğin parametreleri. Her bir etkinlik için önerilen parametreler için etkinliklere bakın. |
İzin
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 |
---|---|---|
|
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.
|
|
string |
İsteğe bağlı. Kullanıcı için kişiselleştirilmiş reklamcılığa yönelik izinleri belirler.
|
Ö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.
Belirli etkinlikler için önerilen değerler
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_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_