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