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 bölümüne bakın.
`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'si 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 başlığını gerektirir ve farklı kimlik doğrulama senaryoları için login-customer-id ve linked-customer-id istek başlıklarını 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ğiniz aşağıda açıklanmıştır:

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.
`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. Veri Yöneticisi API'sinde, istek düzeyindeki `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`	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. 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.
`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, 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ş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. Ayrıca 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. Ayrıca, 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ş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'si 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ığı yerine 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.

Yükseltme adımları