Pemetaan kolom

Gunakan pemetaan kolom untuk meng-upgrade setiap langkah alur kerja Customer Match dari Google Ads API ke Data Manager API:

Pemetaan kolom pengelolaan audiens

Gunakan pemetaan dalam tabel untuk memetakan UserList di Google Ads API ke UserList yang setara di Data Manager API.

UserList (Google Ads API) UserList (Data Manager API) Catatan
resource_name name Lihat Nama resource untuk mengetahui detailnya.
id id
read_only read_only
name display_name Wajib
description description Wajib
membership_status membership_status
integration_code integration_code
membership_life_span membership_duration

Durasi anggota audiens tetap berada dalam daftar setelah ditambahkan. Nilai harus sesuai dengan hari penuh. Jika tidak ditetapkan, nilai defaultnya adalah maksimum.

Format nilai menggunakan Timestamp format.
size_for_display size_info.display_network_members_count
size_range_for_display Tidak ada ekuivalen. Gunakan size_info.display_network_members_count untuk informasi ukuran.
size_for_search size_info.search_network_members_count
size_range_for_search Tidak ada ekuivalen. Gunakan size_info.search_network_members_count untuk informasi ukuran.
type Tidak ada ekuivalen.
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 Tidak digunakan untuk Customer Match.
crm_based_user_list ingested_user_list_info Wajib. Lihat informasi audiens Customer Match.
Tidak ada ekuivalen. ingested_user_list_info.pair_id_info Tidak digunakan untuk Customer Match.
Tidak ada ekuivalen. ingested_user_list_info.partner_audience_info Tidak digunakan untuk Customer Match.
logical_user_list Tidak ada ekuivalen. Tidak digunakan untuk Customer Match.
logical_user_list Tidak ada ekuivalen. Tidak digunakan untuk Customer Match.
lookalike_user_list Tidak ada ekuivalen. Tidak digunakan untuk Customer Match.
rule_based_user_list Tidak ada ekuivalen. Tidak digunakan untuk Customer Match.
similar_user_list Tidak ada ekuivalen. Tidak digunakan untuk Customer Match.

Informasi audiens Customer Match

Di Google Ads API, kolom crm_based_user_list wajib diisi saat membuat audiens Customer Match.

Di Data Manager API, tetapkan atribut yang setara dengan menetapkan kolom ingested_user_list_info ke IngestedUserListInfo, lalu tetapkan kolom yang diperlukan untuk Customer Match dan jenis data pengguna.

Informasi kontak

upload_key_types
Disetel ke daftar yang berisi CONTACT_INFO.
contact_id_info

Tetapkan ke ContactIdInfo.

Tetapkan data_source_type ke DATA_SOURCE_TYPE_FIRST_PARTY.

ID Seluler

upload_key_types
Disetel ke daftar yang berisi MOBILE_ID.
mobile_id_info

Tetapkan ke MobileIdInfo.

  • Tetapkan data_source_type ke DATA_SOURCE_TYPE_FIRST_PARTY.
  • Tetapkan key_space ke IOS atau ANDROID.
  • Tetapkan app_id ke string yang secara unik mengidentifikasi aplikasi seluler tempat data dikumpulkan. Gunakan format yang sama dengan yang Anda gunakan untuk ID aplikasi di Google Ads API.

ID pengguna

upload_key_types
Disetel ke daftar yang berisi USER_ID.
user_id_info

Tetapkan ke UserIdInfo.

Tetapkan data_source_type ke DATA_SOURCE_TYPE_FIRST_PARTY.

Nama resource

Data Manager API menggunakan format nama resource yang berbeda dengan Google Ads API.

Google Ads API

Di Google Ads API, nama resource UserList menggunakan format:

customers/{customer_id}/userLists/{user_list_id}

Data Manager API

Di Data Manager API, nama resource UserList menggunakan format:

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

Mengupload pemetaan kolom

Gunakan pemetaan dalam tabel untuk memetakan AddOfflineUserDataJobOperationsRequest di Google Ads API ke IngestAudienceMembersRequest yang setara di Data Manager API.

Kolom permintaan

AddOfflineUserDataJobOperationsRequest (Google Ads API) IngestAudienceMembersRequest (Data Manager API) Catatan
  • Kolom customer_id
  • Kolom customer_match_user_list_metadata dari OfflineUserDataJob
  • Header permintaan developer-token
  • Header permintaan login-customer_id
  • Header permintaan linked-customer-id
 destinations Lihat Kolom pelanggan dan audiens.
consent dari customer_match_user_list_metadata OfflineUserDataJob consent Setelan izin default opsional untuk anggota audiens dalam permintaan. Anda dapat mengganti nilai ini untuk setiap anggota audiens dengan menetapkan kolom consent dari AudienceMember.
Tidak ada ekuivalen encoding Wajib: Ditetapkan ke Encoding yang digunakan untuk nilai UserIdentifier.
Tidak ada ekuivalen encryption_info Tetapkan apakah permintaan berisi nilai terenkripsi. Lihat Enkripsi untuk mengetahui detailnya.
job_id Tidak ada ekuivalen Gunakan request_id yang ditampilkan dalam respons untuk mengambil diagnostik.
enable_partial_failure Tidak ada ekuivalen API Pengelola Data tidak mendukung kegagalan sebagian. Jika ada kolom IngestAudienceMembersRequest yang gagal divalidasi, Data Manager API akan menolak seluruh permintaan. Mengambil error pemrosesan menggunakan diagnostik.
enable_warnings Tidak ada ekuivalen Data Manager API tidak melaporkan peringatan dalam respons. Mengambil peringatan pemrosesan menggunakan diagnostik.
validate_only validate_only
operations audience_members Daftar anggota audiens. Lihat bagian kolom anggota Audiens untuk mengetahui detailnya.
Tidak ada ekuivalen terms_of_service Wajib. Disetel untuk menunjukkan bahwa pengguna telah menyetujui atau menolak persyaratan layanan untuk Customer Match.

Kolom pelanggan dan audiens

Google Ads API hanya mendukung upload anggota audiens ke satu audiens per tugas.Selain itu, header permintaan developer-token diperlukan, dan Anda menetapkan header permintaan login-customer-id dan linked-customer-id untuk berbagai skenario autentikasi.

Data Manager API mendukung pengiriman anggota audiens untuk beberapa audiens dalam satu permintaan. Data Manager API tidak memerlukan token developer, dan Anda menentukan informasi login dan pelanggan tertaut menggunakan kolom Destination, bukan header permintaan. Lihat Mengonfigurasi tujuan untuk mengetahui informasi selengkapnya tentang tujuan.

API Pengelola Data tidak mendukung penghapusan semua anggota audiens. Di Google Ads API, Anda dapat menghapus semua anggota audiens dengan menyetel kolom remove_all dari OfflineUserDataJobOperation ke true.

Berikut cara memetakan kolom Google Ads API untuk satu audiens ke kolom yang setara di Destination:

Google Ads API Destination (Data Manager API) Catatan
customer_id permintaan operating_account Setel account_id ke ID pelanggan audiens. Tetapkan account_type dari operating_account ke GOOGLE_ADS.
Header permintaan developer-token Tidak ada ekuivalen Token developer tidak diperlukan untuk Data Manager API.
Header permintaan login-customer-id login_account Tetapkan account_id ke ID pelanggan akun login. Tetapkan account_type ke GOOGLE_ADS jika akun login adalah akun Google Ads, atau DATA_PARTNER jika akun login adalah akun partner data.
Header permintaan linked-customer-id linked_account Setel account_id ke ID pelanggan akun yang ditautkan. Setel account_type ke DATA_PARTNER.
user_list dari customer_match_user_list_metadata OfflineUserDataJob product_destination_id Wajib. Disetel ke ID numerik audiens. Jangan gunakan nama resource UserList.
Tidak ada ekuivalen reference ID yang ditentukan pengguna untuk Destination. Tetapkan kolom ini jika Anda mengirim anggota audiens untuk beberapa audiens dalam satu permintaan.

Kolom anggota audiens

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

Disetel untuk menentukan izin bagi anggota audiens.

Kedua API menggunakan objek Consent yang serupa (ad_user_data, ad_personalization).

Untuk Data Manager API, Anda juga dapat menyetel izin untuk semua anggota audiens dalam permintaan dengan menyetel kolom consent tingkat permintaan.
transaction_attribute Tidak ada ekuivalen. Tidak berlaku untuk Customer Match.
user_attribute Tidak ada ekuivalen. Tidak berlaku untuk Customer Match.
user_identifiers
  • mobile_id_data
  • user_id_data
  • user_identifiers

Isi kolom yang sesuai dengan jenis data yang Anda kirim untuk anggota audiens. Lihat Kolom ID pengguna untuk mengetahui detailnya.

Kolom ID pengguna

Di Google Ads API, baik Anda mengirimkan informasi kontak, ID seluler, atau ID pengguna, Anda menggunakan UserIdentifier. Data Manager API menggunakan pendekatan yang berbeda, dengan kolom yang berbeda untuk setiap jenis data.

Di Data Manager API, isi kolom yang sesuai dengan jenis data yang Anda kirim:

Informasi kontak

Jika menggunakan informasi kontak seperti alamat email, nomor telepon, atau informasi alamat, tetapkan user_data ke UserData dengan entri terpisah di user_identifiers untuk setiap item informasi kontak.

UserIdentifier (Google Ads API) UserIdentifier (Data Manager API) Catatan
address_info address Lihat Kolom alamat untuk mengetahui detailnya.
hashed_email email_address Disetel ke alamat email yang diformat dan di-hash. Anda juga dapat mengenkripsi alamat email yang di-hash.
hashed_phone_number phone_number Disetel ke nomor telepon yang diformat dan di-hash. Anda juga dapat mengenkripsi nomor telepon yang di-hash.
user_identifier_source Tidak ada ekuivalen.

Kolom alamat

Berikut pemetaan kolom antara OfflineUserAddressInfo di Google Ads API dan AddressInfo di Data Manager API. Gunakan pemetaan ini jika Anda menggunakan informasi kontak untuk mengisi audiens Customer Match.

OfflineUserAddressInfo (Google Ads API) AddressInfo (Data Manager API) Catatan
city Tidak ada ekuivalen.
country_code region_code
hashed_first_name given_name

Ditetapkan ke nama depan yang diformat dan di-hash. Anda juga dapat mengenkripsi nama yang diberikan yang di-hash.
hashed_last_name family_name

Ditetapkan ke nama keluarga yang diformat dan di-hash. Anda juga dapat mengenkripsi nama keluarga yang di-hash.
hashed_street_address Tidak ada ekuivalen.
postal_code postal_code
state Tidak ada ekuivalen.

ID Seluler

Jika menggunakan ID seluler, tetapkan mobile_data ke MobileData dengan entri di mobile_ids untuk setiap ID.

UserIdentifier (Google Ads API) MobileData (Data Manager API) Catatan
mobile_id mobile_ids Disetel ke daftar ID seluler untuk anggota audiens.

Di Google Ads API, Anda menambahkan terpisah UserIdentifier dengan mobile_id untuk setiap ID seluler untuk anggota audiens. Di Data Manager API, tambahkan satu MobileData dengan mobile_ids ditetapkan ke daftar semua ID seluler untuk anggota audiens.

user_identifier_source Tidak ada ekuivalen.

ID pengguna

Jika menggunakan ID pengguna, tetapkan user_id_data ke UserIdData, dan tetapkan user_id ke ID pengguna untuk anggota audiens.

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

Di Google Ads API, Anda menambahkan terpisah UserIdentifier dengan third_party_user_id untuk setiap ID pengguna anggota audiens.

Di Data Manager API, tetapkan kolom user_id_data ke UserIdData, dan tetapkan kolom user_id-nya ke ID pengguna untuk anggota audiens. Anda tidak dapat mengirim beberapa ID pengguna untuk anggota audiens yang sama.

user_identifier_source Tidak ada ekuivalen.
Sebelumnya
Langkah-langkah untuk mengupgrade