Mappage des variables d’objet XDM vers Adobe Analytics

Le tableau suivant présente les variables XDM que l’Edge Network Adobe Experience Platform 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 la variable Modèle ExperienceEvent Adobe Analytics groupe de champs. L’utilisation de ces champs est recommandée si vous envisagez 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 la variable data pour envoyer des données directement à Adobe Analytics sans se conformer à un schéma. Cette stratégie permet à votre entreprise d’utiliser votre propre schéma au lieu d’utiliser la variable Modèle ExperienceEvent Adobe Analytics (qui est moins applicable au Customer Journey Analytics). Voir Mappage des variables d’objet de données vers Adobe Analytics pour un tableau de mappage similaire.

Priorités de valeur

La plupart des champs d’objet XDM de ce tableau correspondent à une 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 des 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.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
La mesure Media Analytics Contenu terminé.
xdm.media.mediaTimed.dropBeforeStart.value
c.a.media.view, c.a.media.timePlayed, c.a.media.play
xdm.media.mediaTimed.federated.value
La mesure Media Analytics Données fédérées.
xdm.media.mediaTimed.firstQuartiles.value
La mesure Media Analytics Marqueur de progression de 25 %.
xdm.media.mediaTimed.mediaSegmentView.value
La mesure Media Analytics Vues de segments de contenu.
xdm.media.mediaTimed.midpoints.value
La mesure Media Analytics Marqueur de progression de 50 %.
xdm.media.mediaTimed.pauseTime.value
La mesure Media Analytics Durée totale de pause.
xdm.media.mediaTimed.pauses.value
La mesure Media Analytics Mise en pause des événements.
xdm.media.mediaTimed.primaryAssetReference.
@id
La dimension Media Analytics ID de ressource.
xdm.media.mediaTimed.primaryAssetReference.
dc:title
La dimension Media Analytics Nom de la vidéo.
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Creator[N].iptc4xmpExt:Name
La dimension Media Analytics Émetteur.
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Episode.iptc4xmpExt:Number
La dimension Media Analytics Épisode.
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Genre
La dimension Media Analytics Genre.
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Rating[N].iptc4xmpExt:RatingValue
La dimension Media Analytics Notation du contenu.
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Season.iptc4xmpExt:Number
La dimension Media Analytics Saison.
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Series.iptc4xmpExt:Identifier
La dimension Media Analytics ID de contenu.
xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Series.iptc4xmpExt:Name
La dimension Media Analytics Affichage.
xdm.media.mediaTimed.primaryAssetReference.
showType
La dimension Media Analytics Type d’affichage.
xdm.media.mediaTimed.primaryAssetReference.
xmpDM:duration
La dimension Media Analytics Longueur de la vidéo.
xdm.media.mediaTimed.primaryAssetViewDetails.
@id
La dimension Media Analytics ID de session de médias.
xdm.media.mediaTimed.primaryAssetViewDetails.
broadcastChannel
La dimension Media Analytics Canal de contenu.
xdm.media.mediaTimed.primaryAssetViewDetails.
broadcastContentType
La dimension Media Analytics Type de contenu.
xdm.media.mediaTimed.primaryAssetViewDetails.
broadcastNetwork
La dimension Media Analytics Réseau.
xdm.media.mediaTimed.primaryAssetViewDetails.
mediaSegmentView.value
La dimension Media Analytics Segment de contenu.
xdm.media.mediaTimed.primaryAssetViewDetails.
playerName
La dimension Media Analytics Nom du lecteur de contenu.
xdm.media.mediaTimed.primaryAssetViewDetails.
playerSDKVersion.version
La dimension Media Analytics Version du SDK.
xdm.media.mediaTimed.primaryAssetViewDetails.
sourceFeed
La dimension Media Analytics Type de flux de médias.
xdm.media.mediaTimed.primaryAssetViewDetails.
streamFormat
La dimension Media Analytics Format de flux.
xdm.media.mediaTimed.progress10.value
La mesure Media Analytics Marqueur de progression de 10 %.
xdm.media.mediaTimed.progress95.value
La mesure Media Analytics Marqueur de progression de 95 %.
xdm.media.mediaTimed.resumes.value
La mesure Media Analytics Reprise du contenu.
xdm.media.mediaTimed.starts.value
La mesure Media Analytics Démarrage des médias.
xdm.media.mediaTimed.thirdQuartiles.value
La mesure Media Analytics Marqueur de progression de 75 %.
xdm.media.mediaTimed.timePlayed.value
La mesure Media Analytics Durée de contenu utilisée.
xdm.media.mediaTimed.totalTimePlayed.value
La mesure Media Analytics Durée des médias utilisée.
xdm.placeContext.geo._schema.latitude
Emplacement de latitude du visiteur. Aide à la définition Emplacement du cycle de vie mobile dimensions.
xdm.placeContext.geo._schema.longitude
Emplacement de longitude du visiteur. Aide à la définition Emplacement du cycle de vie mobile dimensions.
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, telle qu’une eVar:

Règle de traitement des termes de recherche

Mappage 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 la variable 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 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, telle qu’une eVar:

Règle de traitement des termes de recherche

recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690