Mappature di campi

Utilizza i mapping nelle tabelle per mappare i metodi e i campi di gestione dei segmenti di pubblico Customer Match nell'API Display & Video 360 ai relativi 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 includano l'ambito dell'API Data Manager.

Mappatura dei metodi

La seguente tabella 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 API Data Manager separati.
firstPartyAndPartnerAudiences.editCustomerMatchMembers audienceMembers.remove Per aggiungere e rimuovere membri dai segmenti di pubblico Customer Match vengono utilizzati metodi API Data Manager separati.

Mappatura delle richieste

Le seguenti tabelle mappano i campi delle richieste dei metodi dell'API Display & Video 360 con i relativi equivalenti nell'API Data Manager.

userLists.get

firstPartyAndPartnerAudiences.get (API di Display & Video 360) userLists.get (API Data Manager) Note
  • advertiserId
  • partnerId
  • firstPartyAndPartnerAudienceId
 name Il nome UserList contiene sia l'ID dell'inserzionista o del partner principale sia l'ID pubblico. Per maggiori dettagli, vedi Nomi delle risorse.

userLists.list

firstPartyAndPartnerAudiences.list (API di Display & Video 360) userLists.list (API Data Manager) Note
  • advertiserId
  • partnerId
 parent parent contiene l'ID dell'inserzionista principale o del partner.
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
  • advertiserId
  • partnerId
 parent parent contiene l'ID dell'inserzionista principale o del partner del nuovo segmento di pubblico.
Nessun equivalente validateOnly
Corpo della richiesta FirstPartyAndPartnerAudience Corpo della richiesta UserList Per la mappatura del corpo della richiesta, consulta UserList.

userLists.update

firstPartyAndPartnerAudiences.patch (API di Display & Video 360) userLists.patch (API Data Manager) Note
  • advertiserId
  • firstPartyAndPartnerAudienceId
 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, comporta la sostituzione completa di tutti i campi inclusi.
Nessun equivalente validateOnly
Corpo della richiesta FirstPartyAndPartnerAudience Corpo della richiesta UserList Per la mappatura del corpo della richiesta, consulta UserList.

audienceMembers.ingest

firstPartyAndPartnerAudiences.editCustomerMatchMembers (API di Display & Video 360) audienceMembers.ingest (API Data Manager) Note
  • advertiserId
  • firstPartyAndPartnerAudienceId
 destinations Per maggiori dettagli, consulta Configurare le destinazioni.
addedContactInfoList.contactInfos audienceMembers Gli identificatori utente individuali possono essere impostati nel campo compositeData.userData all'interno degli oggetti AudienceMember. Per maggiori dettagli, consulta Identificatori utente.
addedContactInfoList.consent consent Il consenso può essere impostato anche nei singoli oggetti AudienceMember.
addedMobileDeviceIdList.mobileDeviceIds audienceMembers Gli ID dei singoli dispositivi mobili vengono impostati nel campo mobileData all'interno degli oggetti AudienceMember.
addedMobileDeviceIdList.consent consent Il consenso può essere impostato anche nei singoli oggetti AudienceMember.
Nessun equivalente validateOnly
Nessun equivalente encoding Obbligatorio. Imposta il valore su Encoding utilizzato per i valori UserIdentifier.
Nessun equivalente encryptionInfo Imposta se la richiesta contiene valori criptati. Per maggiori dettagli, vedi Crittografia.
Nessun equivalente termsOfService Required. Impostato per indicare che l'utente ha accettato o rifiutato i Termini di servizio per Customer Match.

audienceMembers.remove

firstPartyAndPartnerAudiences.editCustomerMatchMembers (API di Display & Video 360) audienceMembers.remove (API Data Manager) Note
  • advertiserId
  • firstPartyAndPartnerAudienceId
 destinations
removedContactInfoList.contactInfos audienceMembers Gli identificatori utente individuali possono essere impostati nel campo compositeData.userData all'interno degli oggetti AudienceMember. Per maggiori dettagli, consulta Identificatori utente.
removedMobileDeviceIdList.mobileDeviceIds audienceMembers Gli ID dei singoli dispositivi mobili vengono impostati nel campo mobileData all'interno degli oggetti AudienceMember.
Nessun equivalente validateOnly
Nessun equivalente encoding Required. Imposta il valore su Encoding utilizzato per i valori UserIdentifier.
Nessun equivalente encryptionInfo Imposta se la richiesta contiene valori criptati. Per maggiori dettagli, vedi Crittografia.

Mappature dei campi degli oggetti

Di seguito sono riportati i mapping degli 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, vedi 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 membri utilizzando i metodi ingest e remove di audienceMembers.
mobileDeviceIdList Metodi audienceMembers Nell'API Data Manager, aggiungi e rimuovi membri utilizzando i metodi ingest e remove 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 UserList utilizza un formato che contiene solo l'ID segmento di pubblico:

firstAndThirdPartyAudiences/{first_and_third_party_audience_id}

API Data Manager

Nell'API Data Manager, il nome di una risorsa UserList utilizza un formato che contiene l'ID segmento di pubblico, nonché l'AccountType e 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, consigliamo di utilizzare compositeData per assicurarti che l'integrazione sia pronta per i miglioramenti futuri. Per informazioni dettagliate, 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ù email per far corrispondere un singolo utente utilizzando più oggetti UserIdentifier.
hashedPhoneNumbers userData.userIdentifiers.phoneNumber Impostato sul 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 far corrispondere un singolo utente utilizzando più oggetti UserIdentifier.
hashedFirstName userData.userIdentifiers.address.givenName Imposta il nome dato formattato e sottoposto ad hashing. Puoi anche criptare il nome dato sottoposto ad hashing.
hashedLastName userData.userIdentifiers.address.familyName Impostato sul cognome formattato e sottoposto ad hashing. Puoi anche criptare il nome della famiglia sottoposto ad hashing.
countryCode userData.userIdentifiers.address.regionCode
zipCodes userData.userIdentifiers.address.postalCode È possibile utilizzare più codici postali per far corrispondere 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 Display & Video 360. loginAccount Questa impostazione deve essere configurata solo in uno scenario di accesso partner Display & Video 360, in cui il segmento di pubblico si trova in 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 principale o del partner del pubblico. operatingAccount
firstPartyAndPartnerAudienceId productDestinationId
Nessun equivalente reference
Indietro
Procedura per l'upgrade