Alan eşlemeleri

Tablolardaki eşlemeleri kullanarak bir Measurement Protocol veri toplama isteğini (/mp/collect) Data Manager API'deki IngestEventsRequest eşdeğeriyle eşleyin.

İ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 haritası. 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şleme. 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 nesnesi olarak ayarlayın.
events events Event kaynaklarının listesi olarak ayarlayın. 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 gereklidir.
user_id events.user_id İsteğe bağlı. 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. Veri Yöneticisi API'sinde istek düzeyinde zaman damgası yoktur. Her etkinlikte event_timestamp değerini etkinliğin gerçekleştiği zamana ayarlayın.
  • JSON biçimini kullanıyorsanız RFC 3339 biçiminde bir değer ayarlayın.
  • Protocol buffer kullanıyorsanız Timestamp kullanın ve seconds ile (isteğe bağlı olarak) nanoseconds alanlarını ayarlayın.

Ayrıntılar için Zaman damgası biçimi bölümüne bakın.
user_properties events.user_properties UserProperties nesnesi olarak ayarlayın. Data Manager API'si, tek tek kullanıcı özelliklerine zaman damgası ayarlamayı desteklemez. Kullanıcı özelliklerinde yapılan değişikliklerle ilişkili zaman damgaları, etkinliğin zaman damgasından (event_timestamp) çıkarılır.
user_data events.user_data UserData nesnesi olarak ayarlayın. Ayrıntılar için Kullanıcı tanımlayıcısı alanları başlıklı makaleyi inceleyin.
non_personalized_ads events.consent.ad_personalization non_personalized_ads true ise ad_personalization değerini DENIED olarak ayarlayın.
user_location events.event_location Ayrıntılar için Kullanıcı konumu alanları başlıklı makaleyi inceleyin.
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şlem sırasında tek tek etkinliklerle ilgili hataları ve uyarıları almak için Teşhisler'i kullanın. IngestEventsRequest başarısız olursa (örneğin, gerekli alanlar eksik olduğundan) 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 validate_only değerini true olarak ayarlayarak Measurement Protocol doğrulama sunucusuna benzer şekilde, herhangi bir veri almadan etkinlikleri doğrulayın.
Eşdeğeri yok encoding UserData yüklemeleri için gereklidir. UserIdentifier değerleri için kullanılan Encoding olarak ayarlayın.

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 nasıl eşleyeceğiniz aşağıda açıklanmıştır:

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ğine 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 ayarlayın.
Eşdeğeri yok destination_references İstek düzeyindeki destinations listesi birden fazla Google Analytics Destination içeriyorsa zorunludur. Etkinliğin hangi hedefe gönderileceğini belirtmek için bir giriş ekleyin.
timestamp_micros event_timestamp
  • JSON biçimini kullanıyorsanız RFC 3339 biçiminde bir değer ayarlayın.
  • Protocol buffer kullanıyorsanız Timestamp kullanın ve seconds ile (isteğe bağlı olarak) nanoseconds alanlarını ayarlayın.

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 etkinlik parametresi olarak ayarlanır. Data Manager API'de, etkinlikteki UserProperties nesnesinde 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 Sepete uygulanan kuponları sağlamak için coupon_codes alanını kullanın. Google Analytics için yalnızca tek bir kupon sağlayın. Bu, tek tek öğeler 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 değeri session_id olarak ayarlanmış bir girişe giden harita.
params.engagement_time_msec additional_event_parameters parameter_name değeri engagement_time_msec olarak ayarlanmış bir girişe giden harita.
Diğer params additional_event_parameters

Diğer parametreleri parameter_name ve value ile nesne listesi olarak eşleyin.

Not: transaction_id, currency veya value için buraya giriş eklemeyin. Bunun yerine Event üzerindeki en üst düzey alanları kullanın.

Kullanıcı tanımlayıcısı alanları

Measurement Protocol user_data UserIdentifier (Data Manager API) Notlar
sha256_email_address[] email_address Biçimlendirilmiş ve karma oluşturulmuş e-posta adresi olarak ayarlayın. Ayrıca 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ı olarak ayarlayın. Karma oluşturma işlemi uygulanmış telefon numarasını da şifreleyebilirsiniz.
address[] address AddressInfo nesnesi olarak ayarlayın. Biçimlendirme ve karma oluşturma kurallarına uyun.
address[].sha256_first_name address.given_name Verilen ad, biçimlendirilmiş ve karma oluşturma işlemi uygulanmış olarak ayarlanır. Ayrıca karma oluşturulmuş adı şifreleyebilirsiniz.
address[].sha256_last_name address.family_name Biçimlendirilmiş ve karma oluşturulmuş aile adı olarak ayarlayın. Karma oluşturma işlemi uygulanmış aile adını da şifreleyebilirsiniz.
address[].country address.region_code
address[].postal_code address.postal_code
address[].city Eşdeğeri yok Veri Yöneticisi API'sinin mevcut sürümünde desteklenmez.
address[].region Eşdeğeri yok Veri Yöneticisi API'sinin mevcut sürümünde desteklenmez.
address[].sha256_street Eşdeğeri yok Veri Yöneticisi API'sinin mevcut sürümünde desteklenmez.

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 değeri item_name olarak ayarlanmış bir girişe giden harita.
quantity quantity Zorunlu.
price unit_price Zorunlu.
Diğer öğe alanları additional_item_parameters

Diğer öğe parametrelerini (ör. discount, affiliation, item_brand vb.) parameter_name ve value ile nesne listesi olarak eşleyin.

Not: quantity, price veya item_id için buraya giriş eklemeyin. Bunun yerine Item üzerindeki üst düzey alanları kullanın.

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 kodu olarak ayarlayın.
region_id subdivision_code ISO 3166-2 alt bölüm kodu olarak ayarlanır.
continent_id continent_code UN M49 biçimindeki kıta koduna ayarlanır.
subcontinent_id subcontinent_code UN 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 olarak ("1280x720") sağlanır. Data Manager API'de screen_height ve screen_width ayrı tam sayı değerleri olarak gönderilir.
operating_system operating_system
operating_system_version operating_system_version
model model
brand brand
browser browser
browser_version browser_version
Önceki
Yükseltme adımları