Alan eşlemeleri

Google Ads API yöntemlerini ve alanlarını Veri Yöneticisi API'deki IngestEventsRequest eşdeğerleriyle 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.

API yöntemleri

Veri Yöneticisi API'si, her bir mağaza satış etkinliği grubunu tek bir IngestEventsRequest içinde yüklemenize olanak tanır.

Buna karşılık, Google Ads API'de OfflineUserDataJobService kullanılarak üç adımlı bir işlem yapılması gerekiyordu:

  1. CreateOfflineUserDataJob kullanarak iş oluşturma
  2. AddOfflineUserDataJobOperations kullanarak işe işlem ekleme
  3. İşi RunOfflineUserDataJob kullanarak çalıştırın.

İ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 veri alma isteğine bölmeniz gerekir.

Google Ads API isteklerinin alanları, Veri Yöneticisi API'si ile aşağıdaki ş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ı bölümüne bakın.
  • 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ı bölümüne bakın.
  • job.status
  • job.failure_reason
 Teşhis Dönüşüm yüklemenizle ilgili teşhis bilgilerini almak için IngestEventsResponse içinde döndürülen request_id değerini kullanın.
job.id request_id Dönüşüm yüklemenizle ilgili teşhis bilgilerini almak için IngestEventsResponse içinde döndürülen request_id değerini 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 veri iş ortağı, hedefin login_account ile tanımlanır. Daha fazla bilgi için Hedefleri yapılandırma başlıklı makaleyi inceleyin.
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 CustomVariable veya öğe düzeyinde bir ItemCustomVariable öğesinin variable alanıyla eşleyin.
enable_match_rate_range_preview Eşdeğeri yok
validate_only validate_only
Eşdeğeri yok consent Google Ads API, yalnızca UserData içinde etkinlik düzeyinde consent belirtmeyi destekler. Data Manager API için IngestEventsRequest üzerinde consent alanını ayarlayarak bir istekteki tüm etkinlikler için izin belirtebilirsiniz. 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 UserData yüklemeleri için gereklidir. UserIdentifier değerleri için kullanılan Encoding olarak ayarlanır.
Eşdeğeri yok encryption_info İstek, şifrelenmiş UserData kullanıcı kimlikleri içeriyorsa ayarlanır. 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ı bölümüne bakın.
resource_name Eşdeğeri yok Data Manager API, iş kaynağının güncellenmesini gerektirmez.
enable_partial_failure Eşdeğeri yok IngestEventsRequest başarılı olursa, sonraki işlemler sırasında meydana gelen tüm hatalar etkinlik düzeyinde ele alınır. Bu da kısmi başarıyla sonuçlanabilir. Yüklemenizin durumunu, bağımsız etkinliklerle ilgili hataları ve uyarıları almak için Teşhis Aracı'nı kullanın. IngestEventsRequest başarısız olursa (ör. BadRequest nedeniyle) 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.
enable_warnings Eşdeğeri yok Data Manager API isteğinizle ilgili uyarıları almak için Teşhis'i kullanın. Bu ayarı etkinleştirmeniz gerekmez.
operations events OfflineUserDataJobOperation.create işlemi, IngestEventsRequest göndermeye eşdeğerdir. Data Manager API, etkinliklerin kaldırılmasını desteklemez.
validate_only validate_only
Eşdeğeri yok consent Google Ads API, yalnızca UserData içinde etkinlik düzeyinde consent belirtmeyi destekler. Data Manager API için IngestEventsRequest üzerinde consent alanını ayarlayarak bir istekteki tüm etkinlikler için izin belirtebilirsiniz. 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 UserData yüklemeleri için gereklidir. UserIdentifier değerleri için kullanılan Encoding olarak ayarlanır.
Eşdeğeri yok encryption_info İstek, şifrelenmiş UserData kullanıcı kimlikleri içeriyorsa ayarlanır. 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. 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.

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. 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.
conversion_action product_destination_id Dönüşüm işleminin sayısal kimliğine ayarlanır. Kaynak adını kullanmayın.

Etkinlik alanları

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

ItemAttribute kullanarak işlem başına yalnızca tek bir öğe eklemeyi destekleyen Google Ads API'nin aksine, Data Manager API, CartData içinde etkinlik başına birden fazla öğe eklemeyi destekler.

OfflineUserDataJobOperation.create (Google Ads API) Event (Data Manager API) Notlar
Eşdeğeri yok event_source Zorunlu Mağaza satışı dönüşümleri için IN_STORE olarak ayarlanır.
transaction_attribute.conversion_action destinations.product_destination_id Müşteri ve dönüşüm işlemi alanları bölümüne bakın. Kaynak adı yerine dönüşüm işleminin sayısal kimliğini kullanın.
transaction_attribute.transaction_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.
transaction_attribute.transaction_amount_micros
  • conversion_value (Zorunlu)
  • cart_data.items[].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.
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 CustomVariable veya öğe düzeyinde bir ItemCustomVariable öğesinin value alanıyla eşleyin.
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 özelliğini ayarlarsanız bu özellik tüm öğeler için varsayılan olarak kullanılır ancak tek tek öğeler için geçersiz kılınabilir.
transaction_attribute.item_attribute.country_code
  • cart_data.merchant_feed_label
  • cart_data.items[].merchant_feed_label
 cart_data.merchant_feed_label özelliğini ayarlarsanız bu özellik tüm öğeler için varsayılan olarak kullanılır ancak tek tek öğeler için geçersiz kılınabilir.
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 özelliğini ayarlarsanız bu özellik tüm öğeler için varsayılan olarak kullanılır ancak tek tek öğeler için geçersiz kılınabilir.
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 fiyata ayarlanır.
user_identifiers
  • user_data.user_identifiers
  • third_party_user_data.user_identifiers
 Zorunludur.

third_party_user_data, user_data ile aynı yapıyı kullanır ancak kullanıcı kimliklerinin birinci taraf reklamveren verileri yerine üçüncü taraf bir kaynaktan geldiğini gösterir.

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ı kimliği alanları bölümüne bakın.

consent consent Her iki API de benzer bir Consent nesnesi (ad_user_data, ad_personalization) kullanır. Data Manager API için IngestEventsRequest'te consent alanını ayarlayarak bir istekteki tüm etkinlikler için izin de ayarlayabilirsiniz.

Kullanıcı kimliği alanları

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

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

  • user_data
  • third_party_user_data

third_party_user_data, user_data ile aynı yapıyı kullanır ancak kullanıcı kimliklerinin birinci taraf reklamveren verileri yerine üçüncü taraf bir kaynaktan geldiğini gösterir.

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ı kimliği alanları bölümüne bakın.

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.
address_info address AddressInfo nesnesine ayarlanır. Biçimlendirme ve karma oluşturma yönergelerini uygulayın. 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 Google Ads reklam hedefleri için desteklenmez.
address_info.state Eşdeğeri yok Google Ads reklam hedefleri için desteklenmez.
address_info.hashed_street_address Eşdeğeri yok Google Ads reklam hedefleri için desteklenmez.
Önceki
Yükseltme adımları