DocumentationExperience PlatformTutoriel du SDK web

Création d’éléments de données

Dernière mise à jour : 31 juillet 2025
  • Rubriques :

Créé pour :

  • Débutant
  • Intermédiaire
  • Développeur

Découvrez comment créer des éléments de données dans les balises pour les données de contenu, de commerce et d’identité sur le site de démonstration Luma. Renseignez ensuite les champs de votre schéma XDM avec le type d’élément de données Variable de l’extension Adobe Experience Platform Web SDK .

Objectifs d’apprentissage

À la fin de cette leçon, vous êtes capable de :

  • Comprendre les différentes approches pour mapper une couche de données à XDM
  • Créer des éléments de données pour capturer des données
  • Mappage d’éléments de données à un objet XDM

Conditions préalables

Vous comprenez ce qu’est une couche de données et avez suivi les leçons précédentes du tutoriel :

  • Configuration d’un schéma XDM
  • Configuration d’un espace de noms d’identité
  • Configurer un trains de données
  • Extension Web SDK installée dans la propriété de balise
IMPORTANT
Les données de cette leçon proviennent de la couche de données digitalData sur le site Luma. Pour afficher la couche de données, ouvrez votre Developer Console et saisissez digitalData pour afficher la couche de données complète disponible. couche de données digitalData

Approches des couches de données

Il existe plusieurs façons de mapper les données de la couche de données à XDM à l’aide de la fonctionnalité de balises de Adobe Experience Platform. Vous trouverez ci-dessous quelques avantages et inconvénients de trois approches différentes. Il est possible de combiner les approches, si désiré :

  1. Implémentation de XDM dans la couche de données
  2. Mapper à XDM dans les balises
  3. Mapper à XDM dans le flux de données
NOTE
Les exemples de ce tutoriel suivent l’approche Mapper à XDM dans les balises .

Implémentation de XDM dans la couche de données

Cette approche implique l’utilisation de l’objet XDM entièrement défini comme structure de votre couche de données. Vous pouvez ensuite mapper l’intégralité de la couche de données à un élément de données d’objet XDM dans les balises. Si votre implémentation n’utilise pas de gestionnaire de balises, cette approche peut être idéale, car vous pouvez envoyer des données à XDM directement à partir de votre application à l’aide de la commande XDM sendEvent. Si vous utilisez des balises, vous pouvez créer un élément de données de code personnalisé capturant l’intégralité de la couche de données en tant qu’objet JSON de transmission au XDM. Ensuite, vous mappez le JSON de transmission au champ d’objet XDM dans l’action Envoyer l’événement.

Vous trouverez ci-dessous un exemple d’utilisation de la couche de données client au format Adobe :

Exemple XDM dans la couche de données
window.adobeDataLayer.push({
"eventType": "web.webPageDetails.pageViews",
"web":{
         "webInteraction":{
            "linkClicks":{
               "id":"",
               "value":""
            },
            "URL":"",
            "name":"",
            "region":"",
            "type":""
         },
         "webPageDetails":{
            "pageViews":{
               "id":"",
               "value":"1"
            },
            "URL":"https://luma.enablementadobe.com/",
            "isErrorPage":"",
            "isHomePage":"",
            "name":"luma:home",
            "server":"enablementadobe.com",
            "siteSection":"home",
            "viewName":""
         },
         "webReferrer":{
            "URL":"",
            "type":""
         }
      }
});

Avantages

  • Élimine les étapes supplémentaires à remapper aux variables de couche de données vers XDM
  • Le déploiement peut être plus rapide si votre équipe de développement web possède également le comportement numérique de balisage

Inconvénients

  • Dépendance complète de l’équipe de développement et du cycle de développement pour la mise à jour des données envoyées à XDM
  • Flexibilité limitée, car XDM reçoit la payload exacte de la couche de données
  • Impossible d’utiliser les fonctionnalités de balises intégrées, telles que le grattage, la persistance et les fonctionnalités pour les déploiements rapides
  • Il est plus difficile d’utiliser la couche de données pour les pixels tiers (mais vous souhaiterez peut-être déplacer ces pixels vers transfert d’événement !
  • Impossible de transformer les données entre la couche de données et XDM

Mappage de la couche de données dans les balises

Cette approche implique le mappage de variables de couche de données OU d’objets de couche de données individuels aux éléments de données dans les balises et, finalement, à XDM. Il s’agit de l’approche traditionnelle de mise en œuvre utilisant un système de gestion des balises.

Avantages

  • L’approche la plus flexible consiste à contrôler des variables individuelles et à transformer des données avant qu’elles ne soient transmises à XDM
  • Peut utiliser les déclencheurs de balises Adobe et la fonctionnalité de grattage pour transmettre des données à XDM
  • Peut mapper des éléments de données à des pixels tiers côté client

Inconvénients

  • Reconstruction de la couche de données en tant qu’éléments de données prend du temps
TIP
Couche de données Google
Si votre organisation utilise déjà Google Analytics et dispose de l’objet DataLayer Google traditionnel sur votre site web, vous pouvez utiliser l’extension Google Data Layer dans les balises. Vous pouvez ainsi déployer la technologie Adobe plus rapidement sans avoir à demander l’assistance de votre équipe informatique. Le mappage de la couche de données Google à XDM suit les mêmes étapes que ci-dessus.

Mapper à XDM dans le flux de données

Cette approche utilise la fonctionnalité intégrée à la configuration du flux de données appelée Préparation des données pour la collecte de données et ignore le mappage des variables de couche de données à XDM dans les balises.

Avantages

  • Flexible car vous pouvez mapper des variables individuelles à XDM
  • Possibilité de calculer de nouvelles valeurs ou transformer des types de données à partir d’une couche de données avant son transfert vers XDM
  • Tirez parti d’une interface utilisateur de mappage pour mapper les champs de vos données source à XDM à l’aide d’une interface utilisateur par pointer-cliquer

Inconvénients

  • Impossible d’utiliser des variables de couche de données comme éléments de données pour les pixels tiers côté client, mais peut les utiliser avec le transfert d’événement
  • Impossible d’utiliser la fonctionnalité de nettoyage de la fonction Balises de Adobe Experience Platform
  • La complexité de maintenance augmente si la couche de données est mappée à la fois dans les balises et dans le flux de données
IMPORTANT
Comme indiqué précédemment, les exemples de ce tutoriel suivent l’approche Mapper à XDM dans les balises .

Créer des éléments de données pour capturer la couche de données

Avant de créer l’objet XDM, créez l’ensemble d’éléments de données suivant pour la couche de données Site de démonstration Luma :

  1. Accédez à Éléments de données et sélectionnez Ajouter un élément de données (ou Créer un nouvel élément de données si la propriété de balise ne contient aucun élément de données existant)

    Créer un élément de données

  2. Nommez l’élément de données page.pageInfo.pageName.

  3. Utilisez la variable JavaScript type d’élément de données pour pointer vers une valeur dans la couche de données de Luma : digitalData.page.pageInfo.pageName

  4. Cochez les cases Forcer les minuscules et Nettoyer le texte pour uniformiser la casse et supprimer les espaces superflus

  5. Laissez None comme paramètre Durée de stockage, car cette valeur est différente sur chaque page

  6. Sélectionnez Enregistrer

    Élément de données Nom de page

Créez ces éléments de données supplémentaires en suivant les mêmes étapes :

  • page.pageInfo.server mappé à
    digitalData.page.pageInfo.server

  • page.pageInfo.hierarchie1 mappé à
    digitalData.page.pageInfo.hierarchie1

  • user.profile.attributes.username mappé à
    digitalData.user.0.profile.0.attributes.username

  • user.profile.attributes.loggedIn mappé à
    digitalData.user.0.profile.0.attributes.loggedIn

  • product.productInfo.sku mappé à digitalData.product.0.productInfo.sku

  • product.productInfo.title mappé à digitalData.product.0.productInfo.title

  • cart.orderId mappé à digitalData.cart.orderId

  • product.category à l’aide du Code personnalisé Type d’élément de données et du code personnalisé suivant pour analyser l’URL du site pour la catégorie de niveau supérieur :

    var cat = location.pathname.split(/[/.]+/);
    if (cat[5] == 'products') {
       return (cat[6]);
    } else if (cat[5] != 'html') {
       return (cat[5]);
    }
    
  • cart.productInfo à l’aide du code personnalisé suivant :

    var cart = digitalData.cart.cartEntries;
    var cartItem = [];
    cart.forEach(function(item, index, array){
    cartItem.push({
    "SKU": item.sku
    });
    });
    return cartItem;
    
  • cart.productInfo.purchase à l’aide du code personnalisé suivant :

    var cart = digitalData.cart.cartEntries;
    var cartItem = [];
    cart.forEach(function(item, index, array){
    var qty = parseInt(item.qty);
    var price = parseInt(item.price);
    cartItem.push({
    "SKU": item.sku,
    "quantity": qty,
    "priceTotal": price
    });
    });
    return cartItem;
    
CAUTION
Le type d'élément de données JavaScript variable traite les références de tableau comme des points au lieu de crochets. Par conséquent, référencer l'élément de données de nom d'utilisateur comme digitalData.user[0].profile[0].attributes.username ne fonctionnera pas.

Créer des éléments de données variables pour XDM et les objets de données

Les éléments de données que vous venez de créer seront utilisés pour créer un objet XDM (pour les applications Platform) et un objet de données (pour Analytics, Target et Audience Manager). Ces objets possèdent leurs propres éléments de données spéciaux appelés Variable, qui sont très faciles à créer.

Pour créer l’élément de données Variable pour XDM, vous devez le lier au schéma que vous avez créé dans la leçon Configurer un schéma :

  1. Sélectionnez Ajouter un élément de données

  2. Nommez votre élément de données xdm.variable.content. Il est recommandé de préfixer avec « xdm » les éléments de données spécifiques à XDM pour mieux organiser votre propriété de balise

  3. Sélectionnez Adobe Experience Platform Web SDK comme extension

  4. Sélectionnez Variable comme Type d’élément de données

  5. Sélectionnez XDM comme propriété

  6. Sélectionnez le Sandbox dans lequel vous avez créé le schéma

  7. Sélectionnez le Schéma approprié, dans ce cas Luma Web Event Data

  8. Sélectionnez Enregistrer

    Élément de données variable pour XDM

Créez ensuite l’élément de données Variable pour votre objet de données :

  1. Sélectionnez Ajouter un élément de données

  2. Nommez votre élément de données data.variable. Il est recommandé de préfixer avec « data » les éléments de données spécifiques à l’objet de données pour mieux organiser votre propriété de balise

  3. Sélectionnez Adobe Experience Platform Web SDK comme extension

  4. Sélectionnez Variable comme Type d’élément de données

  5. Sélectionnez data comme propriété

  6. Sélectionnez les solutions Experience Cloud que vous souhaitez implémenter dans le cadre de ce tutoriel

  7. Sélectionnez Enregistrer

    Élément de données variable pour l’objet de données

À la fin de ces étapes, les éléments de données suivants doivent être créés :

Éléments de données d’extension principaux
Éléments De Données De L’Extension Platform Web SDK
cart.orderId
data.variable
cart.productInfo
xdm.variable.content
cart.productInfo.purchase
page.pageInfo.hierarchie1
page.pageInfo.pageName
page.pageInfo.server
product.category
product.productInfo.sku
product.productInfo.title
user.profile.attributes.loggedIn
user.profile.attributes.username
TIP
Dans une prochaine leçon Créer des règles de balise, vous découvrirez comment les éléments de données Variable vous permettent d’empiler plusieurs règles dans les balises à l’aide du type d’action Mettre à jour la variable.

Une fois ces éléments de données en place, vous êtes prêt à commencer à envoyer des données à Platform Edge Network avec une règle de balises. Mais d’abord, découvrez comment collecter des identités avec Web SDK.

NOTE
Merci d’avoir investi votre temps dans votre apprentissage de Adobe Experience Platform Web SDK. Si vous avez des questions, souhaitez partager des commentaires généraux ou avez des suggestions sur le contenu futur, veuillez les partager dans ce article de discussion de la communauté Experience League
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4