Mapper des données de composant à des propriétés Adobe Analytics

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 :

• La page est associée à la structure.
• La page utilise les composants qui sont ajoutés à la structure.

Appliquez la procédure ci-dessous pour mapper des variables de composants CQ à des propriétés de rapport Adobe Analytics.

1. Dans la vue AEM, faites glisser un composant de suivi du sidekick vers le framework. Par exemple, faites glisser le Page du composant Général catégorie.

   

   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.

2. 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.

   

   REMARQUE

   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.

3. Répétez les deux étapes précédentes pour les autres composants et variables.

   REMARQUE

   Vous pouvez mapper plusieurs variables Analytics (par exemple : props, eVars, events) à la même variable CQ (par exemple, pagedata.title)

   ATTENTION

   Il est vivement recommandé de suivre les indications suivantes :

   • Les eVars et les props sont mappées à des variables CQ commençant par pagedata.X ou eventdata.X,
   • tandis que les événements doivent être mappés à des variables commençant par eventdata.events.X.

4. 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.

Mappage de variables liées à des produits

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 :

Plusieurs composants d’AEM Commerce utilisent ces noms de variables.

Vérification des rapports dans Adobe Analytics

1. Connectez-vous au site Web d’Adobe Analytics à l’aide des informations d’identification fournies dans AEM.

2. Assurez-vous que le RSID sélectionné est celui utilisé lors des étapes précédentes.

3. 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.

4. Selon la version d’Adobe Analytics que vous utilisez, vous devez attendre en moyenne 45 minutes que le rapport soit mis à jour avec le terme de recherche utilisé ; par exemple, aubergine dans l’exemple.

Utilisation de l’outil de recherche de contenu (cf#) avec les frameworks Adobe Analytics

Au départ, lorsque vous ouvrez un framework Adobe Analytics, l’outil de recherche de contenu contient des variables Analytics prédéfinies sous :

• Trafic
• Conversion
• Événements

Lorsqu’un RSID est sélectionné, toutes les variables appartenant à ce RSID sont ajoutées à la liste.
La variable cf# est nécessaire pour mapper les variables Analytics aux variables CQ présentes sur 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 :

1. Dans AEM vue, la liste peut être filtrée en fonction du type de variable sélectionné à l'aide des trois boutons de filtrage :

   • Si aucun bouton n’est sélectionné, la liste complète s’affiche.
   • Si vous sélectionnez le bouton Trafic, seules les variables appartenant à la section Trafic sont répertoriées dans la liste…
   • Si vous sélectionnez le bouton Conversion, seules les variables appartenant à la section Conversion sont répertoriées dans la liste.
   • Si la variable Événements est sélectionné, la liste affiche uniquement les variables appartenant à la section Événements .
   REMARQUE

   Un seul bouton de filtre peut être actif à la fois.

   1. La liste comporte également une fonction de recherche qui filtre les éléments en fonction du texte saisi dans le champ de recherche.
   2. Si une option de filtrage est activée lors de la recherche d'éléments dans la liste, les résultats affichés seront également filtrés en fonction du bouton actif.
   3. La liste peut être rechargée à tout moment à l’aide des flèches rapides.
   4. Si plusieurs RSID sont sélectionnés dans la structure, toutes les variables de la liste s’affichent à l’aide de toutes les étiquettes utilisées dans les RSID sélectionnés.

2. 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.

   • Par exemple, dans le cas où la variable Composant de téléchargement est la valeur une seule traînée dans la vue CQ (qui comporte deux variables mappables). eventdata.downloadLink et eventdata.events.startDownload), l’outil de recherche de contenu ressemblera à ceci lors du passage à la vue Adobe Analytics :

   

   • Les variables peuvent être glissées-déposées dans une variable Adobe Analytics appartenant à l’une des trois sections de variable (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.

   REMARQUE

   Une seule variable CQ peut être mappée à une variable Adobe Analytics à un moment donné.

Utilisation de la vue AEM et de la vue Analytics

À tout moment, les utilisateurs peuvent basculer entre deux manières d’afficher les mappages Adobe Analytics sur une page de structure. Les deux vues offrent une meilleure vue d’ensemble des mappages dans la structure, à partir de deux perspectives distinctes.

Vue AEM

En prenant comme exemple l’image ci-dessus, la variable AEM vue possède les propriétés suivantes :

1. Il s’agit de la vue par défaut à l’ouverture de la structure.

2. 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.

3. En-têtes d’onglets (vue AEM et vue Analytics) : à utiliser pour basculer entre les vues.

4. Vue AEM :

   1. Si la structure comporte des composants hérités de son parent, ils sont répertoriés ici, ainsi que les variables mappées aux composants.

      1. Les composants hérités sont verrouillés.
      2. Pour déverrouiller un composant hérité, double-cliquez sur le cadenas en regard de son nom.
      3. Pour rétablir l’héritage, supprimez le composant déverrouillé, après quoi il retrouve son état verrouillé.

   2. Faites glisser des composants ici pour les inclure dans la structure d’analyse.: les composants peuvent être déplacés à partir du Sidekick et déposés ici.

   3. Vous trouverez tous les composants actuellement inclus dans la structure d’analyse :

      1. Pour ajouter un composant, faites-le glisser depuis l’onglet Composants du sidekick.
      2. Pour supprimer un composant et tous ses mappages, sélectionnez Supprimer dans le menu contextuel correspondant, puis acceptez la suppression dans la boîte de dialogue de confirmation.
      3. Gardez à l’esprit qu’un composant ne peut être supprimé que de la structure dans laquelle il a été créé et ne peut pas être supprimé des structures enfants au sens traditionnel du terme (elles ne peuvent être remplacées que).

Vue Analytics

1. Cette vue est accessible en cliquant sur l’onglet vue Analytics du framework.

2. Côté gauche : 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.

3. En-têtes d’onglets (vue AEM et vue Analytics) : à utiliser pour basculer entre les vues.

4. 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 est associé à un cadenas, 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)

     • Variable de conversion ( eVar3) mappé à une expression JavaScript ajoutée en ligne en double-cliquant sur le champ de variable CQ et en saisissant le code manuellement.

   • Événement :

     • Variable d’événement (event1) mappée à un événement CQ (eventdata.events.pageView)