DocumentationExperience PlatformTutoriel du SDK web

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

Last update: Sat Jun 01 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 de SDK Web Adobe Experience Platform, créez des règles de balise pour envoyer des données à Adobe Analytics et vérifiez 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 à Collecte de données interface

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

  3. Sélectionnez la Luma Web SDK: Development Environment datastream

    Sélectionnez la flux de données du SDK Web Luma.

  4. Sélectionner Ajouter un service
    Ajout d’un service au flux de données

  5. Sélectionner Adobe Analytics comme la propriété Service

  6. Saisissez le Identifiant de suite de rapports de votre suite de rapports de développement

  7. Sélectionner Enregistrer

    Analyse de l’enregistrement des flux de données

    note tip
    TIP
    Pour ajouter d’autres suites de rapports, sélectionnez Ajouter une suite de rapports équivaut au 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éfinir les champs dans la variable 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. La variable data (et l’objet data.variable élément de données que vous avez créé dans la variable Création d’éléments de données leçon) 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 la variable productListItems .

NOTE
Depuis le 18 août 2022, productListItems[].SKU est prioritaire pour le mappage au nom du produit dans la variable s.products .
La valeur définie sur productListItems[].name est mappé sur le 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 ni 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 ? Définition de variables dans la variable data constitue 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 la data objet ? Dans n’importe quel événement SDK Web, vous pouvez envoyer deux objets avec des données personnalisées : xdm et la variable data . Les deux sont envoyés à Platform Edge Network, mais uniquement à la variable xdm est envoyé au jeu de données Experience Platform. Propriétés de la variable data peut être mappé sur l’Edge sur xdm les champs utilisant la fonction Préparation de données pour la collecte de données , mais ne sont pas envoyés à 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 toutes les propriétés dans la variable 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 découvrez comment la valeur mappée XDM peut être écrasée.

  1. Ouvrir la règle de balise all pages - library loaded - set global variables - 1
  2. Ajouter un nouveau Action
  3. Sélectionner SDK Web Adobe Experience Platform extension
  4. Sélectionner Type d’action as Mettre à jour la variable
  5. Sélectionner data.variable comme la propriété Élément de données
  6. Sélectionnez la variable analytics objet
  7. Définir eVar1 comme la propriété page.pageInfo.pageName élément de données
  8. Définir prop1 pour copier la valeur de eVar1
  9. Pour tester le remplacement des valeurs mappées XDM, dans la variable Propriété supplémentaire Définissez le nom de la 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. Ouvrir la règle de balise all pages - library loaded - send event - 50
  2. Ouvrez le Envoyer un événement action
  3. Sélectionner data.variable comme la propriété Données
  4. Sélectionner Conserver les modifications
  5. Sélectionner Enregistrer

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 variable Adobe Analytics en ouvrant la more puis en sélectionnant Modifier

    Remplacer le flux de données

  3. Sélectionner Options avancées pour ouvrir 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électionner Enregistrer

    Remplacer le flux 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 la variable Envoyer un événement Action.

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

  2. Sélectionnez le signe plus sous Événement pour ajouter un nouveau déclencheur

  3. Sous Extension, sélectionnez Core

  4. Sous Type d’événement, sélectionnez Bibliothèque chargée (Haut de page)

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

  6. Sélectionner Conserver les modifications

    Remplacement de suites de rapports Analytics

  7. Sous Conditions, sélectionnez sur Ajouter

  8. Laisser Type de logique as Normal

  9. Laisser Extensions as Core

  10. Sélectionner Type de condition as Chemin sans chaîne de requête

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

  12. Sous path est égal à 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électionner Conserver les modifications

    Condition de remplacement de la suite de rapports Analytics

  14. Sous Actions select Ajouter

  15. Comme la variable Extension, sélectionnez SDK Web Adobe Experience Platform

  16. Comme la variable Type d’action, sélectionnez Envoyer un événement

  17. Comme la variable Données XDM, sélectionnez la variable xdm.variable.content élément de données que vous avez créé dans la variable Création d’éléments de données leçon

  18. Comme la variable Données, sélectionnez la variable data.variable élément de données que vous avez créé dans la variable Création d’éléments de données leçon

    Remplacement de la banque de données Analytics

  19. Faites défiler l’écran vers le bas jusqu’à Remplacements des configurations de flux de données section

  20. Laissez le champ Développement onglet sélectionné.

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

  21. Sélectionnez la variable Sandbox que vous utilisez pour le tutoriel

  22. Sélectionnez la variable Datastream, dans ce cas Luma Web SDK: Development Environment

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

  24. Sélectionner 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 à vos Luma Web SDK Tutorial bibliothèque de balises 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 le Debugger leçon, 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 AppMeasurement.js Mise en oeuvre 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 sur 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 la variable Edge et sélectionnez Connexion

    Connexion à Edge Trace

  5. Il sera vide pour l’instant.

    Trace Edge 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 les deux mappedQueryParams Liste déroulante et deuxième liste déroulante pour 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. Faire défiler 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 vous voyiez Analytics mid Variable . Les deux identifiants correspondent à l’identifiant Experience Cloud de votre appareil.

  10. Sur le site Luma,

    Analytics ECID

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

Validation du remplacement de la suite de rapports

Au-dessus, vous avez configuré un remplacement de la chaîne de données pour la variable Page d’accueil Luma. Validation de cette configuration

  1. Recherchez une ligne avec Configuration du flux de données après 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 d’une suite de rapports Analytics

  2. Faites défiler l’écran jusqu’à la ligne commençant par Mappage automatique Analytics et vérifiez que la variable 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 produit telle que 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 gn Variable . Il s’agit de la syntaxe dynamique Analytics de la variable s.pageName Variable . 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 le productListItem Variable XDM pendant configuration d’un schéma XDM pour Adobe Analytics, l’Edge Network Platform s’occupe de mapper les données aux variables d’analyse appropriées.

Commencez par valider que la variable 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 à la variable 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 auquel vous avez mappé productListItems.item1._experience.analytics.customdimensions.evars.evar1

  3. Faites défiler l’écran vers le bas pour afficher la pl Variable . 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 à la c.a.x.productlistitems.[0].sku et la variable product du paramètre 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

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

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

  6. Remarque c.a.x.eventType est défini sur commerce.productViews car vous vous trouvez sur une page de produits.

    note tip
    TIP
    La variable ecommerce - pdp library loaded - AA (order 20) la règle remplace la valeur de eventType défini par la variable 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 produits définis pour Analytics.

  1. Ajouter Didi Sport Watch au panier

  2. Accédez au Page Panier, vérifiez Edge Trace pour

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

    Vue 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. Remplissez uniquement les Prénom et Nom champs 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"
    • Identifiant d’achat défini dans pi
    • Chaîne de produit pl définition du nom, de la quantité et du 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 permettant d’accéder aux mêmes données dans Edge Trace.

Comme vous l’avez appris dans la Assurance leçon : 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 du SDK Web 3" Entrée de la session d’assurance "hitdebugger" dans la barre de recherche des événements pour filtrer les résultats sur les données Adobe Analytics Post-traitées.
Assurance Adobe des données après traitement 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 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 jusqu’à pageName pour valider que la variable 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 la variable Ecommerce Events et la variable Product String.

  1. Recherchez la payload où l’événement events contain prodView
    Validation de la chaîne de produit avec Assurance
  2. Faites défiler jusqu’à product-string pour valider la variable Product String.
    • Notez que Product SKU et Merchandizing eVar1.
  3. Faites défiler l’écran vers le bas et validez prop1, que vous avez configuré à l’aide des règles de traitement de la section précédente, contient la variable 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 payload où l’événement events contain scView et validez la chaîne de produit.
    Validation de la chaîne de produit avec Assurance
  2. Recherchez la payload où l’événement events contain scCheckout et validez la chaîne de produit.
    Validation de la chaîne de produit avec Assurance
  3. Recherchez la payload où l’événement events contain purchase
    Validation de la chaîne de produit avec Assurance
  4. Lors de la validation de la variable purchase , notez que la variable Product String doit contenir la variable Product SKU, Product Quantity , et Product Total Price.
  5. En outre, pour la variable purchase validez la variable 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 futur, partagez-les à ce sujet. Article de discussion de la communauté Experience League
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4