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.

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 ai 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 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
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 il mapping 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, ti 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