Utilisez les mappages dans les tableaux pour faire correspondre un conversions.batchinsert dans l'API Campaign Manager 360 à son équivalent IngestEventsRequest dans l'API Data Manager.
Champs des demandes
conversions.batchinsert (API Campaign Manager 360) |
IngestEventsRequest (API Data Manager) |
Remarques |
|---|---|---|
profileId Paramètre de chemin de l'URL |
Aucun équivalent | |
kind |
Aucun équivalent | Champ de métadonnées non utilisé par l'API Data Manager. |
conversions |
events |
Obligatoire. Liste des conversions ou des événements. Pour en savoir plus, consultez la section Champs de conversion. |
encryptionInfo |
Déplacé vers events.adIdentifiers.encryptedUserIds |
Définie au niveau de l'événement. Les informations de chiffrement de Campaign Manager 360 sont désormais spécifiées dans chaque ID utilisateur chiffré. Consultez la section Champs de conversion. |
| Aucun équivalent | encryptionInfo |
Le encryptionInfo au niveau de la requête correspond aux informations de chiffrement des identifiants utilisateur UserData chiffrés. Pour en savoir plus, consultez Chiffrement. |
| Aucun équivalent | destinations |
Obligatoire. Liste des objets Destination qui définissent le compte cible et l'activité Floodlight pour les événements. Pour en savoir plus, consultez le guide des destinations. Mappez les champs individuels comme indiqué dans la section Champs de conversion. |
| Aucun équivalent | consent |
Paramètres de consentement par défaut facultatifs pour les événements de la requête. Vous pouvez remplacer cette valeur pour un événement individuel en définissant le champ consent de Event. |
| Aucun équivalent | encoding |
Obligatoire si vous envoyez des identifiants utilisateur : définissez-le sur le Encoding utilisé pour les valeurs UserIdentifier. Si vous n'utilisez pas d'identifiants utilisateur, ce champ est ignoré. |
| Aucun équivalent | validateOnly |
Si la valeur est "true", la requête est validée, mais pas exécutée. |
Champs de conversion
Conversion (API Campaign Manager 360) |
Event (API Data Manager) |
Remarques |
|---|---|---|
floodlightConfigurationId |
destinations[].operatingAccount.accountId |
Définie au niveau de la requête. Définissez l'ID de configuration Floodlight. |
| Aucun équivalent | destinations[].operatingAccount.accountType |
Définie au niveau de la requête. Définissez cet élément sur FLOODLIGHT_CONFIG. |
floodlightActivityId |
destinations[].productDestinationId |
Définie au niveau de la requête. Définissez l'ID de l'activité Floodlight (anciennement "ID de l'activité Floodlight"). |
kind |
Aucun équivalent | Champ de métadonnées non utilisé par l'API Data Manager. |
| Aucun équivalent | destinations[].reference |
Définie au niveau de la requête. Identifiant défini par l'utilisateur pour la destination. Définissez ce champ si vous envoyez des événements vers plusieurs destinations dans une même requête. |
adUserDataConsent |
consent.adUserData |
Pour en savoir plus, consultez Consent. |
nonPersonalizedAd |
consent.adPersonalization |
Pour en savoir plus, consultez Consent. |
| Aucun équivalent | destinationReferences |
Si vous envoyez des événements vers plusieurs destinations dans une même requête, définissez ce champ sur le reference correspondant de la destination. |
timestampMicros |
eventTimestamp |
Pour en savoir plus, consultez Format du code temporel. |
value |
conversionValue |
|
quantity |
conversionCount |
|
ordinal |
Aucun équivalent |
Le champ ordinal de l'API Campaign Manager 360 n'est pas présent dans l'API Gestionnaire de données.
À la place, transactionId peut être utilisé pour contrôler la façon dont les conversions provenant du même utilisateur et du même jour sont dédupliquées.
Dans l'API Campaign Manager 360, vous pouvez vous assurer que les événements sont dédupliqués en définissant ordinal sur une valeur constante et fixe telle que 1. Dans l'API Data Manager, transactionId doit être défini sur un identifiant unique pour chaque événement.
|
| Aucun équivalent | transactionId |
Dans l'API Data Manager, transactionId permet de contrôler la façon dont les conversions provenant du même utilisateur et du même jour sont dédupliquées. Ce champ doit être défini sur un identifiant unique pour chaque événement.
Ce champ est facultatif lorsque vous envoyez des conversions Floodlight hors connexion. Pour en savoir plus, consultez Convertir les données en objets Event.
|
customVariables |
customVariables |
Liste d'objets CustomVariable. L'API Data Manager utilise des chaînes comme clés au lieu d'énums. Utilisez des clés telles que U1 ou U2 pour le champ variable. |
limitAdTracking |
consent.adPersonalization |
Pour en savoir plus, consultez Consent. |
childDirectedTreatment |
consent.adPersonalization |
Pour en savoir plus, consultez Consent. |
treatmentForUnderage |
consent.adPersonalization |
Pour en savoir plus, consultez Consent. |
gclid |
adIdentifiers.gclid |
Pour en savoir plus, consultez AdIdentifiers. |
dclid |
adIdentifiers.dclid |
Pour en savoir plus, consultez AdIdentifiers. |
matchId |
adIdentifiers.matchId |
Pour en savoir plus, consultez AdIdentifiers. |
mobileDeviceId |
adIdentifiers.mobileId |
Pour en savoir plus, consultez AdIdentifiers. |
impressionId |
adIdentifiers.impressionId |
Pour en savoir plus, consultez AdIdentifiers. |
encryptedUserId |
adIdentifiers.encryptedUserIds |
L'API Data Manager est compatible avec plusieurs ID utilisateur chiffrés. Pour en savoir plus, consultez AdIdentifiers. |
encryptedUserIdCandidates |
adIdentifiers.encryptedUserIds |
Chaque ID de candidat correspond à un objet EncryptedUserId dans la liste. |
encryptionInfo.kind |
Aucun équivalent | Champ de métadonnées non utilisé par l'API Data Manager. |
encryptionInfo.encryptionEntityType |
adIdentifiers.encryptedUserIds[].entityType |
Au lieu de spécifier les informations de chiffrement une fois par requête, elles sont spécifiées par ID utilisateur chiffré. |
encryptionInfo.encryptionEntityId |
adIdentifiers.encryptedUserIds[].entityId |
Au lieu de spécifier les informations de chiffrement une fois par requête, elles sont spécifiées par ID utilisateur chiffré. |
encryptionInfo.encryptionSource |
adIdentifiers.encryptedUserIds[].source |
Au lieu de spécifier les informations de chiffrement une fois par requête, elles sont spécifiées par ID utilisateur chiffré. |
sessionAttributesEncoded |
adIdentifiers.sessionAttributes |
Pour en savoir plus, consultez AdIdentifiers. |
cartData |
cartData |
Pour en savoir plus, consultez Champs de données du panier. |
userIdentifiers |
userData.userIdentifiers |
Pour en savoir plus, consultez Champs d'identifiant utilisateur. |
Champs d'identifiant utilisateur
Dans l'API Data Manager, les identifiants utilisateur sont regroupés dans un objet UserData sous le champ userData de Event. Cela diffère de l'API Campaign Manager 360, où les identifiants sont directement associés à l'objet Conversion.
UserIdentifier (API Campaign Manager 360) |
UserIdentifier (API Data Manager) |
Remarques |
|---|---|---|
hashedEmail |
emailAddress |
Définissez l'adresse e-mail mise en forme et hachée. Vous pouvez également chiffrer l'adresse e-mail hachée. |
hashedPhoneNumber |
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é. |
addressInfo |
address |
Défini sur un objet AddressInfo. Suivez les consignes de mise en forme et de hachage. Vous pouvez également chiffrer les attributs hachés d'une adresse. |
addressInfo.hashedFirstName |
address.givenName |
|
addressInfo.hashedLastName |
address.familyName |
|
addressInfo.countryCode |
address.regionCode |
|
addressInfo.postalCode |
address.postalCode |
|
addressInfo.city |
Aucun équivalent | Non compatible avec la version actuelle de l'API Gestionnaire de données. |
addressInfo.state |
Aucun équivalent | Non compatible avec la version actuelle de l'API Gestionnaire de données. |
addressInfo.hashedStreetAddress |
Aucun équivalent | Non compatible avec la version actuelle de l'API Gestionnaire de données. |
Champs de données du panier
CartData (API Campaign Manager 360) |
CartData (API Data Manager) |
Remarques |
|---|---|---|
kind |
Aucun équivalent | Champ de métadonnées non utilisé par l'API Data Manager. |
merchantId |
merchantId |
|
merchantFeedLabel |
merchantFeedLabel |
|
merchantFeedLanguage |
merchantFeedLanguageCode |
|
items |
items |
Liste d'objets Item. Pour en savoir plus, consultez Champs d'article. |
Champs d'article pour les données du panier
Item (API Campaign Manager 360) |
Item (API Data Manager) |
Remarques |
|---|---|---|
kind |
Aucun équivalent | Champ de métadonnées non utilisé par l'API Data Manager. |
| Aucun équivalent | itemId |
Facultatif. Identifiant unique de l'élément. |
itemId |
merchantProductId |
Obligatoire. Définissez l'ID du produit dans Merchant Center pour l'article. |
quantity |
quantity |
Obligatoire. |
unitPrice |
unitPrice |
Obligatoire. |