Pemetaan kolom

Gunakan pemetaan dalam tabel untuk memetakan metode dan kolom pengelolaan audiens Customer Match di Display & Video 360 API ke padanannya di Data Manager API.

Autentikasi

Data Manager API memerlukan kredensial dengan cakupan yang berbeda dari Display & Video 360 API. Ikuti langkah-langkah di bagian Menyiapkan akses API untuk membuat kredensial baru yang menyertakan cakupan Data Manager API.

Pemetaan metode

Tabel berikut memetakan metode Display & Video 360 API ke metode Data Manager API yang setara:

Metode Display & Video 360 API Metode Data Manager API Catatan
firstPartyAndPartnerAudiences.get userLists.get Data Manager API hanya dapat mengambil audiens Customer Match.
firstPartyAndPartnerAudiences.list userLists.list Data Manager API hanya akan menampilkan audiens Customer Match.
firstPartyAndPartnerAudiences.create userLists.create Data pengguna harus diupload dalam permintaan berikutnya di Data Manager API.
Tidak ada ekuivalen userLists.delete Tidak tersedia di Display & Video 360 API.
firstPartyAndPartnerAudiences.patch userLists.patch
firstPartyAndPartnerAudiences.editCustomerMatchMembers audienceMembers.ingest Metode Data Manager API yang terpisah digunakan untuk menambahkan dan menghapus anggota dari audiens Customer Match.
firstPartyAndPartnerAudiences.editCustomerMatchMembers audienceMembers.remove Metode Data Manager API yang terpisah digunakan untuk menambahkan dan menghapus anggota dari audiens Customer Match.
Tidak ada ekuivalen. audienceMembers.removeAll Data Manager API mendukung penghapusan semua anggota audiens dengan satu permintaan.

Pemetaan permintaan

Tabel berikut memetakan kolom permintaan metode Display & Video 360 API ke padanannya di Data Manager API.

userLists.get

firstPartyAndPartnerAudiences.get (Display & Video 360 API) userLists.get (Data Manager API) Catatan
  • advertiserId
  • partnerId
  • firstPartyAndPartnerAudienceId
 name Nama UserList berisi ID pengiklan atau partner induk serta ID audiens. Lihat Nama resource untuk mengetahui detailnya.

userLists.list

firstPartyAndPartnerAudiences.list (Display & Video 360 API) userLists.list (Data Manager API) Catatan
  • advertiserId
  • partnerId
 parent parent berisi ID pengiklan atau partner induk.
pageSize pageSize Ukuran halaman maksimum di Data Manager API adalah 1000.
pageToken pageToken
filter filter
orderBy Tidak ada ekuivalen

userLists.create

firstPartyAndPartnerAudiences.create (Display & Video 360 API) userLists.create (Data Manager API) Catatan
  • advertiserId
  • partnerId
 parent parent berisi ID pengiklan induk atau partner audiens baru.
Tidak ada ekuivalen validateOnly
Isi permintaan FirstPartyAndPartnerAudience Isi permintaan UserList Lihat UserList untuk pemetaan isi permintaan.

userLists.update

firstPartyAndPartnerAudiences.patch (Display & Video 360 API) userLists.patch (Data Manager API) Catatan
  • advertiserId
  • firstPartyAndPartnerAudienceId
 Parameter userList.name Nama resource UserList yang akan diperbarui.
updateMask updateMask Kolom ini direkomendasikan, tetapi tidak wajib di Data Manager API dan akan mengakibatkan penggantian penuh semua kolom yang disertakan jika dibiarkan kosong.
Tidak ada ekuivalen validateOnly
Isi permintaan FirstPartyAndPartnerAudience Isi permintaan UserList Lihat UserList untuk pemetaan isi permintaan.

audienceMembers.ingest

firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API) audienceMembers.ingest (Data Manager API) Catatan
  • advertiserId
  • firstPartyAndPartnerAudienceId
 destinations Lihat Mengonfigurasi tujuan untuk mengetahui detailnya.
addedContactInfoList.contactInfos audienceMembers ID pengguna individual dapat ditetapkan di kolom compositeData.userData dalam objek AudienceMember. Lihat ID Pengguna untuk mengetahui detailnya.
addedContactInfoList.consent consent Izin juga dapat ditetapkan di setiap objek AudienceMember.
addedMobileDeviceIdList.mobileDeviceIds audienceMembers ID perangkat seluler individual ditetapkan di kolom mobileData dalam objek AudienceMember.
addedMobileDeviceIdList.consent consent Izin juga dapat ditetapkan di setiap objek AudienceMember.
Tidak ada ekuivalen validateOnly
Tidak ada ekuivalen encoding Wajib. Tetapkan ke Encoding yang digunakan untuk nilai UserIdentifier.
Tidak ada ekuivalen encryptionInfo Tetapkan jika permintaan berisi nilai terenkripsi. Lihat Enkripsi untuk mengetahui detailnya.
Tidak ada ekuivalen termsOfService Wajib diisi. Ditetapkan untuk menunjukkan bahwa pengguna telah menyetujui atau menolak persyaratan layanan untuk Customer Match.

audienceMembers.remove

firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API) audienceMembers.remove (Data Manager API) Catatan
  • advertiserId
  • firstPartyAndPartnerAudienceId
 destinations
removedContactInfoList.contactInfos audienceMembers ID pengguna individual dapat ditetapkan di kolom compositeData.userData dalam objek AudienceMember. Lihat ID Pengguna untuk mengetahui detailnya.
removedMobileDeviceIdList.mobileDeviceIds audienceMembers ID perangkat seluler individual ditetapkan di kolom mobileData dalam objek AudienceMember.
Tidak ada ekuivalen validateOnly
Tidak ada ekuivalen encoding Wajib diisi. Tetapkan ke Encoding yang digunakan untuk nilai UserIdentifier.
Tidak ada ekuivalen encryptionInfo Tetapkan jika permintaan berisi nilai terenkripsi. Lihat Enkripsi untuk mengetahui detailnya.

Pemetaan kolom objek

Berikut adalah pemetaan dari objek Display & Video 360 API ke objek yang setara di Data Manager API.

UserList

FirstPartyAndPartnerAudience (Display & Video 360 API) UserList (Data Manager API) Catatan
name name Menggunakan format nama resource yang berbeda. Lihat Nama resource untuk mengetahui detailnya.
firstPartyAndPartnerAudienceId id
Tidak ada ekuivalen readOnly
displayName displayName
description description
Tidak ada ekuivalen membershipStatus
Tidak ada ekuivalen integrationCode
membershipDurationDays membershipDuration
Tidak ada ekuivalen closingReason
Tidak ada ekuivalen accessReason
Tidak ada ekuivalen accountAccessStatus
displayAudienceSize sizeInfo.displayNetworkMembersCount
Tidak ada ekuivalen sizeInfo.searchNetworkMembersCount
Tidak ada ekuivalen targetNetworkInfo
Tidak ada ekuivalen ingestedUserListInfo
firstPartyAndPartnerAudienceType Tidak ada ekuivalen
audienceType Tidak ada ekuivalen
audienceSource Tidak ada ekuivalen
activeDisplayAudienceSize Tidak ada ekuivalen
youtubeAudienceSize Tidak ada ekuivalen
gmailAudienceSize Tidak ada ekuivalen
displayMobileAppAudienceSize Tidak ada ekuivalen
displayMobileWebAudienceSize Tidak ada ekuivalen
displayDesktopAudienceSize Tidak ada ekuivalen
appId ingestedUserListInfo.mobileIdInfo.appId
contactInfoList Metode audienceMembers Di Data Manager API, tambahkan dan hapus anggota menggunakan metode ingest dan remove, serta removeAll dari audienceMembers.
mobileDeviceIdList Metode audienceMembers Di Data Manager API, tambahkan dan hapus anggota menggunakan metode ingest dan remove, serta removeAll dari audienceMembers.

Nama resource

Data Manager API menggunakan format nama resource yang berbeda dengan Display & Video 360 API.

Display & Video 360 API

Di Display & Video 360 API, nama resource UserList menggunakan format yang hanya berisi ID audiens:

firstAndThirdPartyAudiences/{first_and_third_party_audience_id}

Data Manager API

Di Data Manager API, nama resource UserList menggunakan format yang berisi ID audiens serta AccountType dan ID akun partner atau pengiklan yang memiliki audiens:

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

ID Pengguna

Meskipun userData masih didukung, sebaiknya gunakan compositeData untuk memastikan integrasi Anda siap untuk peningkatan di masa mendatang. Lihat Data gabungan untuk mengetahui detailnya.

ContactInfo (Display & Video 360 API) CompositeData (Data Manager API) Catatan
hashedEmails userData.userIdentifiers.emailAddress Tetapkan ke alamat email yang diformat dan di-hash. Anda juga dapat mengenkripsi alamat email yang di-hash. Beberapa email dapat digunakan untuk mencocokkan satu pengguna dengan menggunakan beberapa objek UserIdentifier.
hashedPhoneNumbers userData.userIdentifiers.phoneNumber Tetapkan ke nomor telepon yang diformat dan di-hash. Anda juga dapat mengenkripsi nomor telepon yang di-hash. Beberapa nomor telepon dapat digunakan untuk mencocokkan satu pengguna dengan menggunakan beberapa objek UserIdentifier.
hashedFirstName userData.userIdentifiers.address.givenName Tetapkan ke nama depan yang diformat dan di-hash. Anda juga dapat mengenkripsi nama depan yang di-hash.
hashedLastName userData.userIdentifiers.address.familyName Tetapkan ke nama keluarga yang diformat dan di-hash. Anda juga dapat mengenkripsi nama keluarga yang di-hash.
countryCode userData.userIdentifiers.address.regionCode
zipCodes userData.userIdentifiers.address.postalCode Beberapa kode pos dapat digunakan untuk mencocokkan satu pengguna menggunakan beberapa objek UserIdentifier.

Destination

Display & Video 360 API Destination (Data Manager API) Catatan
ID pengiklan atau partner yang dapat diakses oleh pengguna Display & Video 360. loginAccount Hal ini hanya perlu ditetapkan dalam skenario akses partner Display & Video 360, saat audiens berada di bawah pengiklan, tetapi pengguna Display & Video 360 yang mengakses telah diberi akses ke partner induk pengiklan. Jika tidak, kolom ini dapat dibiarkan tidak ditetapkan.
ID pengiklan induk atau partner audiens. operatingAccount
firstPartyAndPartnerAudienceId productDestinationId
Tidak ada ekuivalen reference
Sebelumnya
Langkah-langkah untuk mengupgrade