Utilisez les mappages des tableaux pour mapper un
conversions.batchinsert dans l'API Campaign Manager 360 à son
IngestEventsRequest équivalent dans l'API Data Manager.
Champs des demandes
conversions.batchinsert (API Campaign Manager 360) |
IngestEventsRequest (API Data Manager) |
Remarques |
|---|---|---|
Paramètre de chemin d'URL profileId |
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éfini 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 la section Chiffrement. |
| Aucun équivalent | destinations |
Obligatoire. Liste d'objets Destination qui définissent le compte cible et l'activité Floodlight pour les événements. Pour en savoir plus, consultez le guide 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 la valeur sur Encoding utilisée 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éfini au niveau de la requête. Définissez la valeur sur l'ID de configuration Floodlight. |
| Aucun équivalent | destinations[].operatingAccount.accountType |
Défini au niveau de la requête. Définissez la valeur sur FLOODLIGHT_CONFIG. |
floodlightActivityId |
destinations[].productDestinationId |
Défini au niveau de la requête. Définissez la valeur sur l'ID d'activité Floodlight (anciennement appelé "ID d'activité Floodlight"). |
kind |
Aucun équivalent | Champ de métadonnées ; non utilisé par l'API Data Manager. |
| Aucun équivalent | destinations[].reference |
Défini 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 à plusieurs destinations dans une seule requête. |
adUserDataConsent |
consent.adUserData |
Pour en savoir plus, consultez la section Consent. |
nonPersonalizedAd |
consent.adPersonalization |
Pour en savoir plus, consultez la section Consent. |
| Aucun équivalent | destinationReferences |
Si vous envoyez des événements à plusieurs destinations dans une seule requête, définissez ce champ sur la reference correspondante de la destination. |
timestampMicros |
eventTimestamp |
Pour en savoir plus, consultez la section Format de l'horodatage. |
value |
conversionValue |
|
quantity |
conversionCount |
|
ordinal |
Aucun équivalent |
Le champ ordinal de l'API Campaign Manager 360 n'est pas présent dans l'API Data Manager.
À la place, transactionId peut être utilisé pour contrôler la déduplication des conversions provenant du même utilisateur et du même jour.
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 fixe et constante, 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 est utilisé pour contrôler la déduplication des conversions provenant du même utilisateur et du même jour. Ce champ doit être défini sur un identifiant unique pour chaque événement.
Ce champ est facultatif lorsque vous envoyez des conversions hors connexion Floodlight. Pour en savoir plus, consultez la section 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'énumérations. Utilisez des clés telles que U1 et U2 pour le champ variable. |
limitAdTracking |
consent.adPersonalization |
Pour en savoir plus, consultez la section Consent. |
childDirectedTreatment |
consent.adPersonalization |
Pour en savoir plus, consultez la section Consent. |
treatmentForUnderage |
consent.adPersonalization |
Pour en savoir plus, consultez la section Consent. |
gclid |
adIdentifiers.gclid |
Pour en savoir plus, consultez la section AdIdentifiers. |
dclid |
adIdentifiers.dclid |
Pour en savoir plus, consultez la section AdIdentifiers. |
matchId |
adIdentifiers.matchId |
Pour en savoir plus, consultez la section AdIdentifiers. |
mobileDeviceId |
adIdentifiers.mobileId |
Pour en savoir plus, consultez la section AdIdentifiers. |
impressionId |
adIdentifiers.impressionId |
Pour en savoir plus, consultez la section AdIdentifiers. |
encryptedUserId |
adIdentifiers.encryptedUserIds |
L'API Data Manager accepte plusieurs ID utilisateur chiffrés. Pour en savoir plus, consultez la section AdIdentifiers. |
encryptedUserIdCandidates |
adIdentifiers.encryptedUserIds |
Chaque ID candidat correspond à un EncryptedUserId objet 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 la section AdIdentifiers. |
cartData |
cartData |
Pour en savoir plus, consultez la section Champs de données du panier. |
userIdentifiers |
userData.userIdentifiers |
Pour en savoir plus, consultez la section Champs d'identifiant utilisateur. |
Champs d'identifiant utilisateur
Dans l'API Data Manager, les identifiants utilisateur sont regroupés dans un
UserData objet sous le userData champ de l'
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 la valeur sur l'adresse e-mail mise en forme et hachée. Vous pouvez également chiffrer l'adresse e-mail hachée. |
hashedPhoneNumber |
phoneNumber |
Définissez la valeur sur 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éfinissez la valeur sur un AddressInfo objet. 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 Data Manager. |
addressInfo.state |
Aucun équivalent | Non compatible avec la version actuelle de l'API Data Manager. |
addressInfo.hashedStreetAddress |
Aucun équivalent | Non compatible avec la version actuelle de l'API Data Manager. |
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 la section 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 la valeur sur l'ID produit Merchant Center de l'élément. |
quantity |
quantity |
Obligatoire. |
unitPrice |
unitPrice |
Obligatoire. |