Pemetaan kolom

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

Autentikasi

Data Manager API memerlukan kredensial dengan cakupan yang berbeda dari Display & Video 360 API. Ikuti langkah-langkah di Menyiapkan akses API untuk membuat kredensial baru yang mencakup 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.

Pemetaan permintaan

Tabel berikut memetakan kolom permintaan metode Display & Video 360 API ke kolom yang setara 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 dan 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 diupdate.
updateMask updateMask Kolom ini direkomendasikan, tetapi tidak wajib diisi di Data Manager API dan akan menghasilkan 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 Persetujuan juga dapat ditetapkan di setiap objek AudienceMember.
addedMobileDeviceIdList.mobileDeviceIds audienceMembers Setiap ID perangkat seluler ditetapkan di kolom mobileData dalam objek AudienceMember.
addedMobileDeviceIdList.consent consent Persetujuan 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 apakah permintaan berisi nilai terenkripsi. Lihat Enkripsi untuk mengetahui detailnya.
Tidak ada ekuivalen termsOfService Wajib diisi. Disetel 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 Setiap ID perangkat seluler 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 apakah 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 dari audienceMembers.
mobileDeviceIdList Metode audienceMembers Di Data Manager API, tambahkan dan hapus anggota menggunakan metode ingest dan remove 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}

Pengidentifikasi Pengguna

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

ContactInfo (Display & Video 360 API) CompositeData (Data Manager API) Catatan
hashedEmails userData.userIdentifiers.emailAddress Disetel 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 Disetel 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 Disetel ke nama depan yang diformat dan di-hash. Anda juga dapat mengenkripsi nama pemberian yang di-hash.
hashedLastName userData.userIdentifiers.address.familyName Disetel 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 dengan menggunakan beberapa objek UserIdentifier.

Destination

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