Alan eşlemeleri

Tablolardaki eşlemeleri kullanarak Google Ads API'deki bir UploadClickConversionRequest öğesini Data Manager API'deki IngestEventsRequest eşdeğeriyle eşleyin.

İ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ı başlıklı makaleyi inceleyin.
Eşdeğeri yok consent İstekteki etkinlikler için isteğe bağlı varsayılan izin ayarları. consent alanını Event olarak ayarlayarak bu değeri tek bir etkinlik için geçersiz kılabilirsiniz.
Eşdeğeri yok encoding Zorunlu: UserIdentifier değerleri için kullanılan Encoding olarak ayarlayın.
Eşdeğeri yok encryption_info İstek şifrelenmiş değerler içeriyorsa ayarlanır. Ayrıntılar için Şifreleme başlıklı makaleyi inceleyin.
job_id Eşdeğeri yok Teşhisleri almak için yanıtta döndürülen request_id değerini kullanın.
partial_failure Eşdeğeri yok Veri Yöneticisi API, kısmi hatayı desteklemez. Bir IngestEventsRequest alanının doğrulaması başarısız olursa Veri Yöneticisi API'si isteğin tamamını reddeder.
validate_only validate_only
conversions events Dönüşümlerin veya etkinliklerin listesi. Ayrıntılı bilgi 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 üstbilgisini gerektirir ve farklı kimlik doğrulama senaryoları için login-customer-id ve linked-customer-id istek üstbilgilerini ayarlarsınız.

Veri Yöneticisi API'si 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 nasıl eşleyeceğinizi aşağıda bulabilirsiniz:

Google Ads API Destination (Data Manager API) Notlar
Talebin customer_id operating_account account_id değerini Google Ads dönüşüm hesabının müşteri kimliği olarak ayarlayın. operating_account öğesinin account_type değerini GOOGLE_ADS olarak ayarlayın.

Data Manager API, Google Ads API için kullandığınızdan farklı bir müşteri kimliği gerektirebilir. Ayrıntılar için Hedef hesap koşullarındaki farklılıklar başlıklı makaleyi inceleyin.
developer-token istek başlığı Eşdeğeri yok Veri Yöneticisi API'si 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, giriş hesabı bir veri iş ortağı hesabıysa DATA_PARTNER olarak ayarlayın.GOOGLE_ADS
linked-customer-id istek başlığı linked_account account_id değerini bağlı hesabın müşteri kimliği olarak ayarlayın. account_type değerini DATA_PARTNER olarak ayarlayın.
conversion_action/ClickConversion product_destination_id Dönüşüm işleminin sayısal kimliği olarak ayarlayın. ConversionAction öğesinin kaynak adını kullanmayın.
Eşdeğeri yok reference Destination için kullanıcı tanımlı 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'de, istek düzeyinde consent alanı ayarlanarak bir istekteki tüm etkinlikler için de izin ayarlanabilir.
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
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 cinsinden değer değil, para birimi değeri olarak 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 Özel değişken alanları başlıklı makaleyi inceleyin.
customer_type
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ılı bilgi için Oturum özellikleri ekleme başlıklı makaleyi inceleyin.
session_attributes_key_value_pairs experimental_fields Ayrıntılı bilgi için Oturum özellikleri ekleme başlıklı makaleyi inceleyin.
user_identifiers user_data.user_identifiers Ayrıntılar için Kullanıcı tanımlayıcısı alanları başlıklı makaleyi inceleyin.
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

Özel değişken alanları

CustomVariable (Google Ads API) CustomVariable (Data Manager API) Notlar
Eşdeğeri yok destination_references Google Ads API, dönüşüm işlemi başına 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şkenin hangi hedeflere gönderileceğini belirtmek için bu destination_references alanını kullanmayı destekler.
conversion_custom_variable variable Kaynak adı yerine değişkenin adı olarak ayarlayın.
value value

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

UserIdentifier (Google Ads API) UserIdentifier (Data Manager API)
address_info address Biçimlendirme ve karma oluşturma kurallarına uyun. Bir adresin karma oluşturma işlemi uygulanmış özelliklerini de şifreleyebilirsiniz.
hashed_email 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.
hashed_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.
Diğer alanlar:
  • mobile_id
  • third_party_user_id
  • user_identifier_source
 Alakalı değil API'lerin hiçbiri, çevrimdışı dönüşümler veya potansiyel müşteriler için gelişmiş dönüşümler söz konusu olduğunda bu tanımlayıcıları desteklemez. Data Manager API ise 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şhisleri almak için yanıtta döndürülen request_id değerini kullanın.
partial_failure_error Eşdeğeri yok Veri Yöneticisi API, kısmi hatayı desteklemez. Bir IngestEventsRequest alanının doğrulaması başarısız olursa Veri Yöneticisi API'si isteğin tamamını reddeder.
request-id response header request_id İstek kimliği, yanıt başlığı olarak değil, Data Manager API'de 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şhisleri kullanarak işleme sonuçlarını kontrol edin.
Önceki
Yükseltme adımları