Configuration d’Adobe Analytics avec Adobe Experience Platform Web SDK
Créé pour :
- Débutant
- Intermédiaire
- Développeur
Découvrez comment configurer Adobe Analytics à l’aide de Adobe Experience Platform Web SDK, créer des règles de balise 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.
Objectifs d’apprentissage
À la fin de cette leçon, vous saurez comment :
- Configurer un flux de données pour activer Adobe Analytics
- Savoir quels champs XDM standard mappent automatiquement aux variables Analytics
- Définition de variables Analytics dans l’objet de données
- Envoyer des données à 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 suivre cette leçon, vous devez d’abord :
-
être familiarisé avec Adobe Analytics et y avoir accès ;
-
Disposer d’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, veuillez en créer une.
-
Suivez les leçons précédentes des sections Configuration initiale et Configuration des balises de ce tutoriel.
Configurer le flux de données
Platform Web SDK envoie des données de votre site Web vers Platform Edge Network. Votre flux de données indique ensuite à Platform Edge Network à quelles suites de rapports Adobe Analytics vos données doivent être envoyées.
-
Accédez à l’interface Collecte de données
-
Dans le volet de navigation de gauche, sélectionnez Flux de données
-
Sélectionnez le flux de données
Luma Web SDK: Development Environmentcréé précédemment
-
Sélectionnez Ajouter un service
-
Sélectionnez Adobe Analytics comme Service
-
Saisissez l’identifiant de suite de rapports de votre suite de rapports de développement
-
Sélectionnez Enregistrer
TIPL’ajout de suites de rapports supplémentaires en sélectionnant Ajouter une suite de rapports équivaut au balisage multisuite.
WARNINGDéfinition des variables Analytics
Il existe plusieurs façons de définir des variables Analytics dans une implémentation de Web SDK :
- Mappage automatique des champs XDM aux variables Analytics (automatique).
- Définissez des champs dans l’objet
data(recommandé). - Mapper des champs XDM aux variables Analytics dans les règles de traitement Analytics (n’est plus recommandé).
- Mappez aux variables Analytics directement dans le schéma XDM (cela n’est plus recommandé).
Depuis mai 2024, il n’est plus nécessaire de créer un schéma XDM pour implémenter Adobe Analytics avec Platform Web SDK. 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 évitera que des données inutiles n’occupent de l’espace dans les profils clients 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 à des variables Analytics. Pour obtenir la liste la plus récente des mappages, 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é. Experience Platform Web SDK collecte automatiquement certaines données et les envoie vers Platform Edge Network sous forme de champs XDM. Par exemple, Web SDK lit l’URL de la page active et l’envoie en tant que web.webPageDetails.URL de champ XDM. Ce champ est transféré vers Adobe Analytics et renseigne automatiquement les rapports URL de la page dans Adobe Analytics.
Si vous implémentez Web SDK 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 œuvre de manière personnalisée sont automatiquement mappés aux variables Analytics, comme indiqué dans ce tableau :
identitymap.ecid.[0].idweb.webPageDetails.nameweb.webPageDetails.serverweb.webPageDetails.siteSectioncommerce.productViews.valuecommerce.productListViews.valuecommerce.checkouts.valuecommerce.purchases.valuecommerce.order.currencyCodecommerce.order.purchaseIDproductListItems[].SKUproductListItems[].nameproductListItems[].quantityproductListItems[].priceTotalLes sections individuelles de la chaîne de produit Analytics sont définies par le biais de différentes variables XDM sous l’objet productListItems .
NOTEproductListItems[].SKU a la priorité pour le mappage au nom du produit dans la variable s.products.>La valeur définie sur
productListItems[].name n’est mappée au nom du produit que si productListItems[].SKU n’existe pas. Sinon, elle n’est pas mappée et est disponible dans les données contextuelles.>Ne définissez pas une chaîne vide ou une valeur nulle sur
productListItems[].SKU. Cela a pour effet indésirable de mapper au 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 Web SDK. La définition de variables dans l’objet de données peut également remplacer n’importe laquelle des variables mappées automatiquement.
Tout d'abord, quel est l'objet data ? Dans n’importe quel événement Web SDK, vous pouvez envoyer deux objets avec des données personnalisées, l’objet xdm et l’objet data. Les 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 l’Edge à des champs xdm à l’aide de la fonctionnalité Préparation des données pour la collecte de données , mais ne sont pas envoyées à Experience Platform. Cela en fait un moyen idéal d’envoyer des données à des applications comme Analytics, qui ne sont pas créées en mode natif sur Experience Platform.
Voici les deux objets d’un appel Web SDK générique :
Adobe Analytics est configuré pour rechercher toutes les propriétés dans l’objet data.__adobe.analytics et les utiliser pour les variables Analytics.
Voyons comment ça fonctionne. Définissons eVar1 et prop1 avec le nom de notre page et voyons comment la valeur mappée par XDM peut être remplacée
- Ouvrez la règle de balise
all pages - library loaded - set global variables - 1 - Ajoutez une nouvelle Action
- Sélectionner l’extension Adobe Experience Platform Web SDK
- Sélectionnez Type d’action comme Variable de mise à jour
- Sélectionnez
data.variablecomme Élément de données - Sélectionnez l’objet analytics
- Définir
eVar1comme élément de donnéespage.pageInfo.pageName - Définir
prop1copier la valeur deeVar1 - Pour tester le remplacement des valeurs mappées XDM, dans la section Propriété supplémentaire définissez le Nom de la page en tant que valeur statique
test - Enregistrer la règle
Désormais, nous devons inclure l’objet de données dans notre règle d’événement d’envoi.
- Ouvrez la règle de balise
all pages - library loaded - send event - 50 - Ouvrez l’action Envoyer l’événement
- Sélectionnez
data.variablecomme Données - Sélectionnez Conserver les modifications
- Sélectionnez Enregistrer
Envoyer les données vers une autre suite de rapports
Vous pouvez modifier les données de suite de rapports Adobe Analytics envoyées à lorsque des visiteurs se trouvent sur certaines pages. Cela nécessite une configuration à la fois dans le flux de données et dans une règle.
Configurer le 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 :
-
Ouvrir le flux de données
-
Modifiez la configuration Adobe Analytics en ouvrant le menu
-
Sélectionnez Options avancées pour ouvrir Remplacements de suites de rapports
-
Sélectionnez les suites de rapports à remplacer. Dans ce cas,
Web SDK Course DevetWeb SDK Course Stg -
Sélectionnez Enregistrer
Configuration d’une règle pour le remplacement d’une 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 du flux de données pour modifier la suite de rapports d’une page à l’aide de l’action Envoyer l’événement.
-
Créez une règle, nommez-la
homepage - library loaded - AA report suite override - 51 -
Sélectionnez le signe plus sous Événement pour ajouter un nouveau déclencheur
-
Sous Extension, sélectionnez Core
-
Sous Type d’événement, sélectionnez Bibliothèque chargée (haut de page)
-
Sélectionnez pour ouvrir Options avancées, puis saisissez
51. Cela garantit que la règle s’exécute après laall pages - library loaded - send event - 50qui définit le XDM de base avec le type d’action Mettre à jour la variable. -
Sélectionnez Conserver les modifications
-
Sous Conditions, sélectionnez pour Ajouter
-
Laissez Type logique sur Standard
-
Laisser Extensions comme Core
-
Sélectionnez Type de condition comme Chemin sans chaîne de requête
-
À droite, laissez le bouton bascule Expression régulière désactivé
-
Sous chemin égal à définissez
/content/luma/us/en.html. Pour le site de démonstration Luma, cela garantit que la règle ne se déclenche que sur la page d’accueil -
Sélectionnez Conserver les modifications
-
Sous Actions sélectionnez Ajouter
-
Sélectionnez Adobe Experience Platform Web SDK en tant qu’extension ****
-
Sélectionnez Type d’action, Envoyer l’événement
-
En tant que données XDM, sélectionnez l’élément de données
xdm.variable.contentque vous avez créé dans la leçon Créer des éléments de données -
En tant que Données, sélectionnez l’élément de données
data.variableque vous avez créé dans la leçon Créer des éléments de données
-
Faites défiler l’écran jusqu’à la section Remplacements des configurations de flux de données
-
Laissez l’onglet Développement sélectionné.
TIPCet onglet détermine dans quel environnement de balises le remplacement a lieu. 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 de production. -
Sélectionnez la Sandbox que vous utilisez pour le tutoriel
-
Sélectionnez le Flux de données, dans ce cas
Luma Web SDK: Development Environment -
Sous Suites de rapports, sélectionnez le site de rapports à remplacer. Dans ce cas,
tmd-websdk-course-stg. -
Sélectionnez Conserver les modifications
-
Et Enregistrer votre règle
Création de votre environnement de développement
Ajoutez les 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 implémentation d’Adobe Analytics via Experience Platform Web SDK.
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 d’e-commerce avec la fonctionnalité 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 manière dont vous déboguez une implémentation d’AppMeasurement.js 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 vérifier qu’Analytics capture correctement des données via Experience Platform Web SDK, vous devez effectuer deux étapes supplémentaires pour :
- Validez le traitement des données par l’objet XDM sur la plateforme Edge Network à l’aide de la fonctionnalité Edge Trace d’Experience Platform Debugger
- Valider le traitement complet des données par Analytics à l’aide d’Adobe Experience Platform Assurance
Validation de l’Experience Cloud ID
-
Accédez au site de démonstration Luma
-
Sélectionnez le bouton de connexion en haut à droite, puis utilisez les informations d’identification u : test@test.com p : test pour l’authentification
-
Ouvrez Experience Platform Debugger et basculez la propriété de balise sur le site vers votre propre propriété de développement
-
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
-
Il sera vide pour l'instant
-
Actualisez la page Luma et vérifiez à nouveau Experience Platform Debugger. Les données devraient passer. La ligne commençant par Mappage automatique Analytics correspond à la balise Adobe Analytics
-
Sélectionnez cette option pour ouvrir les deux
mappedQueryParamsdéroulantes suivantes afin d’afficher les variables Analytics :
TIPLa deuxième liste déroulante correspond à l’identifiant de suite de rapports Analytics à laquelle vous envoyez des données. Elle doit correspondre à votre propre suite de rapports, et non à celle de la capture d’écran. -
Faites défiler la page vers le bas pour trouver des
c.a.x.identitymap.ecid.[0].id. C’est une variable de données contextuelles qui capture l’ECID -
Continuez de faire défiler la page vers le bas jusqu’à afficher la variable Analytics
mid. Les deux ID correspondent à l’ID Experience Cloud de votre appareil. -
Sur le site Luma :
NOTEPuisque vous êtes connecté, prenez le temps de valider l’ID authentifiéb642b4217b34b1e8d3bd915fc65c4452pour l’utilisateurtest@test.comest également capturé dans lec.a.x.identitymap.lumacrmid.[0].id
Validation du remplacement de la suite de rapports
Vous avez configuré ci-dessus un remplacement de flux de données pour la page d’accueil Luma. Pour valider cette configuration
-
Recherchez une ligne avec Configuration du flux de données après l’application du remplacement. Vous trouverez ici la suite de rapports principale et la ou les suites de rapports supplémentaires qui ont été configurées pour les remplacements de la suite de rapports.
-
Faites défiler jusqu’à la ligne commençant par Mappage automatique Analytics et vérifiez que la
reportSuiteIdsaffiche la suite de rapports que vous avez spécifiée dans vos configurations de remplacement
Validation des pages vues du contenu
Accédez à une page produit comme la page produit Didi Sport Watch. Vérifiez que les pages vues du contenu sont capturées par Analytics.
-
Cherchez des
c.a.x.web.webpagedetails.pageviews.value=1. -
Faites défiler la page vers le bas pour afficher la variable
gn. Il s’agit de la syntaxe dynamique Analytics de la variables.pageName. Il capture le nom de la page à partir de la couche de données.
Validation des chaînes de produit et des événements e-commerce
Puisque vous êtes déjà sur une page de produit, cet exercice continue d’utiliser la même Edge Trace pour valider les données de produit capturées par Analytics. La chaîne de produit et les événements d’e-commerce sont automatiquement associés à des variables XDM dans Analytics. Tant que vous avez mappé la variable XDM productListItem appropriée lors de la configuration d’un schéma XDM pour Adobe Analytics, Platform Edge Network s’occupe du mappage des données aux variables d’analyse appropriées.
Vérifiez d’abord que le Product String est défini
-
Cherchez des
c.a.x.productlistitems.[0].sku. La variable capture la valeur de l’élément de données que vous avez mappée auproductListItems.item1.skuplus tôt dans cette leçon -
Cherchez également des
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é àproductListItems.item1._experience.analytics.customdimensions.evars.evar1 -
Faites défiler la page vers le bas pour afficher la variable
pl. Il s’agit de la syntaxe dynamique de la variable de chaîne de produit Analytics -
Notez que le nom du produit de la couche de données est mappé à la fois au paramètre
c.a.x.productlistitems.[0].skuetproductde la chaîne products. En outre, le titre du produit de la couche de données est mappé à l’evar1 de marchandisage dans la chaîne de produits.
Edge Trace traite les événements
commercede manière légèrement différente des dimensionsproductList. Vous ne voyez pas une variable de données contextuelles mappée de la même manière que vous voyez le nom de produit mappé à lac.a.x.productlistitem.[0].nameci-dessus. Au lieu de cela, Edge Trace affiche le mappage automatique de l’événement final dans la variableeventAnalytics. Platform Edge Network le mappe en conséquence, à condition que vous le mappez à la variable decommerceXDM appropriée lors de la configuration du schéma pour Adobe Analytics ; dans ce cas, lecommerce.productViews.value=1. -
De retour dans la fenêtre Experience Platform Debugger, faites défiler l’écran jusqu’à la variable
events, définie surprodView -
Notez également que
c.a.x.eventTypeest défini surcommerce.productViewspuisque vous êtes sur une page produit.TIPLa règleecommerce - pdp library loaded - AA (order 20)remplace la valeur deeventTypedéfinie par la règleall pages global content variables - library loaded - AA (order 1), car elle est définie pour se déclencher plus tard dans la séquence
Validez le reste des événements d’e-commerce et des chaînes de produit définis pour Analytics
-
Ajouter Didi Sport Watch au panier
-
Accédez à la Page du panier, puis vérifiez Edge Trace pour
eventTypedéfini surcommerce.productListViewsevents: "scView", et- la chaîne de produit est définie
-
Passer en caisse, vérifier Edge Trace pour
eventTypedéfini surcommerce.checkoutsevents: "scCheckout", et- la chaîne de produit est définie
-
Renseignez uniquement les champs Prénom et Nom du formulaire d’expédition et sélectionnez Continuer. Sur la page suivante, sélectionnez Passer une commande
-
Sur la page de confirmation, vérifiez Edge Trace pour
eventTypedéfini surcommerce.purchases- Événement d’achat défini
events: "purchase" - Variable de code de devise définie
cc: "USD" - ID d’achat défini dans
pi - Chaîne de produit
pldéfinissant le nom, la quantité et le prix du produit
Validation d’Adobe Analytics à l’aide d’Assurance
Adobe Experience Platform Assurance vous permet de contrôler, de tester, de simuler et de valider la manière dont vous collectez les données ou dont les expériences sont accomplies sur votre site web et votre application mobile.
Dans l’exercice précédent, vous avez validé qu’Adobe Analytics capture l’ECID, les pages vues, la chaîne de produit et les événements d’e-commerce avec la fonctionnalité Edge Trace du débogueur Experience Platform. Vous validez ensuite ces mêmes événements à l’aide d’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 leçon Assurance, il existe plusieurs façons de lancer une session Assurance. Comme Adobe Experience Platform Debugger est déjà ouvert avec une session Edge Trace lancée à partir du dernier exercice, nous vous recommandons d’accéder à Assurance par le biais du débogueur :
Dans la « Tutoriel Web SDK 3 » session Assurance , saisissez « hitdebugger » dans la barre de recherche Événements pour filtrer les résultats selon les données post-traitées Adobe Analytics.
Validation de l’Experience Cloud ID
Pour vérifier qu’Adobe Analytics capture l’ECID, sélectionnez une balise et ouvrez la payload. Le fournisseur de cette balise doit être com.adobe.analytics.hitdebugger
Faites ensuite défiler jusqu’à mcvisId pour vérifier que l’ECID est correctement capturé
Validation des pages vues du contenu
À l’aide de la même balise, vérifiez que les pages vues de contenu sont mappées à la variable Adobe Analytics appropriée.
Faites défiler jusqu’à pageName pour vérifier que le Page Name est correctement capturé
Validation des chaînes de produit et des événements e-commerce
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 le Ecommerce Events et le Product String.
- Recherchez la payload où les événements contiennent des
prodView
- Faites défiler jusqu’à product-string pour valider la
Product String.- Notez les
Product SKUet lesMerchandizing eVar1.
- Notez les
- Faites défiler l’écran vers le bas et vérifiez que
prop1, que vous avez configuré à l’aide des règles de traitement dans la section précédente, contient lesProduct SKU
Continuez à valider votre implémentation en examinant les événements de panier, de passage en caisse et d’achat.
- Recherchez la payload où les événements contiennent des
scViewet validez la chaîne de produit.
- Recherchez la payload où les événements contiennent des
scCheckoutet validez la chaîne de produit.
- Recherchez la payload où les événements contiennent des
purchase
- Lors de la validation de l’événement
purchase, notez que leProduct Stringdoit contenir lesProduct SKU,Product QuantityetProduct Total Price. - En outre, pour les
purchase, vérifiez que lespurchase-idet/ou lespurchaseIdsont définis
Félicitations ! Tu l'as fait ! La leçon est terminée. Vous êtes maintenant prêt à mettre en œuvre Adobe Analytics avec Platform Web SDK pour votre propre site web.
NOTE