Documentation Analytics Guide de mise en œuvre

Mappage de la variable d’objet XDM à Adobe Analytics

Dernière mise à jour : 6 mars 2025

Rubriques :

Créé pour :

Administration
Développeur

Le tableau suivant montre les variables XDM que Adobe Experience Platform Edge Network mappe automatiquement dans Adobe Analytics. Si vous utilisez ces chemins de champ XDM, aucune configuration supplémentaire n’est nécessaire pour envoyer des données à Adobe Analytics. Ces champs sont inclus dans le groupe de champs Modèle Adobe Analytics ExperienceEvent. L’utilisation de ces champs est recommandée si vous avez l’intention d’envoyer des données à Adobe Analytics et à Adobe Experience Platform.

Si votre entreprise prévoit de passer à Customer Journey Analytics, Adobe recommande plutôt d’utiliser l’objet data pour envoyer directement des données à Adobe Analytics sans se conformer à un schéma. Cette stratégie permet à votre organisation d’utiliser votre propre schéma, au lieu d’utiliser le modèle Adobe Analytics ExperienceEvent (qui s’applique moins à Customer Journey Analytics). Consultez Mappage des variables d’objet de données à Adobe Analytics pour obtenir un tableau de mappage similaire.

Priorités des valeurs

La plupart des champs d’objet XDM de ce tableau correspondent à un champ d’objet de données. Si vous définissez un champ d’objet XDM donné et son champ d’objet de données respectif, le champ d’objet de données est prioritaire. Si vous utilisez à la fois le champ d’objet XDM et le champ d’objet de données, Adobe recommande de définir des événements personnalisés à l’aide du champ d’objet de données. Si le champ data.__adobe.analytics.events est présent, il remplace tous les champs d’objet XDM liés aux événements commerciaux et personnalisés.

Mappage de champs d’objet XDM

Vous trouverez les mises à jour précédentes de ce tableau dans la section historique de validation sur GitHub de cette page.

Chemin d’accès au champ XDM	Variable et description Analytics
`xdm.application.isClose`	Permet de définir la mesure de cycle de vie mobile Blocages.
`xdm.application.isInstall`	Permet de déterminer quand augmenter la mesure de cycle de vie mobile Premiers lancements.
`xdm.application.closeType`	Détermine si un événement de fermeture est un blocage ou non. Les valeurs valides sont les suivantes : `close` (Une session de cycle de vie se termine et un événement pause a été reçu pour la session précédente) et `unknown` (Une session de cycle de vie se termine sans événement pause). Permet de définir la mesure de cycle de vie mobile Blocages.
`xdm.application.isInstall`	Mesure de cycle de vie mobile Installations.
`xdm.application.isLaunch`	Mesure de cycle de vie mobile Lancements.
`xdm.application.name`	Permet de définir la dimension de cycle de vie mobile ID de l’application.
`xdm.application.isUpgrade`	Mesure de cycle de vie mobile Mises à niveau.
`xdm.application.version`	Permet de définir la dimension de cycle de vie mobile ID de l’application.
`xdm.application.sessionLength`	Mesure de cycle de vie mobile Durée de la session précédente.
`xdm.commerce.checkouts.id`	Applique la sérialisation des événements à la mesure Passages en caisse.
`xdm.commerce.checkouts.value`	Incrémente la mesure Passages en caisse de la quantité souhaitée.
`xdm.commerce.order.currencyCode`	Définit la variable de configuration currencyCode.
`xdm.commerce.order.purchaseID`	Définit la variable de page purchaseID.
`xdm.commerce.order.payments[0].transactionID`	Définit la variable de page transactionID.
`xdm.commerce.productListAdds.id`	Applique la sérialisation des événements à la mesure Ajouts au panier.
`xdm.commerce.productListAdds.value`	Incrémente la mesure Ajouts au panier.
`xdm.commerce.productListOpens.id`	Applique la sérialisation des événements à la mesure Paniers.
`xdm.commerce.productListOpens.value`	Incrémente la mesure Paniers.
`xdm.commerce.productListRemovals.id`	Applique la sérialisation des événements à la mesure Suppression du panier.
`xdm.commerce.productListRemovals.value`	Incrémente la mesure Retraits du panier.
`xdm.commerce.productListViews.id`	Applique la sérialisation des événements à la mesure Vues du panier.
`xdm.commerce.productListViews.value`	Incrémente la mesure Consultations du panier.
`xdm.commerce.productViews.id`	Applique la sérialisation des événements à la mesure Vues des produits.
`xdm.commerce.productViews.value`	Incrémente la mesure Consultations de produit.
`xdm.commerce.purchases.value`	Incrémente la mesure Commandes.
`xdm.device.model`	Dimension du cycle de vie mobile Nom de l’appareil.
`xdm.device.colorDepth`	Permet de définir la dimension Profondeur de la couleur.
`xdm.device.screenHeight`	Permet de définir la dimension Résolution du moniteur.
`xdm.device.screenWidth`	Permet de définir la dimension Résolution du moniteur.
`xdm.device.type`	Type d’appareil mobile.
`xdm.environment.browserDetails.acceptLanguage`	Permet de définir la dimension Langue.
`xdm.environment.browserDetails.cookiesEnabled`	Définit la dimension Prise en charge des cookies. Les valeurs valides sont les suivantes : `Y` (le navigateur accepte les cookies) et `N` (le navigateur rejette les cookies).
`xdm.environment.browserDetails.javaEnabled`	Définit la dimension Compatible Java. Les valeurs valides sont les suivantes : `Y` (Java est activé) et `N` (Java est désactivé).
`xdm.environment.browserDetails.userAgent`	Utilisé comme méthode d’identification visiteur unique de secours. Généralement renseignée à l’aide de l’en-tête de requête HTTP `User-Agent`. Vous pouvez associer ce champ à une eVar si vous souhaitez l’utiliser dans des rapports.
`xdm.environment.browserDetails.viewportHeight`	Définit la dimension Hauteur du navigateur.
`xdm.environment.browserDetails.viewportWidth`	Définit la dimension Largeur du navigateur.
`xdm.environment.carrier`	Dimension du cycle de vie mobile Nom de l’opérateur.
`xdm.environment.connectionType`	Permet de définir la dimension Type de connexion.
`xdm.environment.ipV4`	Utilisé comme méthode d’identification visiteur unique de secours. Généralement renseignée à l’aide de l’en-tête HTTP `X-Forwarded-For`.
`xdm.environment._dc.language`	La dimension mobile Paramètres régionaux. Utilisé uniquement si xdm.environment.language n’est pas défini.
`xdm.environment.language`	La dimension mobile Paramètres régionaux.
`xdm.environment.operatingSystem`	Dimension du cycle de vie mobile Système d’exploitation.
`xdm.environment.operatingSystemVersion`	Permet de définir la dimension de cycle de vie mobile Version du système d’exploitation.
`xdm._experience.analytics.customDimensions.` `eVars.eVar1` `[...]` `xdm._experience.analytics.customDimensions.` `eVars.eVar250`	Définit la dimension eVar correspondante.
`xdm._experience.analytics.customDimensions.` `hierarchies.hier1` `[...]` `xdm._experience.analytics.customDImensions.` `hierarchies.hier5`	Définit la dimension Hiérarchie correspondante.
`xdm._experience.analytics.customDimensions.` `listProps.prop1.delimiter` `[...]` `xdm._experience.analytics.customDimensions.` `listProps.prop75.delimiter`	Remplacement du délimiteur de props de liste. L’utilisation de ce champ n’est pas recommandée, car le délimiteur est automatiquement récupéré depuis Admin des variables de trafic dans les paramètres de la suite de rapports. L’utilisation de ce champ peut créer une incohérence entre le délimiteur utilisé et le délimiteur attendu par Analytics.
`xdm._experience.analytics.customDimensions.` `listProps.prop1.values` `[...]` `xdm._experience.analytics.customDimensions.` `listProps.prop75.values`	Un tableau de chaînes contenant les valeurs correspondantes de props de liste.
`xdm._experience.analytics.customDimensions.` `lists.list1.list[].value` `[...]` `xdm._experience.analytics.customDimensions.` `lists.list3.list[].value`	Concatène toutes les chaînes `value` de chaque tableau `list[]` à sa variable de liste. Le délimiteur est automatiquement sélectionné en fonction de la valeur définie dans les Paramètres de la suite de rapports.
`xdm._experience.analytics.customDimensions.` `props.prop1` `[...]` `xdm._experience.analytics.customDimensions.` `props.prop75`	Définit la dimension prop correspondante.
`xdm._experience.analytics.event1to100.` `event1.id` `[...]` `xdm._experience.analytics.event901to1000.` `event1000.id`	Applique la sérialisation des événements à la mesure correspondante des événements personnalisés. Chaque ID d’événement réside dans son parent de groupe 100. Par exemple, pour appliquer la sérialisation à `event678`, utilisez `xdm._experience.analytics.event601to700.event678.id`.
`xdm._experience.analytics.event1to100.` `event1.value` `[...]` `xdm._experience.analytics.event901to1000.` `event1000.value`	Incrémente la mesure correspondante des événements personnalisés par la quantité désirée. Chaque événement réside dans son parent de groupe 100. Par exemple, le champ pour `event567` est `xdm._experience.analytics.event501to600.event567.value`.
`xdm.identityMap.ECID[0].id`	L’identifiant du service d’identités Adobe Experience Cloud.
`xdm.marketing.trackingCode`	Définit la dimension Code de suivi.
`xdm.media.mediaTimed.completes.value`	Mesure des médias en flux continu Contenu terminé.
`xdm.media.mediaTimed.dropBeforeStart.value`	`c.a.media.view`, `c.a.media.timePlayed`, `c.a.media.play`
`xdm.media.mediaTimed.federated.value`	Mesure des médias en flux continu Données fédérées.
`xdm.media.mediaTimed.firstQuartiles.value`	Mesure des médias en flux continu marqueur de progression de 25 %.
`xdm.media.mediaTimed.mediaSegmentView.value`	Mesure des médias en flux continu vues de segments de contenu.
`xdm.media.mediaTimed.midpoints.value`	Mesure des médias en flux continu marqueur de progression de 50 %.
`xdm.media.mediaTimed.pauseTime.value`	La mesure des médias en flux continu durée totale de pause.
`xdm.media.mediaTimed.pauses.value`	La mesure Médias en flux continu Mettre les événements en pause.
`xdm.mediaCollection.sessionDetails.assetID`	La dimension des médias en flux continu ID de ressource.
`xdm.mediaCollection.sessionDetails.friendlyName`	La dimension des médias en flux continu Nom de la vidéo.
`xdm.mediaCollection.sessionDetails.originator`	La dimension des médias en flux continu initiateur.
`xdm.mediaCollection.sessionDetails.episode`	La dimension des médias en flux continu épisode.
`xdm.mediaCollection.sessionDetails.genre`	La dimension des médias en flux continu Genre.
`xdm.mediaCollection.sessionDetails.rating`	La dimension des médias en flux continu évaluation du contenu.
`xdm.mediaCollection.sessionDetails.season`	La dimension des médias en flux continu Saison.
`xdm.mediaCollection.sessionDetails.name`	La dimension des médias en flux continu ID de contenu.
`xdm.mediaCollection.sessionDetails.show`	La dimension Médias en flux continu Afficher.
`xdm.mediaCollection.sessionDetails.showType`	La dimension Médias en flux continu Type d’affichage.
`xdm.mediaCollection.sessionDetails.length`	La dimension des médias en flux continu durée de la vidéo.
`xdm.media.mediaTimed.primaryAssetViewDetails.@id`	La dimension des médias en flux continu ID de session multimédia.
`xdm.mediaCollection.sessionDetails.channel`	La dimension des médias en flux continu canal de contenu.
`xdm.mediaCollection.sessionDetails.contentType`	La dimension des médias en flux continu Type de contenu.
`xdm.mediaCollection.sessionDetails.network`	La dimension des médias en flux continu Réseau.
`xdm.media.mediaTimed.primaryAssetViewDetails.` `mediaSegmentView.value`	La dimension des médias en flux continu Segment de contenu.
`xdm.mediaCollection.sessionDetails.playerName`	La dimension des médias en flux continu Nom du lecteur de contenu.
`xdm.mediaCollection.sessionDetails.appVersion`	La dimension des médias en flux continu Version de SDK.
`xdm.mediaCollection.sessionDetails.feed`	La dimension des médias en flux continu Type de flux de médias.
`xdm.mediaCollection.sessionDetails.streamFormat`	La dimension Médias en flux continu Format de flux.
`xdm.media.mediaTimed.progress10.value`	Mesure des médias en flux continu Marqueur de progression de 10 %.
`xdm.media.mediaTimed.progress95.value`	Mesure des médias en flux continu marqueur de progression de 95 %.
`xdm.mediaCollection.sessionDetails.hasResume`	La mesure des médias en flux continu Reprise du contenu.
`xdm.media.mediaTimed.starts.value`	La mesure Médias en flux continu Démarrage des médias.
`xdm.media.mediaTimed.thirdQuartiles.value`	Mesure des médias en flux continu marqueur de progression de 75 %.
`xdm.media.mediaTimed.timePlayed.value`	La mesure des médias en flux continu Temps passé sur le contenu.
`xdm.media.mediaTimed.totalTimePlayed.value`	Mesure des médias en flux continu Durée des médias utilisée.
`xdm.placeContext.geo._schema.latitude`	La latitude et l’emplacement du visiteur. Permet de définir les dimensions emplacement du cycle de vie mobile.
`xdm.placeContext.geo._schema.longitude`	Emplacement en longitude du visiteur. Permet de définir les dimensions emplacement du cycle de vie mobile.
`xdm.placeContext.geo.postalCode`	La dimension Code postal.
`xdm.placeContext.geo.stateProvince`	La dimension États américains.
`xdm.placeContext.localTime`	Apparaît comme `t_time_info` dans Flux de données.
`xdm.productListItems[]._experience.analytics.` `customDimensions.eVars.eVar1` `[...]` `xdm.productListItems[]._experience.analytics.` `customDimensions.eVars.eVar250`	Applique le marchandisage de la syntaxe du produit aux eVars.
`xdm.productListItems[]._experience.analytics.` `event1to100.event1.value` `[...]` `xdm.productListItems[]._experience.analytics.` `event901-1000.event1000.value`	Applique le marchandisage de la syntaxe de produit aux événements.
`xdm.productListItems[].productCategories[].categoryID`	La dimension Catégorie. Voir aussi la variable de la page des produits.
`xdm.productListItems[].name`	La dimension Produit. Voir aussi la variable de la page des produits. Si `xdm.productListItems[].SKU` et `xdm.productListItems[].name` contiennent tous deux des données, la valeur de `xdm.productListItems[].SKU` est utilisée.
`xdm.productListItems[].priceTotal`	Permet de déterminer la mesure Revenu. Voir aussi la variable de la page des produits.
`xdm.productListItems[].quantity`	Permet de déterminer la mesure Unités. Voir aussi la variable de la page des produits.
`xdm.productListItems[].SKU`	La dimension Produit. Voir aussi la variable de la page des produits. Si `xdm.productListItems[].SKU` et `xdm.productListItems[].name` contiennent tous deux des données, la valeur de `xdm.productListItems[].SKU` est utilisée.
`xdm.web.webInteraction.URL`	La variable de mise en œuvre linkURL.
`xdm.web.webInteraction.name`	La dimension Lien personnalisé, Lien de téléchargement ou Lien de sortie selon la valeur dans `xdm.web.webInteraction.type`
`xdm.web.webInteraction.type`	Détermine le type de lien sur lequel l’utilisateur a cliqué. Les valeurs valides sont les suivantes : `other` (Liens personnalisés), `download` (Liens de téléchargement) et `exit` (Liens de sortie).
`xdm.web.webPageDetails.URL`	La dimension URL de la page.
`xdm.web.webPageDetails.isErrorPage`	Indicateur qui permet de déterminer la dimension et la mesure « Pages introuvables ».
`xdm.web.webPageDetails.name`	La dimension Page.
`xdm.web.webPageDetails.server`	La dimension Serveur.
`xdm.web.webPageDetails.siteSection`	La dimension Section du site.
`xdm.web.webReferrer.URL`	La dimension Référent.

Mappage d’autres champs XDM aux variables Analytics

Si vous souhaitez ajouter des dimensions ou des mesures à Adobe Analytics, vous pouvez le faire via Variables de données contextuelles.

Mappage implicite

Tous les éléments de champ XDM qui ne sont pas automatiquement mappés sont envoyés à Adobe Analytics en tant que données contextuelles avec le préfixe a.x. Vous pouvez ensuite mapper cette variable de données contextuelles à la variable Analytics souhaitée à l’aide de règles de traitement. Par exemple, si vous définissez l’évènement suivant :

alloy("event",{
    "xdm":{
        "_atag":{
            "search":{
                "term":"Example search term"
            }
        }
    }
})

Le SDK Web envoie ces données à Adobe Analytics en tant que variable de données contextuelles a.x._atag.search.term. Vous pouvez ensuite utiliser une règle de traitement pour affecter cette valeur de variable de données contextuelles à la variable Analytics souhaitée, par exemple une eVar :

Règle de traitement des termes de recherche

Correspondance explicite

Vous pouvez également mapper explicitement des éléments de champ XDM en tant que données contextuelles. Tout élément de champ XDM explicitement mappé à l’aide de l’élément contextData est envoyé à Adobe Analytics en tant que données contextuelles sans préfixe. Vous pouvez ensuite mapper cette variable de données contextuelles à la variable Analytics souhaitée à l’aide des Règles de traitement. Par exemple, si vous définissez l’évènement suivant :

alloy("event",{
    "xdm":{
        "_atag":{
            "analytics": {
                "contextData" : {
                    "someValue" : "1"
                }
            }
        }
    }
})

Le SDK Web envoie ces données à Adobe Analytics en tant que variable de données contextuelles somevalue avec la valeur 1. Vous pouvez ensuite utiliser une règle de traitement pour affecter cette valeur de variable de données contextuelles à la variable Analytics souhaitée, par exemple une eVar :

Règle de traitement des termes de recherche