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:

Kitle yönetimi alanı eşlemeleri

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

UserList (Google Ads API) UserList (Veri Yöneticisi API'si) 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 eklendikten sonra listede kalma süresi. Değer tam günlere karşılık gelmelidir. Ayarlanmamışsa 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. Beden bilgileri için size_info.display_network_members_count özelliğini kullanın.
size_for_search size_info.search_network_members_count
size_range_for_search Eşdeğeri yok. Beden bilgileri için size_info.search_network_members_count özelliğini 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 kitle bilgileri başlıklı makaleyi 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 kitle bilgileri

Google Ads API'de, Müşteri Eşleştirme kitlesi oluştururken crm_based_user_list alanı zorunludur.

Veri Yöneticisi API'sinde, ingested_user_list_info alanını IngestedUserListInfo olarak ayarlayarak eşdeğer özellikleri belirleyin, ardından Müşteri Eşleştirme için gerekli alanları ve kullanıcı verilerinin türünü ayarlayın.

İletişim bilgileri

upload_key_types
CONTACT_INFO içeren bir listeye ayarlayın.
contact_id_info

ContactIdInfo olarak ayarlayın.

data_source_type değerini DATA_SOURCE_TYPE_FIRST_PARTY olarak ayarlayın.

Mobil kimlikler

upload_key_types
MOBILE_ID içeren bir listeye ayarlayın.
mobile_id_info

MobileIdInfo olarak ayarlayın.

  • data_source_type değerini DATA_SOURCE_TYPE_FIRST_PARTY olarak ayarlayın.
  • key_space öğesini IOS veya ANDROID olarak ayarlayın.
  • app_id değerini, verilerin toplandığı mobil uygulamayı benzersiz şekilde tanımlayan dize olarak ayarlayın. Google Ads API'de uygulama kimliği için kullandığınız biçimi kullanın.

User ID'ler

upload_key_types
USER_ID içeren bir listeye ayarlayın.
user_id_info

UserIdInfo olarak ayarlayın.

data_source_type değerini DATA_SOURCE_TYPE_FIRST_PARTY olarak ayarlayın.

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

Tablolardaki eşlemeleri kullanarak Google Ads API'deki AddOfflineUserDataJobOperationsRequest öğesini Data Manager API'deki IngestAudienceMembersRequest eşdeğeriyle eşleyin.

İstek alanları

AddOfflineUserDataJobOperationsRequest (Google Ads API) IngestAudienceMembersRequest (Data Manager API) Notlar
  • customer_id alanı
  • customer_match_user_list_metadata alanı OfflineUserDataJob
  • developer-token istek başlığı
  • login-customer_id istek başlığı
  • linked-customer-id istek başlığı
 destinations Müşteri ve kitle alanları başlıklı makaleyi inceleyin.
consent, customer_match_user_list_metadata OfflineUserDataJob consent İsteklerdeki kitle üyeleri için isteğe bağlı varsayılan izin ayarları. consent alanını AudienceMember olarak 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 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şhis bilgilerini almak için yanıtta döndürülen request_id değerini kullanın.
enable_partial_failure Eşdeğeri yok Veri Yöneticisi API, kısmi hatayı desteklemez. Bir IngestAudienceMembersRequest alanının herhangi biri doğrulama işleminde başarısız olursa Veri Yöneticisi API'si isteğin tamamını reddeder. Teşhis'i kullanarak işleme hatalarını alma.
enable_warnings Eşdeğeri yok Veri Yöneticisi API'si, yanıttaki uyarıları bildirmez. Teşhis aracını kullanarak işleme uyarılarını alın.
validate_only validate_only
operations audience_members Kitle üyelerinin listesi. Ayrıntılar için Kitle üyesi 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 üyeleri yüklemeyi destekler.Ayrıca developer-token istek üstbilgisilogin-customer-id gereklidir ve farklı kimlik doğrulama senaryoları için login-customer-id ve linked-customer-id istek üstbilgilerini 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.

Veri Yöneticisi API'si, bir kitlenin tüm üyelerinin kaldırılmasını desteklemez. Google Ads API'sinde, bir OfflineUserDataJobOperation öğesinin remove_all alanını true olarak ayarlayarak bir kitlenin tüm üyelerini kaldırabilirsiniz.

Tek bir kitle için Google Ads API alanlarını Destination'daki 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 kitlenin 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.
OfflineUserDataJob customer_match_user_list_metadata'ından 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ı tanımlı bir tanımlayıcı. Tek bir istekte birden fazla kitle için kitle üyeleri gönderiyorsanız bu alanı ayarlayı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.

Veri Yöneticisi API'si için istek düzeyinde consent alanını ayarlayarak bir istekteki tüm kitle üyeleri için de izni 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_id_data
  • user_id_data
  • user_identifiers

Kitle üyeleri için gönderdiğiniz veri türüne karşılık gelen alanı doldurun. Ayrıntılar için Kullanıcı tanımlayıcısı alanları başlıklı makaleyi inceleyin.

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

Google Ads API'sinde iletişim bilgileri, mobil kimlikler veya kullanıcı kimlikleri gönderirken UserIdentifier kullanırsınız. Veri Yöneticisi API'si ise farklı bir yaklaşım kullanır ve her veri türü için farklı alanlar içerir.

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 bilgilerini kullanıyorsanız user_data değerini, her iletişim bilgisi öğesi için user_identifiers içinde ayrı bir giriş içeren UserData olarak ayarlayı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ş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şturulmuş telefon numarası olarak ayarlanır. Ayrıca karma oluşturma işlemi uygulanmış telefon numarasını da şifreleyebilirsiniz.
user_identifier_source Eşdeğeri yok.

Adres alanları

Google Ads API'deki OfflineUserAddressInfo ile Veri Yöneticisi 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
hashed_first_name given_name

Verilen adı biçimlendirilmiş ve karma oluşturulmuş olarak ayarlayın. Ayrıca, karma oluşturma işlemi uygulanmış verilen adı şifreleyebilirsiniz.
hashed_last_name family_name

Biçimlendirilmiş ve karma oluşturulmuş soyadı olarak ayarlayın. Ayrıca, karma oluşturma işlemi uygulanmış aile adını şifreleyebilirsiniz.
hashed_street_address Eşdeğeri yok.
postal_code postal_code
state Eşdeğeri yok.

Mobil kimlikler

Mobil kimlikler kullanılıyorsa mobile_data, her kimlik için mobile_ids içinde bir girişle MobileData olarak ayarlanmalıdır.

UserIdentifier (Google Ads API) MobileData (Data Manager API) Notlar
mobile_id mobile_ids Kitle üyesinin mobil kimlikleri listesine ayarlanır.

Google Ads API'de, kitle üyesinin her mobil kimliği için mobile_id ile ayrı bir UserIdentifier ekliyorsunuz. Data Manager API'de, kitle üyesinin tüm mobil kimliklerinin listesi mobile_ids olarak ayarlanmış MobileData ile tek bir MobileData ekleyin.

user_identifier_source Eşdeğeri yok.

User ID'ler

Kullanıcı kimlikleri kullanılıyorsa 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 ile ayrı bir UserIdentifier ekliyorsunuz.

Veri Yöneticisi API'sinde 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ı