Ajoutez à la structure des composants qui rassemblent les données à envoyer à Adobe Analytics. Les composants conçus pour collecter des données d’analyse stockent les données dans la variable CQ appropriée. Lorsque vous ajoutez ce type de composant à un framework, celle-ci affiche la liste des variables CQ afin que vous puissiez associer chacune d’elles à la variable Analytics appropriée.
Lorsque la vue AEM est ouverte, les variables Analytics s’affichent dans l’outil de recherche de contenu.
Vous pouvez associer plusieurs variables Analytics à une même variable CQ.
Les données mappées sont envoyées vers Adobe Analytics lorsque la page se charge et que les conditions ci-dessous sont remplies :
Appliquez la procédure ci-dessous pour mapper des variables de composants CQ à des propriétés de rapport Adobe Analytics.
Dans la vue AEM, faites glisser un composant de suivi du sidekick vers le framework. Par exemple, faites glisser le composant Page à partir de la catégorie Général.
Il existe différents groupes de composants par défaut : Général, Commerce, Communities, et Autre. Votre instance AEM peut être configurée de manière à afficher différents groupes et composants.
Pour mapper des variables Adobe Analytics à des variables définies dans le composant, faites glisser une variable Analytics de l’outil de recherche de contenu vers un champ du composant de suivi. Par exemple, faites glisser Page Name (pageName)
vers pagedata.title
.
L’identifiant de suite de rapports (RSID) sélectionné pour le framework détermine les variables Adobe Analytics qui s’affichent dans l’outil de recherche de contenu.
Répétez les deux étapes précédentes pour les autres composants et variables.
Vous pouvez mapper plusieurs variables Analytics (par exemple, props
, eVars
, events
) à une même variable CQ (par exemple, pagedata.title
).
Il est vivement recommandé de suivre les indications suivantes :
eVars
et les props
sont mappées à des variables CQ commençant par pagedata.X
ou eventdata.X
,eventdata.events.X
.Pour rendre le framework disponible sur l’instance de publication de votre site, affichez l’onglet Page du sidekick et cliquez sur Activer le cadre.
AEM utilise une convention pour nommer les variables liées à des produits et à des événements censés être mappés à des propriétés liées à des produits Adobe Analytics :
Variable CQ | Variable Analytics | Description |
---|---|---|
product.category |
product.category (variable de conversion) |
Catégorie de produits. |
product.sku |
product.sku (variable de conversion) |
SKU du produit. |
product.quantity |
product.quantity (variable de conversion) |
Nombre de produits achetés. |
product.price |
product.price (variable de conversion) |
Prix du produit. |
product.events.<eventName> |
Événements de succès à associer au produit dans votre rapport. | product.events est le préfixe des événements appelés eventName. |
product.evars.<eVarName> |
Variable(s) de conversion (eVar ) à associer au produit. |
product.evars est le préfixe des variables eVar appelées eVarName. |
Plusieurs composants d’AEM Commerce utilisent ces noms de variables.
Ne mappez pas la propriété Products Adobe Analytics à une variable CQ. La configuration de mappages liés à un produit, comme indiqué dans le tableau, s’apparente au mappage de la variable Products.
Connectez-vous au site Web d’Adobe Analytics à l’aide des informations d’identification fournies dans AEM.
Assurez-vous que le RSID sélectionné est celui utilisé lors des étapes précédentes.
Dans Rapports (dans la partie gauche de la page), sélectionnez Conversion personnalisée, puis Conversion personnalisée 1-10 et sélectionnez la variable correspondant à eVar7
.
En fonction de la version d’Adobe Analytics que vous utilisez, vous devez attendre 45 minutes, en moyenne, pour que le rapport soit mis à jour avec le terme recherché utilisé, par exemple, « aubergine » dans l’exemple.
Au départ, lorsque vous ouvrez un framework Adobe Analytics, l’outil de recherche de contenu contient des variables Analytics prédéfinies sous :
Lorsqu’un RSID est sélectionné, toutes les variables appartenant à ce RSID sont ajoutées à la liste.
L’élément cf#
est nécessaire pour mapper des variables Analytics aux variables CQ présentes dans les différents composants de suivi. Consultez Configuration d’un framework pour le suivi de base.
En fonction de la vue sélectionnée pour le framework, l’outil de recherche de contenu est renseigné par des variables Analytics (dans la vue AEM) ou des variables CQ (dans la vue Analytics).
La liste peut être manipulée comme suit :
Lorsque vous accédez à la vue AEM, la liste peut être filtrée en fonction du type de variable sélectionné à l’aide des trois boutons de filtre :
Un seul bouton de filtre peut être actif à la fois.
Dans la vue Adobe Analytics, l’outil de recherche de contenu répertorie toutes les variables CQ appartenant aux composants de suivi que vous faites glisser dans la vue CQ.
Vous pouvez faire glisser et déposer les variables sur une variable Adobe Analytics appartenant à l’une des 3 sections de variables (Trafic, Conversion et Événements).
Lorsque vous faites glisser un nouveau composant de suivi sur le framework dans la vue CQ, les variables CQ appartenant au composant sont ajoutées automatiquement à l’outil de recherche de contenu (cf#) dans la vue Adobe Analytics.
Une seule variable CQ peut être mappée à la fois à une variable Adobe Analytics.
À tout moment, les utilisateurs ont la possibilité d’alterner entre les deux vues des mappages Adobe Analytics dans une page du framework. Les deux vues offrent une meilleure présentation des mappages dans le framework, de deux points de vue différents.
En prenant comme exemple l’image ci-dessus, la vue AEM possède les propriétés suivantes :
Voici la vue par défaut à l’ouverture de la structure.
Sur la gauche de l’écran : l’outil de recherche de contenu (cf#) est renseigné par des variables Adobe Analytics en fonction des RSID sélectionnés.
En-têtes d’onglets (vue AEM et vue Analytics) : à utiliser pour basculer entre les vues.
Vue AEM :
Si la structure contient des composants hérités du parent, ils sont répertoriés à cet endroit, avec les variables mappées aux composants.
Faites glisser des composants ici pour les inclure dans la structure d’analyse : vous pouvez faire glisser et déposer les composants du Sidekick à cet emplacement.
Vous pouvez trouver tous les composants actuellement inclus dans la structure d’analyse :
Cette vue est accessible en cliquant sur l’onglet vue Analytics du framework.
Sur la gauche de l’écran : outil de recherche de contenu (cf#) renseigné par des variables CQ en fonction des composants déplacés sur la structure dans la vue CQ.
En-têtes d’onglets (vue AEM et vue Analytics) : à utiliser pour basculer entre les vues.
Les trois tableaux (Trafic, Conversion, Événement) répertorient toutes les variables Adobe Analytics disponibles des RSID sélectionnés. Les mappages affichés ici doivent être identiques à ceux de la vue AEM :
Trafic :
Variable de trafic (prop1
) mappée à une variable CQ (eventdata.downloadLink
)
Lorsque le composant comporte un cadenas en regard de son nom, cela signifie qu’il est hérité d’une structure parente et ne peut donc pas être modifié.
Conversion :
Variable de conversion (eVar1
) mappée à une variable CQ (pagedata.title
)
La variable de conversion (eVar3
) est mappée à une expression JavaScript ajoutée en ligne en double-cliquant dans le champ Variable CQ et en saisissant manuellement le code.
Événement :
event1
) mappée à un événement CQ (eventdata.events.pageView
)La colonne Variable CQ de chaque tableau peut également être renseignée en ligne en double-cliquant dans le champ et en ajoutant du texte. Ces champs acceptent la saisie de code JavaScript.
Par exemple, à côté de prop3
, vous pouvez ajouter :
'
* Adobe:'+pagedata.title+':'+pagedata.sitesection
pour envoyer la variable title d’une page concaténé avec sa variable sitesection à l’aide d’un : (deux-points) et précédé du préfixe Adobe en tant que prop3
.
Une seule variable CQ peut être mappée à la fois à une variable Adobe Analytics.