Alan eşlemeleri

Google Ads API yöntemlerini ve alanlarını Data Manager API'deki IngestEventsRequest eşdeğerleriyle eşlemek için tablolardaki eşlemeleri kullanın.

API yöntemleri

Data Manager API, her mağaza satışları etkinliği grubunu tek bir IngestEventsRequest olarak yüklemenize olanak tanır.

Buna karşılık, Google Ads API'de OfflineUserDataJobService kullanılarak üç adımlı bir süreç gerekiyordu:

  1. CreateOfflineUserDataJob kullanarak iş oluşturma
  2. AddOfflineUserDataJobOperations kullanarak işe işlemler ekleme
  3. İşi RunOfflineUserDataJob kullanarak çalıştırma

İstek alanları

Her IngestEventsRequest, istek sınırlarına tabidir. AddOfflineUserDataJobOperations isteğinizdeki işlem sayısı bu sınırları aşarsa isteği birden fazla Data Manager API alım isteğine bölmeniz gerekir.

Google Ads API isteklerinin alanları, Data Manager API'siyle şu şekilde eşlenir:

CreateOfflineUserDataJobRequest

Aşağıdaki tabloda, CreateOfflineUserDataJobRequest alanlarının IngestEventsRequest ile nasıl eşlendiği gösterilmektedir.

CreateOfflineUserDataJobRequest (Google Ads API) IngestEventsRequest (Data Manager API) Notlar
customer_id destinations.operating_account Müşteri ve dönüşüm işlemi alanları başlıklı makaleyi inceleyin.
  • developer-token istek başlığı
  • login-customer_id istek başlığı
  • linked-customer-id istek başlığı
 destinations Müşteri ve dönüşüm işlemi alanları başlıklı makaleyi inceleyin.
  • job.status
  • job.failure_reason
 Teşhis Dönüşüm yüklemenizle ilgili teşhisleri almak için IngestEventsResponse içinde döndürülen request_id öğesini kullanın.
job.id request_id Dönüşüm yüklemenizle ilgili teşhisleri almak için IngestEventsResponse içinde döndürülen request_id öğesini kullanın.
job.external_id Eşdeğeri yok
job.type Eşdeğeri yok
job.store_sales_metadata.third_party_metadata.partner_id destinations.login_account Mağaza satış dönüşümlerini yükleyen bir veri iş ortağı, bir hedefin login_account ile tanımlanır. Daha fazla bilgi için Hedefleri yapılandırma başlıklı makaleye bakın.
job.store_sales_metadata.third_party_metadata.advertiser_upload_date_time Eşdeğeri yok
job.store_sales_metadata.third_party_metadata.valid_transaction_fraction Eşdeğeri yok
job.store_sales_metadata.third_party_metadata.partner_match_fraction Eşdeğeri yok
job.store_sales_metadata.third_party_metadata.partner_upload_fraction Eşdeğeri yok
job.store_sales_metadata.third_party_metadata.bridge_map_version_id Eşdeğeri yok
job.store_sales_metadata.loyalty_fraction Eşdeğeri yok
job.store_sales_metadata.transaction_upload_fraction Eşdeğeri yok
job.store_sales_metadata.custom_key
  • events[].custom_variables[].variable
  • events[].cart_data.items[].custom_variables[].variable
 Etkinlik düzeyinde bir variable alanıyla veya öğe düzeyinde bir CustomVariable ile eşleyin.ItemCustomVariable
enable_match_rate_range_preview Eşdeğeri yok
validate_only validate_only
Eşdeğeri yok consent Google Ads API, UserData içinde yalnızca etkinlik düzeyinde consent belirtilmesini destekler. Veri Yöneticisi API'si için IngestEventsRequest üzerindeki consent alanını ayarlayarak bir istekteki tüm etkinlikler için izni belirtebilirsiniz. consent alanını Event olarak ayarlayarak bu değeri tek bir etkinlik için geçersiz kılabilirsiniz.
Eşdeğeri yok encoding UserData yüklemeleri için gereklidir. UserIdentifier değerleri için kullanılan Encoding olarak ayarlayın.
Eşdeğeri yok encryption_info İsteğin şifrelenmiş UserData kullanıcı tanımlayıcıları içerip içermediğini ayarlayın. Ayrıntılar için Şifreleme başlıklı makaleyi inceleyin.

AddOfflineUserDataJobOperationsRequest

Aşağıdaki tabloda, AddOfflineUserDataJobOperationsRequest alanlarının IngestEventsRequest ile nasıl eşlendiği gösterilmektedir.

AddOfflineUserDataJobOperationsRequest (Google Ads API) IngestEventsRequest (Data Manager API) Notlar
  • developer-token istek başlığı
  • login-customer_id istek başlığı
  • linked-customer-id istek başlığı
 destinations Müşteri ve dönüşüm işlemi alanları başlıklı makaleyi inceleyin.
resource_name Eşdeğeri yok Veri Yöneticisi API'si, iş kaynağının güncellenmesini gerektirmez.
enable_partial_failure Eşdeğeri yok IngestEventsRequest Başarılı olursa sonraki işlem sırasında oluşan hatalar etkinlik düzeyinde ele alınır. Bu da kısmi başarıya neden olabilir. Yüklemenizin durumunu ve bağımsız etkinliklerle ilgili hataları ve uyarıları almak için Teşhis Aracı'nı kullanın. IngestEventsRequest başarısız olursa (örneğin, BadRequest nedeniyle) hiçbir etkinlik işlenmez. Bu durumda hatayı çözmeniz ve isteği yeniden denemeniz gerekir. Daha fazla bilgi için API hatalarını anlama başlıklı makaleyi inceleyin.
enable_warnings Eşdeğeri yok Data Manager API isteğinizle ilgili uyarıları almak için Teşhisler'i kullanın. Bu özelliği etkinleştirmeniz gerekmez.
operations events OfflineUserDataJobOperation.create işlemi, IngestEventsRequest göndermeye eş değerdir. Veri Yöneticisi API'si, etkinliklerin kaldırılmasını desteklemez.
validate_only validate_only
Eşdeğeri yok consent Google Ads API, UserData içinde yalnızca etkinlik düzeyinde consent belirtilmesini destekler. Veri Yöneticisi API'si için IngestEventsRequest üzerindeki consent alanını ayarlayarak bir istekteki tüm etkinlikler için izni belirtebilirsiniz. consent alanını Event olarak ayarlayarak bu değeri tek bir etkinlik için geçersiz kılabilirsiniz.
Eşdeğeri yok encoding UserData yüklemeleri için gereklidir. UserIdentifier değerleri için kullanılan Encoding olarak ayarlayın.
Eşdeğeri yok encryption_info İsteğin şifrelenmiş UserData kullanıcı tanımlayıcıları içerip içermediğini ayarlayın. Ayrıntılar için Şifreleme başlıklı makaleyi inceleyin.

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.

Data Manager 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.

Google Ads API Destination (Data Manager API) Notlar
İsteğin 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 operating_account öğesine iş ortağı bağlantısı kullanarak erişiyorsanız account_id değerini bağlı hesabın müşteri kimliği olarak, account_type değerini ise DATA_PARTNER olarak ayarlayın. Aksi takdirde, linked_account alanını ayarlamayın.
conversion_action product_destination_id Dönüşüm işleminin sayısal kimliği olarak ayarlayın. Kaynak adını kullanmayın.

Etkinlik alanları

Aşağıdaki tabloda, mağaza satışı dönüşümü alanlarının iki API arasında nasıl eşlendiği gösterilmektedir.

ItemAttribute kullanılarak işlem başına yalnızca tek bir öğenin dahil edilmesini destekleyen Google Ads API'nin aksine, Data Manager API, CartData içinde etkinlik başına birden fazla öğenin dahil edilmesini destekler.

OfflineUserDataJobOperation.create (Google Ads API) Event (Data Manager API) Notlar
Eşdeğeri yok event_source Zorunlu: Mağaza satışları dönüşümleri için IN_STORE olarak ayarlanmalıdır.
transaction_attribute.conversion_action destinations.product_destination_id Müşteri ve dönüşüm işlemi alanları başlıklı makaleyi inceleyin. Kaynak adı yerine dönüşüm işleminin sayısal kimliğini kullanın.
transaction_attribute.transaction_date_time event_timestamp
Ayrıntılar için Zaman damgası biçimi bölümüne bakın.
transaction_attribute.transaction_amount_micros
  • conversion_value (Zorunlu)
  • cart_data.items[].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.
transaction_attribute.currency_code currency Zorunlu.
transaction_attribute.order_id transaction_id Zorunlu.
transaction_attribute.store_attribute.store_code event_location.store_id Zorunlu: Mağaza kodunu EventLocation nesnesindeki store_id alanında ayarlayın.
transaction_attribute.custom_value
  • custom_variables[].value
  • cart_data.items[].custom_variables[].value
 Etkinlik düzeyinde bir value alanıyla veya öğe düzeyinde bir CustomVariable ile eşleyin.ItemCustomVariable
transaction_attribute.item_attribute.item_id cart_data.items[].merchant_product_id
transaction_attribute.item_attribute.merchant_id
  • cart_data.merchant_id
  • cart_data.items[].merchant_id
 cart_data.merchant_id ayarını yaparsanız bu ayar tüm öğeler için varsayılan olarak kullanılır ancak tek tek öğeler için geçersiz kılabilirsiniz.
transaction_attribute.item_attribute.country_code
  • cart_data.merchant_feed_label
  • cart_data.items[].merchant_feed_label
 cart_data.merchant_feed_label ayarını yaparsanız bu ayar tüm öğeler için varsayılan olarak kullanılır ancak tek tek öğeler için geçersiz kılabilirsiniz.
transaction_attribute.item_attribute.language_code
  • cart_data.merchant_feed_language_code
  • cart_data.items[].merchant_feed_language_code
 cart_data.merchant_feed_language_code ayarını yaparsanız bu ayar tüm öğeler için varsayılan olarak kullanılır ancak tek tek öğeler için geçersiz kılabilirsiniz.
transaction_attribute.item_attribute.quantity cart_data.items[].quantity
Eşdeğeri yok cart_data.items[].unit_price Bu öğe için vergi, kargo ve etkinlik kapsamlı (işlem düzeyinde) indirimler hariç birim fiyatı olarak ayarlayın.
user_identifiers
  • user_data.user_identifiers
  • third_party_user_data.user_identifiers
 Zorunludur.

third_party_user_data ile aynı yapıyı kullanır ancak kullanıcı tanımlayıcılarının birinci taraf reklamveren verileri yerine üçüncü taraf bir kaynaktan geldiğini belirtir.user_data

third_party_user_data alanının doldurulmasına yalnızca giriş hesabı bir veri iş ortağıysa (login_account.account_type, DATA_PARTNER ise) izin verilir.

Ayrıntılar için Kullanıcı tanımlayıcı 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, IngestEventsRequest üzerinde consent alanını ayarlayarak bir istekteki tüm etkinlikler için de izni ayarlayabilirsiniz.

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

UserIdentifier (Google Ads API) UserIdentifier (Data Manager API) Notlar
user_identifier_source

Kaynak, Data Manager API'de Event hangi alanın doldurulacağını belirler:

  • user_data
  • third_party_user_data

third_party_user_data ile aynı yapıyı kullanır ancak kullanıcı tanımlayıcılarının birinci taraf reklamveren verileri yerine üçüncü taraf bir kaynaktan geldiğini belirtir.user_data

third_party_user_data alanının doldurulmasına yalnızca giriş hesabı bir veri iş ortağıysa (login_account.account_type, DATA_PARTNER ise) izin verilir.

Ayrıntılar için Kullanıcı tanımlayıcı alanları başlıklı makaleyi inceleyin.

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.
address_info address AddressInfo nesnesi olarak ayarlayın. Biçimlendirme ve karma oluşturma kurallarına uyun. Bir adresin karma oluşturma işlemi uygulanmış özelliklerini de şifreleyebilirsiniz.
address_info.hashed_first_name address.given_name
address_info.hashed_last_name address.family_name
address_info.country_code address.region_code
address_info.postal_code address.postal_code
address_info.city Eşdeğeri yok Veri Yöneticisi API'sinin mevcut sürümünde desteklenmez.
address_info.state Eşdeğeri yok Veri Yöneticisi API'sinin mevcut sürümünde desteklenmez.
address_info.hashed_street_address Eşdeğeri yok Veri Yöneticisi API'sinin mevcut sürümünde desteklenmez.
Önceki
Yükseltme adımları