Measurement Protocol veri toplama isteğini (/mp/collect) Data Manager API'deki IngestEventsRequest eşdeğeriyle eşlemek için tablolardaki eşlemeleri kullanın.
Kimlik doğrulama
Data Manager API, api_secret yerine OAuth kimlik bilgileri gerektirir. Data Manager API kapsamını içeren yeni kimlik bilgileri oluşturmak için API erişimini ayarlama bölümündeki adımları uygulayın.
İstek alanları
/mp/collect isteği (Measurement Protocol) |
IngestEventsRequest (Data Manager API) |
Notlar |
|---|---|---|
measurement_id (Sorgu parametresi) |
destinations |
Web etkinlikleri için product_destination_id ile eşleştirin. Ayrıntılar için Hedef alanlar bölümüne bakın. |
firebase_app_id (Sorgu parametresi) |
destinations |
Uygulama etkinlikleri için product_destination_id ile eşleştirin. Ayrıntılar için Hedef alanlar bölümüne bakın. |
api_secret (Sorgu parametresi) |
Eşdeğeri yok | Data Manager API'de isteklerin kimliğini nasıl doğrulayacağınızı öğrenmek için API erişimini ayarlama başlıklı makaleyi inceleyin. |
consent |
consent |
Consent nesnesine ayarlanır. |
events |
events |
Event kaynaklarının listesine ayarlanır. Ayrıntılar için Etkinlik alanları bölümüne bakın. |
client_id |
events.client_id |
Web etkinlikleri için gereklidir. |
app_instance_id |
events.app_instance_id |
Uygulama etkinlikleri için zorunludur. |
user_id |
events.user_id |
İsteğe bağlıdır. Kullanıcı için benzersiz tanımlayıcı. |
timestamp_micros |
events.event_timestamp |
Measurement Protocol'de bu, istek düzeyinde veya tek bir etkinlik için sağlanabilir. Data Manager API'de istek düzeyinde zaman damgası yoktur. Her etkinlikte event_timestamp değerini etkinliğin gerçekleştiği zamana ayarlayın.
Ayrıntılar için Zaman damgası biçimi bölümüne bakın. |
user_properties |
events.user_properties |
Veri Yöneticisi API'si, ayrı kullanıcı özellikleri için zaman damgası ayarlamayı desteklemez. Kullanıcı özelliklerinde yapılan değişikliklerle ilişkili zaman damgaları, etkinliğin zaman damgasından ( |
user_data |
events.user_data |
UserData nesnesine ayarlanır. Ayrıntılar için Kullanıcı kimliği alanları bölümüne bakın. |
non_personalized_ads |
events.consent.ad_personalization |
non_personalized_ads, true ise ad_personalization değerini CONSENT_DENIED olarak ayarlayın. |
user_location |
events.event_location |
Ayrıntılar için Kullanıcı konumu alanları bölümüne bakın. |
ip_override |
events.event_device_info.ip_address |
|
device |
events.event_device_info |
Ayrıntılar için Cihaz alanları bölümüne bakın. |
user_agent |
events.event_device_info.user_agent |
|
validation_behavior |
Eşdeğeri yok | Yüklemenizin durumunu ve sonraki işlemler sırasında tek tek etkinliklerle ilgili hata ve uyarıları almak için Teşhis Aracı'nı kullanın. IngestEventsRequest başarısız olursa (ör. zorunlu alanların eksik olması nedeniyle) hiçbir etkinlik işlenmez. Hatayı çözmeniz ve isteği yeniden denemeniz gerekir. Daha fazla bilgi için API hatalarını anlama başlıklı makaleyi inceleyin. |
/debug/mp/collect |
validate_only |
Measurement Protocol doğrulama sunucusuna benzer şekilde, herhangi bir veri almadan etkinlikleri doğrulamak için validate_only değerini true olarak ayarlayın. |
| Eşdeğeri yok | encoding |
UserData yüklemeleri için gereklidir. UserIdentifier değerleri için kullanılan Encoding olarak ayarlanır. |
Hedef alanları
Measurement Protocol, measurement_id veya firebase_app_id sorgu parametresini kullanarak etkinlikleri doğrudan belirli bir veri akışına gönderir.
Data Manager API, verilerin nereye gönderileceğini belirtmek için bir Destination nesnesi kullanır.
Hedefler hakkında daha fazla bilgi için Hedefleri yapılandırma başlıklı makaleyi inceleyin.
Measurement Protocol alanlarını Destination içindeki eşdeğer alanlarla şu şekilde eşleyebilirsiniz:
| Measurement Protocol | Destination (Data Manager API) |
Notlar |
|---|---|---|
measurement_id (Sorgu parametresi) |
product_destination_id |
Google Analytics web veri akışının ölçüm kimliğine ayarlanır. |
firebase_app_id (Sorgu parametresi) |
product_destination_id |
Google Analytics uygulama veri akışının Firebase Uygulama Kimliği'ne ayarlanır. |
| Eşdeğeri yok | operating_account |
account_id değerini Google Analytics mülk kimliği olarak ayarlayın. account_type değerini GOOGLE_ANALYTICS_PROPERTY olarak ayarlayın. |
| Eşdeğeri yok | login_account |
account_id değerini Google Analytics mülk kimliği olarak ayarlayın. account_type değerini GOOGLE_ANALYTICS_PROPERTY olarak ayarlayın. |
Etkinlik alanları
Measurement Protocol events[] |
Event (Data Manager API) |
Notlar |
|---|---|---|
name |
event_name |
event_name, ayrılmış bir ad kullanıyorsa API, etkinliği INVALID_EVENT_NAME hatasıyla reddeder. |
| Eşdeğeri yok | event_source |
Etkinlik bir web tarayıcısından oluşturulduysa WEB, bir uygulamadan oluşturulduysa APP olarak ayarlanır. |
| Eşdeğeri yok | destination_references |
İstek düzeyindeki destinations listesi birden fazla Google Analytics Destination içeriyorsa gereklidir. Etkinliği hangi hedefin alacağını belirtmek için bir giriş ekleyin. |
timestamp_micros |
event_timestamp |
Ayrıntılar için Zaman damgası biçimi bölümüne bakın. |
params.currency |
currency |
|
params.value |
conversion_value |
|
params.customer_type |
user_properties.customer_type |
Measurement Protocol'de customer_type parametresi bir etkinlik parametresi olarak ayarlanır. Data Manager API'de, etkinlikteki UserProperties nesnesinin customer_type alanında ayarlayın. |
params.transaction_id |
transaction_id |
Bazı etkinlikler ve kullanım alanları için zorunludur. Daha fazla bilgi için Verileri Event nesnelerine dönüştürme başlıklı makaleyi inceleyin. |
params.items |
cart_data.items |
Ayrıntılar için Alışveriş sepeti verileri için öğe alanları başlıklı makaleyi inceleyin. |
params.coupon |
cart_data.coupon_codes |
Alışveriş sepetine uygulanan kuponları belirtmek için coupon_codes alanını kullanın. Google Analytics için yalnızca bir kupon sağlayın. Bu, her bir öğe için cart_data.items.additional_item_parameters kullanılarak ayarlanabilen Item düzeyindeki kuponlardan bağımsızdır. |
params.session_id |
additional_event_parameters |
parameter_name, session_id olarak ayarlanmış bir girişe eşleyin. |
params.engagement_time_msec |
additional_event_parameters |
parameter_name, engagement_time_msec olarak ayarlanmış bir girişe eşleyin. |
Diğer params |
additional_event_parameters |
Diğer parametreleri |
Kullanıcı kimliği alanları
Measurement Protocol user_data |
UserIdentifier (Data Manager API) |
Notlar |
|---|---|---|
sha256_email_address[] |
email_address |
Biçimlendirilmiş ve karma oluşturma işlemi uygulanmış e-posta adresine ayarlayın. Karma oluşturma işlemi uygulanmış e-posta adresini şifreleyebilirsiniz. |
sha256_phone_number[] |
phone_number |
Biçimlendirilmiş ve karma oluşturma işlemi uygulanmış telefon numarasına ayarlanır. Karma oluşturma işlemi uygulanmış telefon numarasını şifreleyebilirsiniz. |
address[] |
address |
AddressInfo nesnesine ayarlanır. Biçimlendirme ve karma oluşturma yönergelerini uygulayın. |
address[].sha256_first_name |
address.given_name |
Biçimlendirilmiş ve karma oluşturma işlemi uygulanmış ad olarak ayarlayın. Karma oluşturma işlemi uygulanmış adı şifreleyebilirsiniz. |
address[].sha256_last_name |
address.family_name |
Biçimlendirilmiş ve karma oluşturma işlemi uygulanmış soyadı olarak ayarlayın. Karma oluşturma işlemi uygulanmış soyadını şifreleyebilirsiniz. |
address[].country |
address.region_code |
|
address[].postal_code |
address.postal_code |
|
address[].city |
address.city |
Normalleştirilmiş şehir olarak ayarlanır. Bu alanı karma oluşturma işlemine tabi tutmayın. |
address[].region |
address.administrative_area |
Normalleştirilmiş bağlı olduğu yere (eyalet veya il) ayarlanır. Bu alanı karma oluşturma işlemine tabi tutmayın. |
address[].sha256_street |
address.address_line |
Biçimlendirilmiş ve karma oluşturma işlemi uygulanmış açık adrese ayarlanır. Karma oluşturma işlemi uygulanmış açık adresi şifreleyebilirsiniz. |
Alışveriş sepeti verileri için öğe alanları
Measurement Protocol items[] |
Item (Data Manager API) |
Notlar |
|---|---|---|
item_id |
item_id |
Zorunlu. |
item_name |
additional_item_parameters |
parameter_name, item_name olarak ayarlanmış bir girişe eşleyin. |
quantity |
quantity |
Zorunlu. |
price |
unit_price |
Zorunlu. |
| Diğer öğe alanları | additional_item_parameters |
Diğer öğe parametrelerini (ör. |
Kullanıcı konumu alanları
Measurement Protocol user_location |
EventLocation (Data Manager API) |
Notlar |
|---|---|---|
city |
city |
Etkinliğin gerçekleştiği şehrin adı. |
country_id |
region_code |
2 harfli CLDR bölge koduna ayarlayın. |
region_id |
subdivision_code |
ISO 3166-2 alt bölüm koduna ayarlayın. |
continent_id |
continent_code |
BM M49 biçimindeki kıta koduna ayarlayın. |
subcontinent_id |
subcontinent_code |
BM M49 biçiminde alt kıta koduna ayarlanır. |
Cihaz alanları
Measurement Protocol device |
DeviceInfo (Data Manager API) |
Notlar |
|---|---|---|
category |
category |
|
language |
language_code |
|
screen_resolution |
screen_height ve screen_width |
Measurement Protocol'de screen_resolution, dize ("1280x720") olarak sağlanır. Data Manager API'de screen_height ve screen_width değerlerini ayrı tam sayı değerleri olarak gönderin. |
operating_system |
operating_system |
|
operating_system_version |
operating_system_version |
|
model |
model |
|
brand |
brand |
|
browser |
browser |
|
browser_version |
browser_version |