Alan eşlemeleri

Müşteri Eşleştirme iş akışınızın her adımını Google Ads API'den Data Manager API'ye yükseltmek için alan eşlemelerini 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.

Kitle yönetimi alan eşlemeleri

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

UserList (Google Ads API) UserList (Data Manager API) Notlar
resource_name name Ayrıntılar için Kaynak adları bölümüne bakın.
id id
read_only read_only
name display_name Zorunlu
description description Zorunlu
membership_status membership_status
integration_code integration_code
membership_life_span membership_duration

Bir kitle üyesinin listeye eklendikten sonra listede kaldığı süre. Değer, tam günlere karşılık gelmelidir. Ayarlanmazsa varsayılan olarak maksimum değer kullanılır.

Değeri Zaman damgası biçimini kullanarak biçimlendirin.
size_for_display size_info.display_network_members_count
size_range_for_display Eşdeğeri yok. Boyut bilgileri için size_info.display_network_members_count kullanın.
size_for_search size_info.search_network_members_count
size_range_for_search Eşdeğeri yok. Boyut bilgileri için size_info.search_network_members_count kullanın.
type Eşdeğeri yok.
access_reason access_reason
account_user_list_status account_access_status
closing_reason closing_reason
eligible_for_search target_network_info.eligible_for_search
eligible_for_display target_network_info.eligible_for_display
match_rate_percentage ingested_user_list_info.contact_id_info.match_rate_percentage
basic_user_list ingested_user_list_info.pseudonymous_id_info Müşteri Eşleştirme için kullanılmaz.
crm_based_user_list ingested_user_list_info Zorunlu. Müşteri Eşleştirme kitlesi bilgilerini inceleyin.
Eşdeğeri yok. ingested_user_list_info.pair_id_info Müşteri Eşleştirme için kullanılmaz.
Eşdeğeri yok. ingested_user_list_info.partner_audience_info Müşteri Eşleştirme için kullanılmaz.
logical_user_list Eşdeğeri yok. Müşteri Eşleştirme için kullanılmaz.
logical_user_list Eşdeğeri yok. Müşteri Eşleştirme için kullanılmaz.
lookalike_user_list Eşdeğeri yok. Müşteri Eşleştirme için kullanılmaz.
rule_based_user_list Eşdeğeri yok. Müşteri Eşleştirme için kullanılmaz.
similar_user_list Eşdeğeri yok. Müşteri Eşleştirme için kullanılmaz.

Müşteri Eşleştirme kitlesi bilgileri

Google Ads API'de, Müşteri Eşleştirme kitlesi oluştururken crm_based_user_list alanını CrmBasedUserListInfo olarak ayarlamanız gerekir.

Data Manager API'de, ingested_user_list_info alanını bir IngestedUserListInfo olarak ayarlayarak eşdeğer özellikleri ayarlayın. Ardından, Müşteri Eşleştirme ve kullanıcı verisi türü için gerekli alanları ayarlayın.

İletişim bilgileri

upload_key_types
CONTACT_ID içeren bir listeye ayarlanmalıdır. Bu, Google Ads API'de upload_key_type değerini CONTACT_INFO olarak ayarlamaya eşdeğerdir.
contact_id_info

ContactIdInfo olarak ayarlayın.

data_source_type değerini DATA_SOURCE_TYPE_FIRST_PARTY olarak ayarlayın. Bu, Google Ads API'de data_source_type değerini FIRST_PARTY olarak ayarlamakla eşdeğerdir.

Mobile ID'ler

upload_key_types
MOBILE_ID içeren bir listeye ayarlanmalıdır. Bu, Google Ads API'de upload_key_type değerini MOBILE_ADVERTISING_ID olarak ayarlamaya eşdeğerdir.
mobile_id_info

MobileIdInfo olarak ayarlayın.

  • data_source_type değerini DATA_SOURCE_TYPE_FIRST_PARTY olarak ayarlayın. Bu, Google Ads API'de data_source_type değerini FIRST_PARTY olarak ayarlamaya eşdeğerdir.
  • key_space değerini IOS veya ANDROID olarak ayarlayın. Data Manager API bu değeri gerektirir. Bu, anahtar alanının app_id parametresinden çıkarıldığı Google Ads API'den farklıdır.
  • app_id parametresini, verilerin toplandığı mobil uygulamayı benzersiz şekilde tanımlayan dizeye ayarlayın. Google Ads API'de app_id için kullandığınız biçimi kullanın.

User ID'ler

upload_key_types
USER_ID içeren bir listeye ayarlanmalıdır. Bu, Google Ads API'de upload_key_type değerini CRM_ID olarak ayarlamaya eşdeğerdir.
user_id_info

UserIdInfo olarak ayarlayın.

data_source_type değerini DATA_SOURCE_TYPE_FIRST_PARTY olarak ayarlayın. Bu, Google Ads API'de data_source_type değerini FIRST_PARTY olarak ayarlamakla eşdeğerdir.

Kaynak adları

Data Manager API, Google Ads API'den farklı bir kaynak adı biçimi kullanır.

Google Ads API

Google Ads API'de UserList kaynak adı şu biçimi kullanır:

customers/{customer_id}/userLists/{user_list_id}

Data Manager API

Data Manager API'de UserList kaynak adı şu biçimi kullanır:

accountTypes/{accountType}/accounts/{account}/userLists/{userList}

Alan eşlemelerini yükleme

Google Ads API'deki bir AddOfflineUserDataJobOperationsRequest'yi Data Manager API'deki eşdeğer IngestionService isteğiyle eşlemek için tablolardaki eşlemeleri kullanın.

İstek alanları

Bu eşlemeler, Veri Yöneticisi API'sindeki IngestAudienceMembersRequest'yi referans olarak kullanır ancak Google Ads API isteğinizi RemoveAudienceMembersRequest veya RemoveAllAudienceMembersRequest'e dönüştürüyorsanız da bu eşlemeleri kullanabilirsiniz.

AddOfflineUserDataJobOperationsRequest (Google Ads API) IngestAudienceMembersRequest (Data Manager API) Notlar
  • customer_id alanı
  • OfflineUserDataJob alanının customer_match_user_list_metadata alanı
  • developer-token istek başlığı
  • login-customer_id istek başlığı
  • linked-customer-id istek başlığı
 destinations Müşteri ve kitle alanları bölümünü inceleyin.
OfflineUserDataJob adlı kullanıcının customer_match_user_list_metadata adlı albümünden consent consent İstekteki kitle üyeleri için isteğe bağlı varsayılan izin ayarları. AudienceMember öğesinin consent alanını ayarlayarak bu değeri tek bir kitle üyesi için geçersiz kılabilirsiniz.
Eşdeğeri yok encoding Zorunlu: UserIdentifier değerleri için kullanılan Encoding değerine ayarlayın.
Eşdeğeri yok encryption_info İstek şifrelenmiş değerler içeriyorsa ayarlayın. Ayrıntılar için Şifreleme bölümüne bakın.
job_id Eşdeğeri yok Teşhis bilgilerini almak için yanıtta döndürülen request_id değerini kullanın.
enable_partial_failure Eşdeğeri yok Data Manager API, hızlı başarısızlık hata modelini kullanır. Bir IngestAudienceMembersRequest nesnesinin herhangi bir alanının doğrulaması başarısız olursa Data Manager API, isteğin tamamını reddeder. Teşhis özelliğini kullanarak işleme hatalarını alma
enable_warnings Eşdeğeri yok Data Manager API, yanıttaki uyarıları bildirmez. Teşhis'i kullanarak işleme uyarılarını alın.
validate_only validate_only
operations audience_members Eklenecek veya kaldırılacak kitle üyelerinin listesi. Ayrıntılar için İşlem alanları bölümüne bakın.
Eşdeğeri yok terms_of_service Zorunlu. Kullanıcının, Müşteri Eşleştirme Hizmet Şartları'nı kabul ettiğini veya reddettiğini belirtmek için ayarlanır.

Müşteri ve kitle alanları

Google Ads API, iş başına yalnızca bir kitleye kitle üyesi yüklemeyi destekler.Ayrıca developer-token istek başlığı gereklidir 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, tek bir istekte birden fazla kitle için kitle üyeleri göndermeyi destekler. 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'de, bir OfflineUserDataJobOperation nesnesinin remove_all alanını true olarak ayarlayarak bir kitlenin tüm üyelerini kaldırabilirsiniz.

Data Manager API'de bunu RemoveAllAudienceMembersRequest göndererek yaparsınız. Ayrıntılar için Tüm üyeleri kaldırma kılavuzuna bakın.

Tek bir kitle 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
İsteğin customer_id operating_account account_id değerini kitlenin müşteri kimliği olarak ayarlayın. operating_account için account_type değerini 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.
OfflineUserDataJob'ın customer_match_user_list_metadata bölümünden user_list product_destination_id Zorunlu. Kitlenin sayısal kimliğine ayarlanır. UserList öğesinin kaynak 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 kitle için kitle üyeleri gönderiyorsanız bu alanı ayarlayın.

İşlem alanları

Data Manager API, kitle üyelerini eklemek ve kaldırmak için ayrı yöntemler içerir. Buna karşılık, Google Ads API'deki AddOfflineUserDataJobOperationsRequest, bir operations listesi içerir. Bu listedeki her bir öğe, işlem türüne göre üye ekler, üye kaldırır veya tüm üyeleri kaldırır. Her işlem türünün Data Manager API'deki karşılık gelen yöntemiyle eşleştirmesi aşağıda verilmiştir:

OfflineUserDataJobOperation (Google Ads API) IngestionService yöntemi (Data Manager API) Notlar
create IngestAudienceMembers Ayrıntılar için Kitle üyesi alanları bölümünü inceleyin.
remove RemoveAudienceMembers Ayrıntılar için Kitle üyesi alanları bölümünü inceleyin.
remove_all RemoveAllAudienceMembers Ayrıntılar için Tüm kitle üyelerini kaldırma bölümüne bakın.

Kitle üyesi alanları

UserData (Google Ads API) AudienceMember (Data Manager API) Notlar
consent consent

Kitle üyesinin iznini belirtmek için ayarlanır.

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 kitle üyeleri için izin de ayarlayabilirsiniz.
transaction_attribute Eşdeğeri yok. Müşteri Eşleştirme için geçerli değildir.
user_attribute Eşdeğeri yok. Müşteri Eşleştirme için geçerli değildir.
user_identifiers
  • mobile_data
  • user_id_data
  • composite_data
    • user_data
    • ip_data

Kitle üyeleri için gönderdiğiniz veri türüne karşılık gelen alanı doldurun. Ayrıntılar için Kullanıcı kimliği alanları bölümüne bakın.

Kullanıcı kimliği alanları

Google Ads API'de iletişim bilgileri, mobil kimlikler veya kullanıcı kimlikleri gönderirken UserIdentifier kullanılır. Data Manager API, her veri türü için farklı alanlar içeren farklı bir yaklaşım kullanır.

Data Manager API'de, gönderdiğiniz veri türüne karşılık gelen alanı doldurun:

İletişim bilgileri

E-posta adresi, telefon numarası veya adres bilgileri gibi iletişim bilgileri kullanılıyorsa composite_data değerini, her bir iletişim bilgisi öğesi için user_data.user_identifiers içinde ayrı bir giriş içeren CompositeData olarak ayarlayın.

user_data hâlâ destekleniyor olsa da entegrasyonunuzun gelecekteki iyileştirmelere hazır olmasını sağlamak için composite_data kullanmanızı öneririz. Ayrıntılar için Bileşik veriler bölümüne bakın.

UserIdentifier (Google Ads API) UserIdentifier (Data Manager API) Notlar
address_info address Ayrıntılar için Adres 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. Ayrıca, karma oluşturma işlemi uygulanmış telefon numarasını şifreleyebilirsiniz.
user_identifier_source Eşdeğeri yok.

Adres alanları

Google Ads API'deki OfflineUserAddressInfo ile Data Manager API'deki AddressInfo arasındaki alan eşlemeleri aşağıda verilmiştir. Müşteri Eşleştirme kitlenizi doldurmak için iletişim bilgilerini kullanıyorsanız bu eşlemeleri kullanın.

OfflineUserAddressInfo (Google Ads API) AddressInfo (Data Manager API) Notlar
city Eşdeğeri yok.
country_code region_code Zorunlu
hashed_first_name given_name

Zorunlu. Biçimlendirilmiş ve karma oluşturma işlemi uygulanmış adı girin. Karma oluşturma işlemi uygulanmış adı şifreleyebilirsiniz.
hashed_last_name family_name

Zorunlu. Biçimlendirilmiş ve karma oluşturma işlemi uygulanmış soyadı olarak ayarlanır. Karma oluşturma işlemi uygulanmış soyadını şifreleyebilirsiniz.
hashed_street_address Eşdeğeri yok.
postal_code postal_code Zorunlu
state Eşdeğeri yok.

IP adresi

Data Manager API, Müşteri Eşleştirme yüklemeleri için kullanıcı kimliklerinin yanı sıra IP adreslerinin de eklenmesini destekler. Bunlar, UserData ve IpData'yi bir araya getiren CompositeData'da sağlanır. Bu alanları birlikte sağlamak, eşleşme oranlarını artırmaya yardımcı olabilir.

Daha fazla bilgi için Müşteri Eşleştirme için IP kullanımı başlıklı makaleyi inceleyin.

Google Ads API CompositeData (Data Manager API) Notlar
Eşdeğeri yok. ip_data.ip_address Ham IPv4 veya IPv6 adresine ayarlanır. IP adresi biçimi ile ilgili kılavuza bakın.
Eşdeğeri yok. ip_data.observe_start_time IP adresinin ilk kez gözlemlendiği zaman damgası RFC 3339 biçiminde ayarlanır.
Eşdeğeri yok. ip_data.observe_end_time IP adresinin en son gözlemlendiği zaman damgası RFC 3339 biçiminde ayarlanır.
user_identifiers user_data UserData nesnesine ayarlanır.

Mobile ID'ler

Mobil kimlikler kullanılıyorsa mobile_data değerini, her kimlik için mobile_ids içinde bir giriş içeren MobileData olarak ayarlayın.

UserIdentifier (Google Ads API) MobileData (Data Manager API) Notlar
mobile_id mobile_ids Kitle üyesinin Mobile ID'leri listesine ayarlanır.

Google Ads API'de, kitle üyesinin her mobil kimliği için mobile_id içeren ayrı bir UserIdentifier eklersiniz. Data Manager API'de, kitle üyesinin tüm Mobile ID'lerinin listesine ayarlanmış mobile_ids ile tek bir MobileData ekleyin.

user_identifier_source Eşdeğeri yok.

User ID'ler

Kullanıcı kimlikleri kullanıyorsanız user_id_data değerini UserIdData olarak, user_id değerini ise kitle üyesinin kullanıcı kimliği olarak ayarlayın.

UserIdentifier (Google Ads API) UserIdData (Data Manager API) Notlar
third_party_user_id user_id

Google Ads API'de, kitle üyesinin her kullanıcı kimliği için third_party_user_id içeren ayrı bir UserIdentifier eklersiniz.

Data Manager API'de user_id_data alanını UserIdData olarak, user_id alanını ise kitle üyesinin kullanıcı kimliği olarak ayarlayın. Aynı kitle üyesi için birden fazla kullanıcı kimliği gönderemezsiniz.

user_identifier_source Eşdeğeri yok.
Önceki
Yükseltme adımları