Measurement Protocol referansı

Bu sayfada, Measurement Protocol'ün aktarım mekanizması ve veri parametreleri açıklanmaktadır.

Taşıma

Tüm veriler, HTTPS POST istekleri kullanılarak güvenli bir şekilde gönderilmelidir.

Aşağıdaki uç noktaya istek gönderin:

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

Verilerinizin AB'de işlenmesini istiyorsanız bunun yerine aşağıdaki uç noktayı kullanın:

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

Aşağıda örnek bir POST isteği verilmiştir:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
PAYLOAD_DATA

PAYLOAD_DATA değerini isteğin yük değeriyle değiştirin.

Measurement Protocol, HTTP isteği alınırsa 2xx durum kodu döndürür. Yük hatalı biçimlendirilmişse veya veriler yanlışsa ya da Google Analytics tarafından işlenmemişse Measurement Protocol bir hata kodu döndürmez.

Yük

Yük iki bölümden oluşur:

  1. Sorgu parametreleri.
  2. JSON POST gövdesi.

Sorgu parametreleri

Parametre Adı Açıklama

api_secret

 Zorunludur. Google Analytics kullanıcı arayüzündeki API gizli anahtarı.

Yönetici > Veri Akışları > Akışınızı seçin > Measurement Protocol > Oluştur bölümünde bulunur.

Kuruluşunuza özeldir. Aşırı spam'den kaçınmak için düzenli olarak güncellenmelidir.

JSON POST gövdesi

Anahtar Tür Açıklama

user_id

 string

İsteğe bağlı. Kullanıcı için benzersiz tanımlayıcı. Bu tanımlayıcı hakkında daha fazla bilgi için Platformlar arası analiz için User-ID başlıklı makaleyi inceleyin. Yalnızca utf-8 karakterleri içerebilir.

timestamp_micros

 number

İsteğe bağlı. Unix zaman damgası (milisaniye değil mikrosaniye). Etkinliğin saatini temsil eder. Yalnızca geçmişte gerçekleşen etkinlikleri kaydedecek şekilde ayarlanmalıdır. user_property veya etkinlik zaman damgalarıyla geçersiz kılınabilir. Etkinlikler, tesisin saat dilimine göre 3 takvim gününe kadar geriye dönük olarak tarihlendirilebilir.

user_properties

 object İsteğe bağlı. Ölçüm için kullanıcı özellikleri.

user_data

 object İsteğe bağlı. Kullanıcı tarafından sağlanan veriler.
object İsteğe bağlı. İsteğin izin ayarları. Daha fazla bilgi için izin bölümüne bakın.

non_personalized_ads

 boolean İsteğe bağlı. Kullanıcı verilerinin kişiselleştirilmiş reklamlar için kullanılmaması gerektiğini belirtmek üzere true olarak ayarlanır.

user_location

 object İsteğe bağlı. İsteğin coğrafi bilgilerini yapılandırılmış bir biçimde belirler.

ip_override

 string İsteğe bağlı. Google Analytics'in istek için coğrafi bilgileri elde etmek amacıyla kullandığı IP adresi.

device

 object İsteğe bağlı. İsteğin cihaz bilgilerini yapılandırılmış bir biçimde belirler.

events[]

 array Zorunludur. event öğe 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 başlıklı makaleyi inceleyin.

events[].params

 object İsteğe bağlı. Etkinliğin parametreleri. Her etkinlik için önerilen parametreler Etkinlikler bölümünde verilmiştir.

consent özelliği, izin 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 etkinliklerindeki ve kullanıcı özelliklerindeki kullanıcı verilerinin reklam amacıyla Google'a gönderilmesine yönelik izin.

GRANTED veya DENIED.

ad_personalization

 string

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

GRANTED veya DENIED.

Coğrafi bilgiler

user_location ve ip_override özellikleri coğrafi bilgiler sağlar. user_location, ip_override'a göre daha önceliklidir.

user_location alanının yapısı aşağıda verilmiştir. Mümkün olduğunca çok sayıda özellik sağlayın. En az country_id ve region_id önerilir.

Anahtar Tür Açıklama

city

 string İsteğe bağlı. Şehrin adı. Şehir ABD'deyse Google Analytics'in şehir adını bir şehir kimliği ile doğru şekilde eşleyebilmesi için country_id ve region_id parametrelerini de ayarlayın.

region_id

 string İsteğe bağlı. ISO 3166 ülke ve alt bölümü. Örneğin, US-CA, US-AR, CA-BC, GB-LND, CN-HK.

country_id

 string İsteğe bağlı. ISO 3166-1 alpha-2 biçimindeki ülke. Örneğin, US, AU, ES, FR.

subcontinent_id

 string İsteğe bağlı. UN M49 biçimindeki alt kıta. Örneğin, 011, 021, 030, 039.

continent_id

 string İsteğe bağlı. UN M49 biçimindeki kıta. Örneğin, 002, 019, 142, 150.

Aşağıda örnek bir user_location verilmiştir:

"user_location:" {
  "city:" "Mountain View",
  "region_id:" "US-CA",
  "country_id:" "US",
  "subcontinent_id:" "021",
  "continent_id:" "019"
}

ip_override, user_location'a alternatiftir. Bunun yerine ip_override gönderirseniz Google Analytics, coğrafi bilgileri IP adresinden alır. user_location gönderirseniz Google Analytics, ip_override değerini yoksayar.

user_location veya ip_override göndermezseniz Google Analytics, client_id.

Google Analytics, gönderilen coğrafi bilgilerden bağımsız olarak mülkün ayrıntılı konum verisi ayarlarını isteğe uygular.

Cihaz bilgileri

Cihaz bilgilerini göndermek için device alanını kullanın. device alanının yapısı aşağıda verilmiştir. Mümkün olduğunca çok sayıda özellik sağlayın. En az category önerilir.

Anahtar Tür Açıklama

category

 string İsteğe bağlıdır. Cihazın kategorisi. Örneğin, desktop, tablet, mobile, smart TV.

language

 string İsteğe bağlıdır. ISO 639-1 biçimindeki dil. Örneğin, en, en-US.

screen_resolution

 string İsteğe bağlıdır. Cihazın çözünürlüğü. WIDTHxHEIGHT biçimindedir. Örneğin, 1280x2856, 1080x2340.

operating_system

 string İsteğe bağlıdır. İşletim sistemi veya platform. Örneğin, MacOS.

operating_system_version

 string İsteğe bağlıdır. İşletim sisteminin veya platformun sürümü. Örneğin, 13.5.

model

 string İsteğe bağlıdır. Cihazın modeli. Örneğin, Pixel 9 Pro, Samsung Galaxy S24.

brand

 string İsteğe bağlıdır. Cihazın markası. Örneğin, Google, Samsung.

browser

 string İsteğe bağlıdır. Tarayıcının markası veya türü. Örneğin, Chrome, Firefox.

browser_version

 string İsteğe bağlıdır. Tarayıcının sürümü. Örneğin, 136.0.7103.60, 5.0.

Aşağıdaki snippet'te device ayarlarının bir örneği gösterilmektedir:

"device:" {
  "category": "mobile",
  "language": "en",
  "screen_resolution": "1280x2856",
  "operating_system": "Android",
  "operating_system_version": "14",
  "model": "Pixel 9 Pro",
  "brand": "Google",
  "browser": "Chrome",
  "browser_version": "136.0.7103.60"
}

Google Analytics, mülkün ayrıntılı cihaz verisi ayarlarını isteğe uygular.

Özel parametreler

Measurement Protocol yüküne özel kullanıcı kapsamlı, etkinlik kapsamlı ve öğe kapsamlı parametreler dahil edebilirsiniz.

  • user_properties parametresine kullanıcı kapsamlı özel parametreler dahil edilebilir.
  • events[].params, etkinlik kapsamlı özel parametreler içerebilir.
  • Öğe kapsamlı özel parametreler items içine dahil edilebilir.

Bazı etkinliklerde önerilen parametreler bulunur. Desteklenen tüm etkinlikler için önerilen parametreler etkinlikler bölümünde verilmiştir.

Ayrılmış adlar

Bazı etkinlik, parametre ve kullanıcı özelliği adları ayrılmıştır ve kullanılamaz:

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

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_