Alan eşlemeleri

Google Ads API'deki bir UploadClickConversionRequest öğesini Data Manager API'deki IngestEventsRequest eşdeğerine eşlemek için tablolardaki eşlemeleri kullanın.

Kimlik doğrulama

Data Manager API, Google Ads API'den farklı bir kapsama sahip 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ı

UploadClickConversionRequest (Google Ads API)	IngestEventsRequest (Data Manager API)	Notlar
customer_id developer-token istek başlığı login-customer_id istek başlığı linked-customer-id istek başlığı conversion_action	destinations	Müşteri ve dönüşüm işlemi alanları bölümüne bakın.
Eşdeğeri yok	consent	İstekteki etkinlikler için isteğe bağlı varsayılan izin ayarları. Event öğesinin consent alanını ayarlayarak bu değeri bağımsız bir etkinlik için geçersiz kılabilirsiniz.
Eşdeğeri yok	encoding	Zorunlu: UserIdentifier değerleri için kullanılan Encoding olarak ayarlanır.
Eşdeğeri yok	encryption_info	İstek şifrelenmiş değerler içeriyorsa ayarlayın. Ayrıntılar için Şifreleme başlıklı makaleyi inceleyin.
job_id	Eşdeğeri yok	Teşhis bilgilerini almak için yanıtta döndürülen request_id değerini kullanın.
partial_failure	Eşdeğeri yok	Data Manager API, hızlı başarısızlık hata modelini kullanır. Bir IngestEventsRequest alanının doğrulaması başarısız olursa Data Manager API, isteğin tamamını reddeder.
validate_only	validate_only
conversions	events	Dönüşümlerin veya etkinliklerin listesi. Ayrıntılar için Dönüşüm alanları bölümüne bakın.

Müşteri ve dönüşüm işlemi alanları

Google Ads API, developer-token istek başlığını gerektirir. Farklı kimlik doğrulama senaryoları için login-customer-id ve linked-customer-id istek başlıklarını ayarlarsınız.

Data Manager API için geliştirici jetonu gerekmez. Giriş ve bağlı müşteri bilgilerini istek başlıkları yerine Destination alanlarını kullanarak belirtirsiniz. Hedefler hakkında daha fazla bilgi için Hedefleri yapılandırma başlıklı makaleyi inceleyin.

Tek bir conversion_action için Google Ads API alanlarını Destination içindeki eşdeğer alanlarla şu şekilde eşleyebilirsiniz:

Google Ads API	Destination (Data Manager API)	Notlar
İsteğin customer_id	operating_account	account_id değerini Google Ads reklam dönüşümü hesabının müşteri kimliği olarak ayarlayın. Bu, Google Ads API isteğinizdeki customer_id değerinden farklı olabilir. operating_account kaynağının account_type alanını GOOGLE_ADS olarak ayarlayın.
developer-token istek başlığı	Eşdeğeri yok	Data Manager API için geliştirici jetonu gerekmez.
login-customer-id istek başlığı	login_account	account_id değerini, giriş hesabının müşteri kimliği olarak ayarlayın. Giriş hesabı bir Google Ads hesabıysa account_type değerini GOOGLE_ADS, giriş hesabı bir veri iş ortağı hesabıysa DATA_PARTNER olarak ayarlayın.
linked-customer-id istek başlığı	linked_account	operating_account hizmetine iş ortağı bağlantısı kullanarak erişiyorsanız account_id değerini bağlı hesabın müşteri kimliği, account_type değerini ise DATA_PARTNER olarak ayarlayın. Aksi takdirde linked_account alanını ayarlamayın.
ClickConversion için conversion_action	product_destination_id	Dönüşüm işleminin sayısal kimliğine ayarlanır. ConversionAction kaynağının adını kullanmayın.
Eşdeğeri yok	reference	Destination için kullanıcı tarafından tanımlanan bir tanımlayıcı. Tek bir istekte birden fazla dönüşüm işlemi için dönüşüm gönderiyorsanız bu alanı ayarlayın.

Dönüşüm alanları

ClickConversion (Google Ads API)	Event (Data Manager API)	Notlar
cart_data	cart_data	Ayrıntılar için Alışveriş sepeti veri alanları başlıklı makaleyi inceleyin.
consent	consent	Her iki API de benzer bir Consent nesnesi (ad_user_data, ad_personalization) kullanır. Data Manager API için istek düzeyindeki consent alanını ayarlayarak bir istekteki tüm etkinlikler için izin de ayarlayabilirsiniz.
conversion_action	destination_references	Tek bir istekte birden fazla dönüşüm işlemi için dönüşüm gönderiyorsanız bu alanı hedefin ilgili reference değerine ayarlayın.
conversion_date_time	event_timestamp	JSON biçimini kullanıyorsanız RFC 3339 biçiminde bir değer ayarlayın. Bu biçim, Google Ads API tarih ve saat biçiminden biraz farklıdır. Protokol arabellekleri 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.
conversion_environment	Eşdeğeri yok
conversion_value	conversion_value	Mikro değerine değil, para birimi değerine ayarlayın. Örneğin, 5, 23 TL'lik bir dönüşüm değeri için 5.23 değerini kullanın.
currency_code	currency
custom_variables	custom_variables	Ayrıntılar için Özelleştirilebilen değişken alanları bölümüne bakın.
customer_type	user_properties.customer_type	CustomerType enum'unda bir değere ayarlayın.
Eşdeğeri yok	event_source
Eşdeğeri yok	event_device_info
external_attribution_data	Eşdeğeri yok
gbraid	ad_identifiers.gbraid
gclid	ad_identifiers.gclid
Eşdeğeri yok	last_updated_timestamp
order_id	transaction_id
session_attributes_encoded	ad_identifiers.session_attributes	Ayrıntılar için Oturum özellikleri ekleme bölümüne bakın.
session_attributes_key_value_pairs	experimental_fields	Ayrıntılar için Oturum özellikleri ekleme bölümüne bakın.
user_identifiers	user_data.user_identifiers	Ayrıntılar için Kullanıcı kimliği alanları bölümüne bakın.
user_ip_address	landing_page_device_info.ip_address
wbraid	ad_identifiers.wbraid

Alışveriş sepeti veri alanları

CartData (Google Ads API)	CartData (Data Manager API)	Notlar
feed_country_code	merchant_feed_label	Feed etiketi olarak ayarlayın.
feed_language_code	merchant_feed_language_code
items	items
local_transaction_cost	transaction_discount
merchant_id	merchant_id

Alışveriş sepeti verileri için öğe alanları

Item (Google Ads API)	Item (Data Manager API)	Notlar
product_id	merchant_product_id
quantity	quantity
unit_price	unit_price
Eşdeğeri yok	item_id
Eşdeğeri yok	additional_item_parameters

Özelleştirilebilen değişken alanları

CustomVariable (Google Ads API)	CustomVariable (Data Manager API)	Notlar
Eşdeğeri yok	destination_references	Google Ads API, her dönüşüm işlemi için ayrı istekler gerektirir. Data Manager API, tek bir istekte birden fazla dönüşüm işlemi için dönüşüm göndermeyi ve belirli bir özelleştirilebilen değişkeni hangi hedeflerin alması gerektiğini belirtmek için bu destination_references alanını kullanmayı destekler.
conversion_custom_variable	variable	Kaynak adı yerine değişkenin adı olarak ayarlanır.
value	value

Kullanıcı kimliği alanları

İpucu: Data Manager API'de, kullanıcı kimliklerini bir UserData nesnesine ekleyin, ardından Event nesnesinin user_data alanını ayarlayın. Google Ads API'de kullanıcı kimlikleri, user_identifiers alanındaki ClickConversion nesnesine doğrudan eklenir.

UserIdentifier (Google Ads API)	UserIdentifier (Data Manager API)
address_info	address	Biçimlendirme ve karma oluşturma yönergelerini uygulayın. Bir adresin karma oluşturma işlemi uygulanmış özelliklerini de şifreleyebilirsiniz.
hashed_email	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.
hashed_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.
Diğer alanlar: mobile_id third_party_user_id user_identifier_source	Alakalı değil	Hiçbir API, çevrimdışı dönüşümler veya potansiyel müşteriler için gelişmiş dönüşümler için bu tanımlayıcıları desteklemez. Data Manager API, dönüşüm etkinliklerini ek veri kaynağı olarak gönderirken bu tanımlayıcıları desteklemez.

Yanıt alanları

UploadClickConversionResponse (Google Ads API)	IngestEventsResponse (Data Manager API)	Notlar
job_id	Eşdeğeri yok	Teşhis bilgilerini almak için yanıtta döndürülen request_id değerini kullanın.
partial_failure_error	Eşdeğeri yok	Data Manager API, hızlı başarısızlık hata modelini kullanır. Bir IngestEventsRequest alanının doğrulaması başarısız olursa Data Manager API, isteğin tamamını reddeder.
request-id yanıt başlığı	request_id	İstek kimliği, yanıt başlığı yerine Data Manager API'sinde yanıt alanı olarak döndürülür.
results	Eşdeğeri yok	Data Manager API, etkinlikleri eşzamansız olarak işler. Teşhis aracını kullanarak işleme sonuçlarını kontrol edin.