Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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.

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 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 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 API Display & Video 360 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 untuk peningkatan pada masa mendatang. Lihat Data komposit 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, saat 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 ditetapkan.
ID pengiklan atau partner induk audiens.	`operatingAccount`
`firstPartyAndPartnerAudienceId`	`productDestinationId`
Tidak ada ekuivalen	`reference`

Sebelumnya

Langkah-langkah untuk mengupgrade