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

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 (Data Manager API) Notlar
resource_name name Ayrıntılar için Kaynak adları başlıklı makaleyi inceleyin.
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 Timestamp 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 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 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 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, bir 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 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_ID içeren bir listeye ayarlayın. Bu, Google Ads API'de upload_key_type öğesini 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 ayarlamaya eşdeğerdir.

Mobil kimlikler

upload_key_types
MOBILE_ID içeren bir listeye ayarlayın. Bu, Google Ads API'de upload_key_type öğesini 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 için bu değer gereklidir. Bu, anahtar alanının app_id öğesinden çıkarıldığı Google Ads API'den farklıdır.
  • app_id değerini, verilerin toplandığı mobil uygulamayı benzersiz şekilde tanımlayan dize olarak 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 ayarlayın. Bu, Google Ads API'de upload_key_type öğesini 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 ayarlamaya 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

Tablolardaki eşlemeleri kullanarak Google Ads API'deki bir AddOfflineUserDataJobOperationsRequest öğesini Data Manager API'deki eşdeğer IngestionService isteğiyle eşleyin.

İstek alanları

Bu eşlemelerde, Veri Yöneticisi API'sindeki IngestAudienceMembersRequest referans olarak kullanılır. Ancak Google Ads API isteğinizi RemoveAudienceMembersRequest veya RemoveAllAudienceMembersRequest'ye dönüştürüyorsanız bu eşlemeleri de kullanabilirsiniz.

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ı bölümünü inceleyin.
customer_match_user_list_metadata OfflineUserDataJob consent 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 Yanıtla döndürülen request_id değerini kullanarak teşhis bilgilerini alın.
enable_partial_failure Eşdeğeri yok Data Manager API, hızlı hata (fast-fail) hata modelini kullanır. Bir IngestAudienceMembersRequest alanının herhangi bir kısmı doğrulanamazsa Data Manager API, isteğin tamamını reddeder. Teşhis aracını 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ı alma.
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, her iş için yalnızca bir kitleye kitle üyelerinin yüklenmesini 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. Ayrıca, istek başlıkları yerine Destination alanlarını kullanarak giriş ve bağlı müşteri bilgilerini belirtirsiniz. Hedefler hakkında daha fazla bilgi için Hedefleri yapılandırma başlıklı makaleyi inceleyin.

Google Ads API'de, bir OfflineUserDataJobOperation öğesinin 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'daki eşdeğer alanlarla nasıl eşleyeceğinizi aşağıda bulabilirsiniz:

Google Ads API Destination (Data Manager API) Notlar
customer_id isteği 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 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, 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.
OfflineUserDataJob customer_match_user_list_metadata'nın 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.

İşlem alanları

Data Manager API'sinde kitle üyelerini eklemek ve kaldırmak için ayrı yöntemler bulunur. Buna karşılık, Google Ads API'deki AddOfflineUserDataJobOperationsRequest, her biri işlem türüne bağlı olarak üye ekleyen, üye kaldıran veya tüm üyeleri kaldıran operations listesini içerir. Her işlem türünün Data Manager API'deki karşılık gelen yöntemiyle eşlemesi 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üne bakın.
remove RemoveAudienceMembers Ayrıntılar için Kitle üyesi alanları bölümüne bakın.
remove_all RemoveAllAudienceMembers Ayrıntılı bilgi için Tüm kitle üyelerini kaldırma başlıklı makaleyi inceleyin.

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ü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_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ı tanımlayıcısı alanları başlıklı makaleyi inceleyin.

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

Google Ads API'de iletişim bilgileri, mobil kimlikler veya kullanıcı kimlikleri gönderirken UserIdentifier kullanırsınız. Veri Yöneticisi API'si, 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, her 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 başlıklı makaleyi inceleyin.

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şturulmuş e-posta adresini şifreleyebilirsiniz.
hashed_phone_number phone_number Biçimlendirilmiş ve karma oluşturulmuş telefon numarası olarak ayarlayın. Dilerseniz 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 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. Belirtilen ad biçimlendirilmiş ve karma oluşturulmuş olarak ayarlanır. Ayrıca, karma oluşturma işlemi uygulanmış verilen adı şifreleyebilirsiniz.
hashed_last_name family_name

Zorunlu. Biçimlendirilmiş ve karma oluşturulmuş aile adı 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 Zorunlu
state Eşdeğeri yok.

IP adresi

Data Manager API, kullanıcı tanımlayıcıların yanı sıra Müşteri Eşleştirme yüklemeleri için IP adreslerinin eklenmesini destekler. Bunlar, UserData ve IpData'ı içeren 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 alı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 yönergelere bakın.
Eşdeğeri yok. ip_data.observe_start_time IP adresinin ilk kez gözlemlendiği zamana RFC 3339 biçiminde ayarlanır.
Eşdeğeri yok. ip_data.observe_end_time IP adresinin en son gözlemlendiği RFC 3339 biçimindeki zaman damgası olarak ayarlanır.
user_identifiers user_data UserData nesnesine ayarlanır.

Mobil kimlikler

Mobil kimlikler kullanılıyorsa mobile_data, her kimlik için mobile_ids içinde bir girişle MobileData olarak ayarlanı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 listesine ayarlanmış mobile_ids ile MobileData tek bir öğe 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'sinde, kitle üyesinin her kullanıcı kimliği için third_party_user_id ile ayrı bir UserIdentifier eklersiniz.

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ı