Connexion à Adobe Analytics et création de frameworks

Pour effectuer le suivi des données Web de vos pages AEM dans Adobe Analytics, créez une configuration de services cloud Adobe Analytics et un framework Adobe Analytics :

  • Configuration Adobe Analytics : informations sur votre compte Adobe Analytics. La configuration Adobe Analytics permet à AEM de se connecter à Adobe Analytics. Créez une configuration Adobe Analytics pour chaque compte que vous utilisez.
  • Framework Adobe Analytics : ensemble de mappages entre les propriétés de suite de rapports Adobe Analytics et les variables CQ. Utilisez un framework pour configurer la façon dont les données de votre site Web renseignent vos rapports Adobe Analytics. Les frameworks sont associés à une configuration Adobe Analytics. Vous pouvez créer plusieurs frameworks pour chaque configuration.

Lorsque vous associez une page web à une structure, cette structure effectue le suivi pour cette page et ses descendants. Les vues de page peuvent ensuite être récupérées dans Adobe Analytics et affichées dans la console Sites.

Prérequis

Compte Adobe Analytics

Pour effectuer le suivi des données AEM dans Adobe Analytics, vous devez disposer d’un compte Adobe Analytics Adobe Marketing Cloud valide.

Le compte Adobe Analytics doit :

  • disposer d’autorisations Administrateur ;
  • être affecté au groupe d’utilisateurs Accès aux services Web.
ATTENTION

Le fait de fournir des autorisations Administrateur (dans Adobe Analytics) ne suffit pas pour permettre à l’utilisateur de se connecter d’AEM à Adobe Analytics. Le compte doit également disposer d’autorisations Accès aux services web.

chlimage_1-316

Avant de poursuivre, vérifiez que vos informations d’identification vous permettent de vous connecter à Adobe Analytics à l’aide de l’une des méthodes suivantes :

Configuration d’AEM pour utiliser vos centres de données Adobe Analytics

Les centres de données Adobe Analytics collectent, traitent et stockent les données associées à votre suite de rapports Adobe Analytics. Vous devez configurer AEM pour utiliser le centre de données qui héberge votre suite de rapports Adobe Analytics. Le tableau suivant répertorie les centres de données disponibles et leur URL.

Centre de données URL
San Jose https://api.omniture.com/admin/1.4/rest/
Dallas https://api2.omniture.com/admin/1.4/rest/
Londres https://api3.omniture.com/admin/1.4/rest/
Singapour https://api4.omniture.com/admin/1.4/rest/
Oregon https://api5.omniture.com/admin/1.4/rest/

AEM utilise le centre de données de San Jose (https://api.omniture.com/admin/1.4/rest/) par défaut.

Utilisez la console Web pour configurer le client HTTP Adobe AEM Analytics du lot OSGi. Ajoutez l’URL du centre de données du centre de données qui héberge une suite de rapports pour laquelle vos pages AEM collectent des données.

aa-07

  1. Ouvrez la console Web dans votre navigateur Web. (http://localhost:4502/system/console/configMgr)

  2. Entrez vos informations d’identification pour accéder à la console.

    REMARQUE

    Contactez l’administrateur de votre site web pour savoir si vous avez accès à cette console.

  3. Sélectionnez l’élément de configuration nommé Client HTTP Adobe AEM Analytics.

  4. Pour ajouter l’URL d’un centre de données, appuyez sur le bouton + situé en regard de la liste URL de centre de données, puis saisissez l’URL dans la boîte de dialogue.

  5. Pour supprimer une URL de la liste, cliquez sur le bouton - situé en regard de l’URL.

  6. Cliquez sur Enregistrer.

Configuration de la connexion à Adobe Analytics

ATTENTION

En raison de modifications de sécurité dans l’API Adobe Analytics, il n’est plus possible d’utiliser la version d’Activity Map incluse dans AEM.

Le plug-in ActivityMap fourni par Adobe Analytics doit désormais être utilisé.

Configuration pour Activity Map

ATTENTION

En raison de modifications de sécurité dans l’API Adobe Analytics, il n’est plus possible d’utiliser la version d’Activity Map incluse dans AEM.

Le plug-in ActivityMap fourni par Adobe Analytics doit désormais être utilisé.

Création d’un framework Adobe Analytics

Pour l’identifiant de suite de rapports (RSID) que vous utilisez, vous pouvez contrôler quelles instances de serveur (création, publication ou les deux) contribuent aux données de la suite de rapports :

  • Tout : les informations de l’instance de création et de publication renseignent la suite de rapports.
  • Création : seules les informations de l’instance de création renseignent la suite de rapports.
  • Publication : seules les informations de l’instance de publication renseignent la suite de rapports.
REMARQUE

La sélection du type d’instance de serveur ne restreint pas les appels à Adobe Analytics, mais contrôle simplement quels appels incluent le RSID.

Par exemple, une structure est configurée pour utiliser la suite de rapports diiweretail et l’instance de serveur sélectionnée est l’instance de création. Lorsque les pages sont publiées avec la structure, les appels sont toujours émis vers Adobe Analytics, mais ces appels ne contiennent pas le RSID. Seuls les appels effectués à partir de l’instance de création incluent le RSID.

  1. Avec la Navigation, sélectionnez Outils, Services cloud, puis Services cloud hérités.

  2. Faites défiler jusqu’à Adobe Analytics et cliquez sur [+] en regard de Configurations disponibles.

  3. Cliquez sur le bouton [+] lien en regard de votre configuration Adobe Analytics.

  4. Dans la boîte de dialogue Créer une structure :

    • Spécifiez un Titre.
    • Vous pouvez éventuellement spécifier le Nom, pour le nœud qui stocke les détails de la structure dans le référentiel.
    • Sélectionnez Framework Adobe Analytics,

    puis cliquez sur Créer.

    Le framework s’ouvre en vue de la modification.

  5. Dans la section Suites de rapports de la capsule latérale (côté droit du panneau principal), cliquez sur Ajouter un élément. Utilisez ensuite le menu déroulant pour sélectionner l’identifiant de suite de rapports (par exemple, geometrixxauth) avec lequel le framework interagira.

    REMARQUE

    L’outil de recherche de contenu situé à gauche est renseigné avec les variables Adobe Analytics (variables SiteCatalyst) lorsque vous sélectionnez un identifiant de suite de rapports.

  6. Utilisez ensuite le menu déroulant Mode d’exécution (situé à côté de l’identifiant de suite de rapports) pour sélectionner les instances de serveur qui doivent envoyer des informations à la suite de rapports.

    aa-framework-01

  7. Pour que le framework soit disponible sur l’instance de publication de votre site, dans l’onglet Page du sidekick, cliquez sur Activer le framework.

Configuration des paramètres de serveur pour Adobe Analytics

Le système de framework vous permet de modifier les paramètres de serveur dans chaque framework Adobe Analytics.

ATTENTION

Ces paramètres déterminant où vos données sont envoyées et comment, il est impératif de ne pas les modifier vous-même et de laisser votre représentant Adobe Analytics les configurer.

Commencez par ouvrir le panneau. Appuyez sur la flèche vers le bas située en regard de Serveurs :

server_001

  • Serveur de suivi

    • Contient l’URL utilisée pour envoyer les appels Adobe Analytics.

      • cname : valeur par défaut du compte Adobe Analytics *Nom de la société *
      • d1 : correspond au centre de données auquel les informations seront envoyées (il peut s’agir de d1, d2 ou d3)
      • sc.omtrdc.net : nom de domaine
  • Serveur de suivi sécurisé

    • Comporte les mêmes segments que le serveur de suivi
    • Ceci permet d’envoyer les données à partir des pages sécurisées (https://)
  • Espace de noms du visiteur

    • L’espace de noms détermine la première partie de l’URL de suivi.
    • Par exemple, si l’espace de noms est redéfini sur CNAME, les appels effectués vers Adobe Analytics ressembleront à​CNAME.d1.omtrdc.net plutôt qu’à la valeur par défaut.

Association d’une page à un framework Adobe Analytics

Lorsqu’une page est associée à un framework Adobe Analytics, elle envoie des données à Adobe Analytics lors de son chargement. Les variables que la page renseigne sont mappées et extraites des variables Adobe Analytics dans la structure. Par exemple, les pages vues sont extraites d’Adobe Analytics.

Les descendants de la page héritent de l’association avec la structure. Par exemple, lorsque vous associez la page racine de votre site à une structure, toutes les pages du site sont associées à cette structure.

  1. Dans la console Sites, sélectionnez la page dont vous souhaitez configurer le suivi.

  2. Ouvrez les Propriétés de la page, directement à partir de la console ou via l’éditeur de page.

  3. Ouvrez l’onglet Services Cloud.

  4. Utilisez le menu déroulant Ajouter une configuration pour sélectionner Adobe Analytics parmi les options disponibles. Si l’héritage est en place, vous devez le désactiver pour que le sélecteur devienne disponible.

  5. Le sélecteur déroulant pour Adobe Analytics est ajouté aux options disponibles. Utilisez-le pour sélectionner la configuration de framework requise.

  6. Sélectionnez Enregistrer et fermer.

  7. Publiez la page pour activer la page et tous les fichiers/configurations connecté(e)s.

  8. La dernière étape consiste à visiter la page sur l’instance de publication et à rechercher un mot-clé (par exemple, aubergine) à l’aide du composant Rechercher.

  9. Vous pouvez ensuite vérifier les appels effectués à Adobe Analytics à l’aide d’un outil approprié, par exemple Adobe Experience Cloud Debugger.

  10. Dans l’exemple fourni, l’appel doit contenir la valeur entrée (c’est-à-dire, aubergine) dans eVar7 et la liste des événements doit contenir event3.

Pages vues

Lorsqu’une page est associée à un framework Adobe Analytics, le nombre de pages vues peut être affiché dans le mode liste de la console Sites.

Voir Affichage des données d’analyse de page pour plus de détails.

Configuration de l’intervalle d’importation

Configurez l’instance appropriée du service Configurations d’interrogation personnalisées Adobe AEM :

  • Intervalle d'interrogation:

    Intervalle, en secondes, auquel le service récupère les données de page vue d’Adobe Analytics.

    L’intervalle par défaut est de 43 200 000 ms (12 heures).

  • Activer:

    Activez ou désactivez le service. Par défaut, le service est activé.

Pour configurer ce service OSGi, vous pouvez utiliser la console Web ou un nœud osgiConfig dans le référentiel (le PID de service est com.day.cq.polling.importer.impl.ManagedPollConfigImpl).

Modification de configurations et/ou de structures Adobe Analytics

Comme pour la création d’une configuration ou d’une structure Adobe Analytics, accédez à l’écran Services cloud (hérité). Sélectionnez Afficher les configurations, puis cliquez sur le lien vers la configuration que vous souhaitez mettre à jour.

Lorsque vous modifiez une configuration Adobe Analytics, vous devez également appuyer sur le bouton Modifier sur la page de configuration elle-même afin d’ouvrir la boîte de dialogue Modifier le composant.

Suppression de structures Adobe Analytics

Pour supprimer une structure Adobe Analytics, ouvrez-la d’abord pour la modifier.

Sélectionnez ensuite Supprimer le framework dans l’onglet Page du sidekick.

Sur cette page