Utilizza le mappature nelle tabelle per mappare i metodi e i campi di gestione dei segmenti di pubblico Customer Match nell'API Display & Video 360 ai loro equivalenti nell'API Data Manager.
Autenticazione
L'API Data Manager richiede credenziali con un ambito diverso rispetto all'API Display & Video 360. Segui i passaggi descritti in Configura l'accesso API per generare nuove credenziali che includono l'ambito dell'API Data Manager.
Mappatura dei metodi
La tabella seguente mappa i metodi dell'API Display & Video 360 ai metodi equivalenti dell'API Data Manager:
| Metodi dell'API Display & Video 360 | Metodi dell'API Data Manager | Note |
|---|---|---|
firstPartyAndPartnerAudiences.get |
userLists.get |
L'API Data Manager può recuperare solo i segmenti di pubblico Customer Match. |
firstPartyAndPartnerAudiences.list |
userLists.list |
L'API Data Manager restituirà solo i segmenti di pubblico Customer Match. |
firstPartyAndPartnerAudiences.create |
userLists.create |
I dati utente devono essere caricati in una richiesta successiva nell'API Data Manager. |
| Nessun equivalente | userLists.delete |
Non disponibile nell'API Display & Video 360. |
firstPartyAndPartnerAudiences.patch |
userLists.patch |
|
firstPartyAndPartnerAudiences.editCustomerMatchMembers |
audienceMembers.ingest |
Per aggiungere e rimuovere membri dai segmenti di pubblico Customer Match, vengono utilizzati metodi dell'API Data Manager separati. |
firstPartyAndPartnerAudiences.editCustomerMatchMembers |
audienceMembers.remove |
Per aggiungere e rimuovere membri dai segmenti di pubblico Customer Match, vengono utilizzati metodi dell'API Data Manager separati. |
| Nessun equivalente. | audienceMembers.removeAll |
L'API Data Manager supporta la rimozione di tutti i membri di un segmento di pubblico con una singola richiesta. |
Mappatura della richiesta
Le seguenti tabelle mappano i campi di richiesta dei metodi dell'API Display & Video 360 ai loro equivalenti nell'API Data Manager.
userLists.get
firstPartyAndPartnerAudiences.get (API di Display & Video 360) |
userLists.get (API Data Manager) |
Note |
|---|---|---|
|
name |
Il nome UserList contiene sia l'ID dell'inserzionista o del partner principale sia l'ID segmento di pubblico. Per maggiori dettagli, consulta Nomi delle risorse. |
userLists.list
firstPartyAndPartnerAudiences.list (API di Display & Video 360) |
userLists.list (API Data Manager) |
Note |
|---|---|---|
|
parent |
parent contiene l'ID dell'inserzionista o del partner principale. |
pageSize |
pageSize |
La dimensione massima della pagina nell'API Data Manager è 1000. |
pageToken |
pageToken |
|
filter |
filter |
|
orderBy |
Nessun equivalente |
userLists.create
firstPartyAndPartnerAudiences.create (API di Display & Video 360) |
userLists.create (API Data Manager) |
Note |
|---|---|---|
|
parent |
parent contiene l'ID dell'inserzionista o del partner principale del nuovo segmento di pubblico. |
| Nessun equivalente | validateOnly |
|
Corpo della richiesta FirstPartyAndPartnerAudience |
Corpo della richiesta UserList |
Consulta UserList per la mappatura del corpo della richiesta. |
userLists.update
firstPartyAndPartnerAudiences.patch (API di Display & Video 360) |
userLists.patch (API Data Manager) |
Note |
|---|---|---|
|
Parametro userList.name |
Il nome della risorsa di UserList da aggiornare. |
updateMask |
updateMask |
Questo campo è consigliato, ma non obbligatorio nell'API Data Manager e, se lasciato vuoto, comporterà la sostituzione completa di tutti i campi inclusi. |
| Nessun equivalente | validateOnly |
|
Corpo della richiesta FirstPartyAndPartnerAudience |
Corpo della richiesta UserList |
Consulta UserList per la mappatura del corpo della richiesta. |
audienceMembers.ingest
firstPartyAndPartnerAudiences.editCustomerMatchMembers (API di Display & Video 360) |
audienceMembers.ingest (API Data Manager) |
Note |
|---|---|---|
|
destinations |
Per maggiori dettagli, consulta Configura le destinazioni. |
addedContactInfoList.contactInfos |
audienceMembers |
Gli identificatori dei singoli utenti possono essere impostati nel campo compositeData.userData all'interno degli oggetti AudienceMember. Per maggiori dettagli, consulta Identificatori degli utenti. |
addedContactInfoList.consent |
consent |
Il consenso può essere impostato anche in singoli oggetti AudienceMember. |
addedMobileDeviceIdList.mobileDeviceIds |
audienceMembers |
I singoli ID dispositivo mobile sono impostati nel campo mobileData all'interno degli oggetti AudienceMember. |
addedMobileDeviceIdList.consent |
consent |
Il consenso può essere impostato anche in singoli oggetti AudienceMember. |
| Nessun equivalente | validateOnly |
|
| Nessun equivalente | encoding |
Obbligatorio. Impostato sul valore Encoding utilizzato per i valori UserIdentifier. |
| Nessun equivalente | encryptionInfo |
Imposta se la richiesta contiene valori criptati. Per maggiori dettagli, consulta Crittografia. |
| Nessun equivalente | termsOfService |
Required. Impostato per indicare che l'utente ha accettato o rifiutato i Termini di servizio di Customer Match. |
audienceMembers.remove
firstPartyAndPartnerAudiences.editCustomerMatchMembers (API di Display & Video 360) |
audienceMembers.remove (API Data Manager) |
Note |
|---|---|---|
|
destinations |
|
removedContactInfoList.contactInfos |
audienceMembers |
Gli identificatori dei singoli utenti possono essere impostati nel campo compositeData.userData all'interno degli oggetti AudienceMember. Per maggiori dettagli, consulta Identificatori degli utenti. |
removedMobileDeviceIdList.mobileDeviceIds |
audienceMembers |
I singoli ID dispositivo mobile sono impostati nel campo mobileData all'interno degli oggetti AudienceMember. |
| Nessun equivalente | validateOnly |
|
| Nessun equivalente | encoding |
Required. Impostato sul valore Encoding utilizzato per i valori UserIdentifier. |
| Nessun equivalente | encryptionInfo |
Imposta se la richiesta contiene valori criptati. Per maggiori dettagli, consulta Crittografia. |
Mappature dei campi degli oggetti
Di seguito sono riportate le mappature dagli oggetti dell'API Display & Video 360 agli oggetti equivalenti nell'API Data Manager.
UserList
FirstPartyAndPartnerAudience (API di Display & Video 360) |
UserList (API Data Manager) |
Note |
|---|---|---|
name |
name |
Utilizza un formato del nome della risorsa diverso. Per maggiori dettagli, consulta Nomi delle risorse. |
firstPartyAndPartnerAudienceId |
id |
|
| Nessun equivalente | readOnly |
|
displayName |
displayName |
|
description |
description |
|
| Nessun equivalente | membershipStatus |
|
| Nessun equivalente | integrationCode |
|
membershipDurationDays |
membershipDuration |
|
| Nessun equivalente | closingReason |
|
| Nessun equivalente | accessReason |
|
| Nessun equivalente | accountAccessStatus |
|
displayAudienceSize |
sizeInfo.displayNetworkMembersCount |
|
| Nessun equivalente | sizeInfo.searchNetworkMembersCount |
|
| Nessun equivalente | targetNetworkInfo |
|
| Nessun equivalente | ingestedUserListInfo |
|
firstPartyAndPartnerAudienceType |
Nessun equivalente | |
audienceType |
Nessun equivalente | |
audienceSource |
Nessun equivalente | |
activeDisplayAudienceSize |
Nessun equivalente | |
youtubeAudienceSize |
Nessun equivalente | |
gmailAudienceSize |
Nessun equivalente | |
displayMobileAppAudienceSize |
Nessun equivalente | |
displayMobileWebAudienceSize |
Nessun equivalente | |
displayDesktopAudienceSize |
Nessun equivalente | |
appId |
ingestedUserListInfo.mobileIdInfo.appId |
|
contactInfoList |
Metodi audienceMembers |
Nell'API Data Manager, aggiungi e rimuovi i membri utilizzando i metodi ingest, remove e removeAll di audienceMembers.
|
mobileDeviceIdList |
Metodi audienceMembers |
Nell'API Data Manager, aggiungi e rimuovi i membri utilizzando i metodi ingest, remove e removeAll di audienceMembers.
|
Nomi delle risorse
L'API Data Manager utilizza un formato del nome della risorsa diverso rispetto all'API Display & Video 360.
- API Display & Video 360
Nell'API Display & Video 360, il nome di una risorsa
UserListutilizza un formato che contiene solo l'ID segmento di pubblico:firstAndThirdPartyAudiences/{first_and_third_party_audience_id}- API Data Manager
Nell'API Data Manager, un nome della risorsa
UserListutilizza un formato che contiene l'ID segmento di pubblico, nonché l'IDAccountTypee l'ID account del partner o dell'inserzionista proprietario del segmento di pubblico:accountTypes/{accountType}/accounts/{account}/userLists/{userList}
Identificatori degli utenti
Anche se userData è ancora supportato, ti consigliamo di utilizzare compositeData per assicurarti che la tua integrazione sia pronta per i miglioramenti futuri. Per maggiori dettagli, consulta Dati compositi.
ContactInfo (API di Display & Video 360) |
CompositeData (API Data Manager) |
Note |
|---|---|---|
hashedEmails |
userData.userIdentifiers.emailAddress |
Imposta l'indirizzo email formattato e sottoposto ad hashing. Puoi anche criptare l'indirizzo email sottoposto ad hashing. È possibile utilizzare più indirizzi email per trovare una corrispondenza con un singolo utente utilizzando più oggetti UserIdentifier. |
hashedPhoneNumbers |
userData.userIdentifiers.phoneNumber |
Imposta il numero di telefono formattato e sottoposto ad hashing. Puoi anche criptare il numero di telefono sottoposto ad hashing. È possibile utilizzare più numeri di telefono per trovare una corrispondenza con un singolo utente utilizzando più oggetti UserIdentifier. |
hashedFirstName |
userData.userIdentifiers.address.givenName |
Imposta il nome formattato e sottoposto ad hashing. Puoi anche criptare il nome sottoposto ad hashing. |
hashedLastName |
userData.userIdentifiers.address.familyName |
Imposta il cognome formattato e sottoposto ad hashing. Puoi anche criptare il cognome sottoposto ad hashing. |
countryCode |
userData.userIdentifiers.address.regionCode |
|
zipCodes |
userData.userIdentifiers.address.postalCode |
È possibile utilizzare più codici postali per trovare una corrispondenza con un singolo utente utilizzando più oggetti UserIdentifier. |
Destinazione
| API Display & Video 360 | Destination (API Data Manager) |
Note |
|---|---|---|
| L'ID dell'inserzionista o del partner a cui è stato concesso l'accesso all'utente di Display & Video 360. | loginAccount |
Questo deve essere impostato solo in uno scenario di accesso partner Display & Video 360, in cui il segmento di pubblico è associato a un inserzionista, ma all'utente Display & Video 360 che accede è stato concesso l'accesso al partner principale dell'inserzionista. In caso contrario, può essere lasciato non impostato. |
| L'ID dell'inserzionista o del partner principale del segmento di pubblico. | operatingAccount |
|
firstPartyAndPartnerAudienceId |
productDestinationId |
|
| Nessun equivalente | reference |