Mappages de champs

Utilisez les mappages dans les tableaux pour faire correspondre les méthodes et les champs de gestion des audiences de ciblage par liste de clients dans l'API Display & Video 360 à leurs équivalents dans l'API Data Manager.

Mappage des méthodes

Le tableau suivant met en correspondance les méthodes de l'API Display & Video 360 avec les méthodes équivalentes de l'API Data Manager :

Méthodes de l'API Display & Video 360	Méthodes de l'API Data Manager	Remarques
firstPartyAndPartnerAudiences.get	userLists.get	L'API Data Manager ne peut récupérer que les audiences de ciblage par liste de clients.
firstPartyAndPartnerAudiences.list	userLists.list	L'API Data Manager ne renverra que les audiences de ciblage par liste de clients.
firstPartyAndPartnerAudiences.create	userLists.create	Les données utilisateur doivent être importées dans une requête ultérieure de l'API Data Manager.
Aucun équivalent	userLists.delete	Non disponible dans l'API Display & Video 360.
firstPartyAndPartnerAudiences.patch	userLists.patch
firstPartyAndPartnerAudiences.editCustomerMatchMembers	audienceMembers.ingest	Des méthodes distinctes de l'API Data Manager sont utilisées pour ajouter et supprimer des membres des audiences de ciblage par liste de clients.
firstPartyAndPartnerAudiences.editCustomerMatchMembers	audienceMembers.remove	Des méthodes distinctes de l'API Data Manager sont utilisées pour ajouter et supprimer des membres des audiences de ciblage par liste de clients.

Mappage des requêtes

Les tableaux suivants mettent en correspondance les champs de requête des méthodes de l'API Display & Video 360 avec leurs équivalents dans l'API Data Manager.

userLists.get

firstPartyAndPartnerAudiences.get (API Display & Video 360)	userLists.get (API Data Manager)	Remarques
advertiserId partnerId firstPartyAndPartnerAudienceId	name	Le nom UserList contient à la fois l'ID de l'annonceur ou du partenaire parent et l'ID de l'audience. Pour en savoir plus, consultez Noms de ressources.

userLists.list

firstPartyAndPartnerAudiences.list (API Display & Video 360)	userLists.list (API Data Manager)	Remarques
advertiserId partnerId	parent	parent contient l'ID de l'annonceur ou du partenaire parent.
pageSize	pageSize	La taille de page maximale dans l'API Data Manager est de 1000.
pageToken	pageToken
filter	filter
orderBy	Aucun équivalent

userLists.create

firstPartyAndPartnerAudiences.create (API Display & Video 360)	userLists.create (API Data Manager)	Remarques
advertiserId partnerId	parent	parent contient l'ID de l'annonceur ou du partenaire parent de la nouvelle audience.
Aucun équivalent	validateOnly
Corps de la requête FirstPartyAndPartnerAudience	Corps de la requête UserList	Consultez UserList pour le mappage du corps de la requête.

userLists.update

firstPartyAndPartnerAudiences.patch (API Display & Video 360)	userLists.patch (API Data Manager)	Remarques
advertiserId firstPartyAndPartnerAudienceId	Paramètre userList.name	Le nom de ressource du UserList à mettre à jour.
updateMask	updateMask	Ce champ est recommandé, mais pas obligatoire dans l'API Data Manager. S'il est laissé vide, tous les champs inclus seront remplacés.
Aucun équivalent	validateOnly
Corps de la requête FirstPartyAndPartnerAudience	Corps de la requête UserList	Consultez UserList pour le mappage du corps de la requête.

audienceMembers.ingest

firstPartyAndPartnerAudiences.editCustomerMatchMembers (API Display & Video 360)	audienceMembers.ingest (API Data Manager)	Remarques
advertiserId firstPartyAndPartnerAudienceId	destinations	Pour en savoir plus, consultez Configurer des destinations.
addedContactInfoList.contactInfos	audienceMembers	Les identifiants utilisateur individuels peuvent être définis dans le champ compositeData.userData des objets AudienceMember. Pour en savoir plus, consultez Identifiants utilisateur.
addedContactInfoList.consent	consent	Le consentement peut également être défini dans des objets AudienceMember individuels.
addedMobileDeviceIdList.mobileDeviceIds	audienceMembers	Les ID d'appareils mobiles individuels sont définis dans le champ mobileData des objets AudienceMember.
addedMobileDeviceIdList.consent	consent	Le consentement peut également être défini dans des objets AudienceMember individuels.
Aucun équivalent	validateOnly
Aucun équivalent	encoding	Obligatoire. Définissez-le sur le Encoding utilisé pour les valeurs UserIdentifier.
Aucun équivalent	encryptionInfo	Indique si la requête contient des valeurs chiffrées. Pour en savoir plus, consultez Chiffrement.
Aucun équivalent	termsOfService	Obligatoire. Indique si l'utilisateur a accepté ou refusé les conditions d'utilisation du ciblage par liste de clients.

audienceMembers.remove

firstPartyAndPartnerAudiences.editCustomerMatchMembers (API Display & Video 360)	audienceMembers.remove (API Data Manager)	Remarques
advertiserId firstPartyAndPartnerAudienceId	destinations
removedContactInfoList.contactInfos	audienceMembers	Les identifiants utilisateur individuels peuvent être définis dans le champ compositeData.userData des objets AudienceMember. Pour en savoir plus, consultez Identifiants utilisateur.
removedMobileDeviceIdList.mobileDeviceIds	audienceMembers	Les ID d'appareils mobiles individuels sont définis dans le champ mobileData des objets AudienceMember.
Aucun équivalent	validateOnly
Aucun équivalent	encoding	Obligatoire. Définissez-le sur le Encoding utilisé pour les valeurs UserIdentifier.
Aucun équivalent	encryptionInfo	Indique si la requête contient des valeurs chiffrées. Pour en savoir plus, consultez Chiffrement.

Mappages des champs d'objet

Voici les mappages des objets de l'API Display & Video 360 vers les objets équivalents dans l'API Data Manager.

UserList

FirstPartyAndPartnerAudience (API Display & Video 360)	UserList (API Data Manager)	Remarques
name	name	Utilise un format de nom de ressource différent. Pour en savoir plus, consultez Noms de ressources.
firstPartyAndPartnerAudienceId	id
Aucun équivalent	readOnly
displayName	displayName
description	description
Aucun équivalent	membershipStatus
Aucun équivalent	integrationCode
membershipDurationDays	membershipDuration
Aucun équivalent	closingReason
Aucun équivalent	accessReason
Aucun équivalent	accountAccessStatus
displayAudienceSize	sizeInfo.displayNetworkMembersCount
Aucun équivalent	sizeInfo.searchNetworkMembersCount
Aucun équivalent	targetNetworkInfo
Aucun équivalent	ingestedUserListInfo
firstPartyAndPartnerAudienceType	Aucun équivalent
audienceType	Aucun équivalent
audienceSource	Aucun équivalent
activeDisplayAudienceSize	Aucun équivalent
youtubeAudienceSize	Aucun équivalent
gmailAudienceSize	Aucun équivalent
displayMobileAppAudienceSize	Aucun équivalent
displayMobileWebAudienceSize	Aucun équivalent
displayDesktopAudienceSize	Aucun équivalent
appId	ingestedUserListInfo.mobileIdInfo.appId
contactInfoList	Méthodes audienceMembers	Dans l'API Data Manager, ajoutez et supprimez des membres à l'aide des méthodes ingest et remove de audienceMembers.
mobileDeviceIdList	Méthodes audienceMembers	Dans l'API Data Manager, ajoutez et supprimez des membres à l'aide des méthodes ingest et remove de audienceMembers.

Noms de ressources

L'API Data Manager utilise un format de nom de ressource différent de celui de l'API Display & Video 360.

API Display & Video 360

Dans l'API Display & Video 360, un nom de ressource UserList utilise un format qui ne contient que l'ID d'audience :

firstAndThirdPartyAudiences/{first_and_third_party_audience_id}

API Data Manager

Dans l'API Data Manager, un nom de ressource UserList utilise un format qui contient l'ID d'audience, ainsi que l'ID AccountType et le numéro de compte du partenaire ou de l'annonceur propriétaire de l'audience :

accountTypes/{accountType}/accounts/{account}/userLists/{userList}

User ID

Bien que userData soit toujours compatible, nous vous recommandons d'utiliser compositeData pour vous assurer que votre intégration est prête pour les améliorations à venir. Pour en savoir plus, consultez Données composites.

ContactInfo (API Display & Video 360)	CompositeData (API Data Manager)	Remarques
hashedEmails	userData.userIdentifiers.emailAddress	Définissez l'adresse e-mail mise en forme et hachée. Vous pouvez également chiffrer l'adresse e-mail hachée. Vous pouvez utiliser plusieurs adresses e-mail pour faire correspondre un seul utilisateur en utilisant plusieurs objets UserIdentifier.
hashedPhoneNumbers	userData.userIdentifiers.phoneNumber	Définissez le numéro de téléphone mis en forme et haché. Vous pouvez également chiffrer le numéro de téléphone haché. Vous pouvez utiliser plusieurs numéros de téléphone pour faire correspondre un même utilisateur en utilisant plusieurs objets UserIdentifier.
hashedFirstName	userData.userIdentifiers.address.givenName	Définissez le nom donné mis en forme et haché. Vous pouvez également chiffrer le prénom haché.
hashedLastName	userData.userIdentifiers.address.familyName	Définissez le nom de famille mis en forme et haché. Vous pouvez également chiffrer le nom de famille haché.
countryCode	userData.userIdentifiers.address.regionCode
zipCodes	userData.userIdentifiers.address.postalCode	Vous pouvez utiliser plusieurs codes postaux pour faire correspondre un seul utilisateur en utilisant plusieurs objets UserIdentifier.

Destination

API Display & Video 360	Destination (API Data Manager)	Remarques
ID de l'annonceur ou du partenaire auquel l'utilisateur Display & Video 360 a accès.	loginAccount	Ce paramètre ne doit être défini que dans un scénario d'accès à un partenaire Display & Video 360, où l'audience se trouve sous un annonceur, mais l'utilisateur Display & Video 360 qui y accède a reçu l'autorisation d'accéder au partenaire parent de l'annonceur. Sinon, il peut être laissé non défini.
ID de l'annonceur ou du partenaire parent de l'audience.	operatingAccount
firstPartyAndPartnerAudienceId	productDestinationId
Aucun équivalent	reference