DocumentationExperience PlatformTutoriel du SDK web

Configuration d’Adobe Analytics avec le SDK Web de Adobe Experience Platform

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

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

Découvrez comment configurer Adobe Analytics à l’aide du SDK Web Adobe Experience Platform, créer des règles de balises pour envoyer des données à Adobe Analytics et vérifier qu’Analytics capture les données comme prévu.

Adobe Analytics est une application de pointe qui vous permet de comprendre vos clients en tant que personnes et d’orienter votre activité grâce aux renseignements sur vos clients.

Diagramme SDK Web vers Adobe Analytics

Objectifs d'apprentissage

À la fin de cette leçon, vous saurez comment :

  • Configuration d’un flux de données pour activer Adobe Analytics
  • Identifier les champs XDM standard automatiquement mappés aux variables Analytics
  • Définition des variables Analytics dans l’objet de données
  • Envoi de données vers une autre suite de rapports en remplaçant le flux de données
  • Validation des variables Adobe Analytics à l’aide de Debugger et d’Assurance

Conditions préalables

Pour terminer cette leçon, vous devez d’abord :

  • Familiarisez-vous avec Adobe Analytics et accédez-y.

  • posséder au moins un identifiant de suite de rapports de test/développement. Si vous ne disposez pas d’une suite de rapports de test/développement que vous pouvez utiliser pour ce tutoriel, créez-en une.

  • Suivez les leçons des sections Configuration initiale et Configuration des balises de ce tutoriel.

Configuration du flux de données

Le SDK Web Platform envoie les données de votre site Web à l’Edge Network Platform. Votre flux de données indique ensuite à Platform Edge Network à quelles suites de rapports Adobe Analytics vos données doivent être envoyées.

  1. Accédez à l’interface Collecte de données

  2. Dans le volet de navigation de gauche, sélectionnez Datastreams

  3. Sélectionnez le flux de données Luma Web SDK: Development Environment créé précédemment.

    Sélectionnez la banque de données du SDK Web Luma

  4. Sélectionnez Ajouter un service
    Ajouter un service à la banque de données

  5. Sélectionnez Adobe Analytics comme Service

  6. Saisissez l’identifiant de suite de rapports de votre suite de rapports de développement.

  7. Sélectionnez Save

    Analyse de l’enregistrement de la banque de données

    note tip
    TIP
    L’ajout d’autres suites de rapports en sélectionnant Ajouter une suite de rapports équivaut à un balisage multisuite.
WARNING
Dans ce tutoriel, vous configurez uniquement la suite de rapports Adobe Analytics pour votre environnement de développement. Lorsque vous créez des flux de données pour votre propre site web, vous devez créer des flux de données et des suites de rapports supplémentaires pour vos environnements d’évaluation et de production.

Définition des variables Analytics

Il existe plusieurs façons de définir des variables Analytics dans une implémentation du SDK Web :

  1. Mappage automatique des champs XDM aux variables Analytics (automatique).
  2. Définissez des champs dans l’objet data (recommandé).
  3. Faire correspondre les champs XDM aux variables Analytics dans les règles de traitement Analytics (ce qui n’est plus recommandé).
  4. Associer les variables Analytics directement dans le schéma XDM (ce qui n’est plus recommandé).

Depuis mai 2024, vous n’avez plus besoin de créer un schéma XDM pour mettre en oeuvre Adobe Analytics avec le SDK Web Platform. L’objet data (et l’élément de données data.variable que vous avez créé dans la leçon Créer des éléments de données) peut être utilisé pour définir toutes les variables Analytics personnalisées. La définition de ces variables dans l’objet de données sera familière aux clients Analytics existants, sera plus efficace que l’utilisation de l’interface des règles de traitement et empêchera les données inutiles de prendre de l’espace dans les profils client en temps réel (important si vous disposez de Real-Time Customer Data Platform ou de Journey Optimizer).

Champs mappés automatiquement

De nombreux champs XDM sont automatiquement mappés aux variables Analytics. Pour obtenir la liste des mappages la plus récente, reportez-vous à la section Mappage des variables Analytics dans Adobe Experience Edge.

Cela se produit si même si vous n’avez pas défini de schéma personnalisé. Le SDK Web Experience Platform collecte automatiquement certaines données et les envoie à Platform Edge Network en tant que champs XDM. Par exemple, le SDK Web lit l’URL de la page active et l’envoie en tant que champ XDM web.webPageDetails.URL. Ce champ est transféré à Adobe Analytics et renseigne automatiquement les rapports URL de page dans Adobe Analytics.

Si vous implémentez le SDK Web pour Adobe Analytics avec un schéma XDM, comme vous l’avez fait dans ce tutoriel, certains des champs XDM que vous avez mis en oeuvre automatiquement sont mappés aux variables Analytics, comme indiqué dans ce tableau :

XDM vers les variables mappées automatiquement dans Analytics
Variable Adobe Analytics
identitymap.ecid.[0].id
mid
web.webPageDetails.name
s.pageName
web.webPageDetails.server
s.server
web.webPageDetails.siteSection
s.channel
commerce.productViews.value
prodView
commerce.productListViews.value
scView
commerce.checkouts.value
scCheckout
commerce.purchases.value
Achat
commerce.order.currencyCode
s.currencyCode
commerce.order.purchaseID
s.purchaseID
productListItems[].SKU
s.products=;product name;;; (primary - voir la remarque ci-dessous)
productListItems[].name
s.products=;product name;;; (fallback - voir la remarque ci-dessous)
productListItems[].quantity
s.products=;;quantité du produit;;
productListItems[].priceTotal
s.product=;;;prix du produit;

Les sections individuelles de la chaîne de produit Analytics sont définies par le biais de différentes variables XDM sous l’objet productListItems.

NOTE
À compter du 18 août 2022, productListItems[].SKU aura la priorité pour le mappage au nom du produit dans la variable s.products .
La valeur définie sur productListItems[].name est mappée au nom du produit uniquement si productListItems[].SKU n’existe pas. Dans le cas contraire, il n’est pas mappé et est disponible dans les données contextuelles.
Ne définissez pas de chaîne vide ou de valeur nulle sur productListItems[].SKU. Cela a pour effet indésirable de mapper le nom du produit dans la variable s.products .

Définition de variables dans l’objet de données

Mais qu'en est-il des eVars, des props et des événements ? La définition de variables dans l’objet data est la méthode recommandée pour définir ces variables Analytics avec le SDK Web. La définition de variables dans l’objet de données peut également remplacer l’une des variables mappées automatiquement.

Tout d’abord, qu’est-ce que l’objet data ? Dans tout événement de SDK Web, vous pouvez envoyer deux objets avec des données personnalisées, l’objet xdm et l’objet data. Tous deux sont envoyés à Platform Edge Network, mais seul l’objet xdm est envoyé au jeu de données Experience Platform. Les propriétés de l’objet data peuvent être mappées sur les champs Edge vers xdm à l’aide de la fonction Préparation de données pour la collecte de données , mais ne sont pas envoyées à l’Experience Platform. Cela en fait un moyen idéal d’envoyer des données à des applications telles qu’Analytics, qui ne sont pas créées de manière native sur Experience Platform.

Voici les deux objets d’un appel SDK Web générique :

objets data et xdm

Adobe Analytics est configuré pour rechercher les propriétés de l’objet data.__adobe.analytics et les utiliser pour les variables Analytics.

Maintenant voyons comment ça marche. Définissons eVar1 et prop1 avec notre nom de page et voyons comment la valeur mappée XDM peut être écrasée.

  1. Ouvrez la règle de balise all pages - library loaded - set global variables - 1.
  2. Ajouter une nouvelle Action
  3. Sélectionnez l’extension Adobe Experience Platform Web SDK
  4. Sélectionnez Action Type comme Mise à jour de variable
  5. Sélectionnez data.variable comme élément de données
  6. Sélectionnez l’objet analytics
  7. Définissez eVar1 comme élément de données page.pageInfo.pageName
  8. Définissez prop1 pour copier la valeur de eVar1
  9. Pour tester le remplacement des valeurs mappées XDM, dans la section Additional property , définissez le nom de page comme valeur statique test.
  10. Enregistrer la règle

Maintenant, nous devons inclure l’objet de données dans notre règle d’événement d’envoi.

  1. Ouvrez la règle de balise all pages - library loaded - send event - 50.
  2. Ouvrez l’action Send Event
  3. Sélectionnez data.variable comme Data
  4. Sélectionnez Conserver les modifications
  5. Sélectionnez Save

Envoi de données vers une autre suite de rapports

Vous pouvez modifier les données de suite de rapports Adobe Analytics envoyées aux visiteurs sur certaines pages. Cela nécessite une configuration dans le flux de données et une règle.

Configuration du flux de données pour un remplacement de suite de rapports

Pour configurer le paramètre de remplacement de la suite de rapports Adobe Analytics dans le flux de données :

  1. Ouvrez votre flux de données.

  2. Modifiez la configuration Adobe Analytics en ouvrant le menu more , puis en sélectionnant Modifier

    Remplacer l’ensemble de données

  3. Sélectionnez Options avancées pour ouvrir les remplacements de suites de rapports

  4. Sélectionnez les suites de rapports à remplacer. Dans ce cas, Web SDK Course Dev et Web SDK Course Stg

  5. Sélectionnez Save

    Remplacer l’ensemble de données

Configuration d’une règle pour un remplacement de suite de rapports

Créons une règle pour envoyer un appel de page vue supplémentaire à une autre suite de rapports. Utilisez la fonction de remplacement de la banque de données pour modifier la suite de rapports d’une page à l’aide de l’action Envoyer l’événement.

  1. Créez une nouvelle règle, nommez-la homepage - library loaded - AA report suite override - 51

  2. Sélectionnez le signe plus sous Event pour ajouter un nouveau déclencheur.

  3. Sous Extension, sélectionnez Core

  4. Sous Event Type, sélectionnez Library Loaded (Page Top) (Bibliothèque chargée (Haut de page))

  5. Sélectionnez pour ouvrir Options avancées, saisissez 51. Cela garantit que la règle s’exécute après le all pages - library loaded - send event - 50 qui définit le XDM de base avec le type d’action Mettre à jour la variable.

  6. Sélectionnez Conserver les modifications

    Remplacement de suite de rapports Analytics

  7. Sous Conditions, sélectionnez Ajouter

  8. Laissez Type logique sur Normal

  9. Laissez Extensions comme Core

  10. Sélectionnez Type de condition comme Chemin sans chaîne de requête

  11. À droite, laissez le bouton bascule Regex désactivé

  12. Sous path equals set /content/luma/us/en.html. Pour le site de démonstration Luma, la règle ne se déclenche que sur la page d’accueil.

  13. Sélectionnez Conserver les modifications

    Condition de remplacement de la suite de rapports Analytics

  14. Sous Actions, sélectionnez Ajouter

  15. En tant que extension, sélectionnez Adobe Experience Platform Web SDK

  16. En tant que Type d’action, sélectionnez Envoyer l’événement

  17. En tant que données XDM, sélectionnez l’élément de données xdm.variable.content que vous avez créé dans la leçon Créer des éléments de données.

  18. En tant que Data, sélectionnez l’élément de données data.variable que vous avez créé dans la leçon Créer des éléments de données.

    Remplacement de la banque de données Analytics

  19. Faites défiler l’écran jusqu’à la section Remplacements des configurations de Datastream .

  20. Laissez l’onglet Développement sélectionné.

    note tip
    TIP
    Cet onglet détermine dans quel environnement de balises le remplacement se produit. Pour cet exercice, vous spécifiez uniquement l’environnement de développement, mais lorsque vous déployez ceci en production, pensez à le faire également dans l’environnement Production.

  21. Sélectionnez le sandbox que vous utilisez pour le tutoriel.

  22. Sélectionnez le Datastream, ici Luma Web SDK: Development Environment

  23. Sous Suites de rapports, sélectionnez le site de rapports pour lequel vous souhaitez effectuer le remplacement. Dans ce cas, tmd-websdk-course-stg.

  24. Sélectionnez Conserver les modifications

  25. Et Enregistrer votre règle

    Remplacement de la banque de données Analytics

Créer votre environnement de développement

Ajoutez vos règles mises à jour à votre bibliothèque de balises Luma Web SDK Tutorial et recréez votre environnement de développement.

Félicitations ! L’étape suivante consiste à valider votre mise en oeuvre Adobe Analytics par le biais du SDK Web Experience Platform.

Validation d’Adobe Analytics avec Debugger

Découvrez comment vérifier qu’Adobe Analytics capture l’ECID, les pages vues, la chaîne de produit et les événements de commerce électronique avec la fonction Edge Trace du débogueur Experience Platform.

Dans la leçon Debugger, vous avez appris à inspecter la requête XDM côté client avec Platform Debugger et la console de développement du navigateur, ce qui est similaire à la façon dont vous déboguez une implémentation AppMeasurement.js d’Analytics. Vous avez également appris à valider les requêtes côté serveur de Platform Edge Network envoyées aux applications Adobe et à afficher une payload entièrement traitée à l’aide d’Assurance.

Pour valider qu’Analytics capture correctement les données par le biais du SDK Web Experience Platform, vous devez suivre deux étapes pour :

  1. Validation du traitement des données par l’objet XDM sur l’Edge Network Platform à l’aide de la fonction Edge Trace du débogueur Experience Platform
  2. Validation du traitement complet des données par Analytics à l’aide de Adobe Experience Platform Assurance

Validation des identifiants Experience Cloud

  1. Accédez au site de démonstration Luma

  2. Sélectionnez le bouton de connexion en haut à droite et utilisez les informations d’identification à l’adresse : test@adobe.com p: test pour vous authentifier

  3. Ouvrez le débogueur Experience Platform et basculez la propriété de balise sur le site vers votre propre propriété de développement

  4. Pour activer Edge Trace, accédez à Experience Platform Debugger, dans le volet de navigation de gauche, sélectionnez Journaux, puis sélectionnez l’onglet Edge et sélectionnez Se connecter

    Connecter Edge Trace

  5. Il sera vide pour l’instant.

    Edge Trace connectée

  6. Actualisez la page Luma et vérifiez à nouveau le débogueur Experience Platform, car les données doivent passer. La ligne commençant par Mappage automatique Analytics est la balise Adobe Analytics

  7. Sélectionnez cette option pour ouvrir la liste déroulante mappedQueryParams et la deuxième liste déroulante afin d’afficher les variables Analytics.

    Balise Analytics Edge Trace

    note tip
    TIP
    La deuxième liste déroulante correspond à l’identifiant de suite de rapports Analytics auquel vous envoyez des données. Elle doit correspondre à votre propre suite de rapports, et non à celle de la capture d’écran.

  8. Faites défiler l’écran vers le bas pour trouver c.a.x.identitymap.ecid.[0].id. Il s’agit d’une variable de données contextuelles qui capture ECID.

  9. Continuez à faire défiler l’écran vers le bas jusqu’à ce que la variable Analytics mid s’affiche. Les deux identifiants correspondent à l’identifiant Experience Cloud de votre appareil.

  10. Sur le site Luma,

    ECID Analytics

    note note
    NOTE
    Puisque vous êtes connecté, prenez quelques instants pour valider l’ID authentifié 112ca06ed53d3db37e4cea49cc45b71e pour que l’utilisateur test@adobe.com soit également capturé dans le c.a.x.identitymap.lumacrmid.[0].id

Validation du remplacement de la suite de rapports

Ci-dessus, vous avez configuré un remplacement de la banque de données pour la page d’accueil Luma. Validation de cette configuration

  1. Recherchez une ligne avec la configuration Datastream après l’application du remplacement. Vous y trouverez la suite de rapports principale et les suites de rapports supplémentaires qui ont été configurées pour les remplacements de suite de rapports.

    Validation de la liste de remplacement de la suite de rapports Analytics

  2. Faites défiler l’écran jusqu’à la ligne commençant par Mappage automatique Analytics et vérifiez que reportSuiteIds affiche la suite de rapports que vous avez spécifiée dans vos configurations de remplacement.

    Validation de l’appel de remplacement d’une suite de rapports Analytics

Validation des pages vues du contenu

Accédez à une page de produits telle que la page produit Didi Sport Watch. Vérifiez que les pages vues du contenu sont capturées par Analytics.

  1. Recherchez c.a.x.web.webpagedetails.pageviews.value=1.

  2. Faites défiler l’écran vers le bas pour afficher la variable gn. Il s’agit de la syntaxe dynamique Analytics de la variable s.pageName. Il capture le nom de la page à partir de la couche de données.

    Chaîne de produit Analytics

Validation de la chaîne de produit et des événements de commerce électronique

Comme vous vous trouvez déjà sur une page de produit, cet exercice continue d’utiliser la même trace Edge pour valider que les données de produit sont capturées par Analytics. Les événements de chaîne de produit et de commerce électronique sont automatiquement associés à des variables XDM dans Analytics. Tant que vous avez mappé sur la variable XDM productListItem appropriée lors de la configuration d’un schéma XDM pour Adobe Analytics, l’Edge Network Platform s’occupe de mapper les données sur les variables d’analyse appropriées.

Commencez par valider que le Product String est défini

  1. Recherchez c.a.x.productlistitems.[0].sku. La variable capture la valeur de l’élément de données que vous avez mappée à productListItems.item1.sku plus tôt dans cette leçon.

  2. Recherchez également c.a.x.productlistitems.[0]._experience.analytics.customdimensions.evars.evar1. La variable capture la valeur de l’élément de données que vous avez mappée à productListItems.item1._experience.analytics.customdimensions.evars.evar1.

  3. Faites défiler l’écran vers le bas pour afficher la variable pl. Il s’agit de la syntaxe dynamique de la variable de chaîne de produit Analytics.

  4. Notez que le nom du produit de la couche de données est mappé à la fois au paramètre c.a.x.productlistitems.[0].sku et product de la chaîne products. En outre, le titre du produit de la couche de données est mappé à evar1 de marchandisage dans la chaîne de produits.

    Chaîne de produit Analytics

    Edge Trace traite les événements commerce légèrement différemment des dimensions productList. Vous ne voyez pas de variable de données contextuelles mappée de la même manière que le nom du produit mappé à c.a.x.productlistitem.[0].name ci-dessus. À la place, Edge Trace affiche le mappage automatique de l’événement final dans la variable Analytics event. Platform Edge Network le mappe en conséquence tant que vous mappez à la variable XDM commerce appropriée lors de la configuration du schéma pour Adobe Analytics ; dans ce cas, commerce.productViews.value=1.

  5. De retour dans la fenêtre du débogueur Experience Platform, faites défiler l’écran jusqu’à la variable events, elle est définie sur prodView.

  6. Notez également que c.a.x.eventType est défini sur commerce.productViews puisque vous vous trouvez sur une page de produits.

    note tip
    TIP
    La règle ecommerce - pdp library loaded - AA (order 20) remplace la valeur de eventType définie par la règle all pages global content variables - library loaded - AA (order 1), car elle est définie pour se déclencher ultérieurement dans la séquence.

    Consultation produit Analytics

Validez le reste des événements de commerce électronique et les chaînes de produit sont définies pour Analytics

  1. Ajoutez Didi Sport Watch au panier

  2. Accédez à la page de panier, cochez Edge Trace pour

    • eventType défini sur commerce.productListViews
    • events: "scView" et
    • la chaîne de produit est définie

    Consultation du panier Analytics

  3. Passez à l’extraction, cochez Edge Trace pour

    • eventType défini sur commerce.checkouts
    • events: "scCheckout" et
    • la chaîne de produit est définie

    Passage en caisse Analytics

  4. Renseignez les champs Prénom et Nom du formulaire d’expédition et sélectionnez Continuer. Sur la page suivante, sélectionnez Passer commande

  5. Sur la page de confirmation, vérifiez Edge Trace pour

    • eventType défini sur commerce.purchases
    • Événement d’achat en cours de définition events: "purchase"
    • Variable de code de devise en cours de définition cc: "USD"
    • ID d’achat en cours de définition dans pi
    • Chaîne de produit pl définissant le nom, la quantité et le prix du produit

    Achat Analytics

Validation d’Adobe Analytics à l’aide d’Assurance

Adobe Experience Platform Assurance vous aide à inspecter, à tester, à simuler et à valider la manière dont vous collectez des données ou diffusez des expériences avec votre site web et votre application mobile.

Au cours de l’exercice précédent, vous avez vérifié qu’Adobe Analytics capturait l’ECID, les pages vues, la chaîne de produit et les événements de commerce électronique avec la fonction Edge Trace du débogueur Experience Platform. Ensuite, vous validez ces mêmes événements à l’aide de Adobe Experience Platform Assurance, une autre interface pour accéder aux mêmes données dans Edge Trace.

Comme vous l’avez appris dans la leçon Assurance, il existe plusieurs façons d’initier une session d’assurance. Puisque vous avez déjà ouvert un Adobe Experience Platform Debugger avec une session Edge Trace lancée à partir du dernier exercice, nous vous recommandons d’accéder à Assurance par l’intermédiaire du débogueur :
Assurance via la collecte de données Adobe Experience Platform

Dans le "Tutoriel Web SDK 3" Session d’assurance, entrez "hitdebugger" dans la barre de recherche des événements pour filtrer les résultats sur les données traitées Adobe Analytics Post.
Assurance Adobe des données traitées d’Analytics

Validation des identifiants Experience Cloud

Pour vérifier qu’Adobe Analytics capture l’ECID, sélectionnez une balise et ouvrez la charge utile. Le fournisseur de cette balise doit être com.adobe.analytics.hitdebugger
Validation Adobe Analytics avec Assurance

Faites ensuite défiler l’écran jusqu’à mcvisId pour vérifier que l’ECID est correctement capturé.
Validation des identifiants Experience Cloud avec Assurance

Validation des pages vues du contenu

À l’aide de la même balise, vérifiez que les pages vues du contenu sont mappées à la variable Adobe Analytics correcte.
Faites défiler l’écran jusqu’à pageName pour vérifier que le Page Name est correctement capturé.
Validation du nom de page avec Assurance

Validation de la chaîne de produit et des événements de commerce électronique

En suivant les mêmes cas d’utilisation de validation utilisés lors de la validation avec le débogueur Experience Platform ci-dessus, continuez à utiliser la même balise pour valider les Ecommerce Events et Product String.

  1. Recherchez la payload où les events contiennent prodView
    Validation de chaîne de produit avec assurance
  2. Faites défiler l’écran jusqu’à product-string pour valider le Product String.
    • Notez les Product SKU et Merchandizing eVar1.
  3. Faites défiler la page vers le bas et validez que prop1, que vous avez configuré à l’aide des règles de traitement de la section précédente, contient le Product SKU
    Chaîne de produit avec validation des variables de marchandisage avec assurance

Continuez à valider votre mise en oeuvre en consultant les événements de panier, de passage en caisse et d’achat.

  1. Recherchez la charge utile où les événements contiennent scView et validez la chaîne de produit.
    Validation de chaîne de produit avec assurance
  2. Recherchez la charge utile où les événements contiennent scCheckout et validez la chaîne de produit.
    Validation de chaîne de produit avec assurance
  3. Recherchez la payload où les events contiennent purchase
    Validation de chaîne de produit avec assurance
  4. Lors de la validation de l’événement purchase, notez que Product String doit contenir les éléments Product SKU, Product Quantity et Product Total Price.
  5. En outre, pour le purchase, validez que les purchase-id et/ou purchaseId sont définis.

Félicitations ! Tu l'as fait ! C’est la fin de la leçon et vous êtes maintenant prêt à mettre en oeuvre Adobe Analytics avec le SDK Web Platform pour votre propre site web.

Suivant :

NOTE
Merci d’avoir consacré du temps à l’apprentissage du SDK Web Adobe Experience Platform. Si vous avez des questions, souhaitez partager des commentaires généraux ou avez des suggestions sur le contenu à venir, partagez-les sur cet post de discussion de la communauté Experience League
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4