Connexion à Adobe Analytics et création de structures

Pour suivre les données Web de vos pages AEM dans Adobe Analytics, créez une configuration Adobe Analytics Cloud Services et une structure Adobe Analytics :

  • Configuration Adobe Analytics : informations relatives à 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.
  • Adobe Analytics Framework : ensemble de mappages entre les propriétés de la suite de rapports Adobe Analytics et les variables CQ. Utilisez une structure pour configurer la façon dont les données de votre site web renseignent vos rapports Adobe Analytics. Les cadres sont associés à une configuration Adobe Analytics. Vous pouvez créer plusieurs structures 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.

Conditions préalables

Compte Adobe Analytics

Pour effectuer le suivi des données AEM dans Adobe Analytics, vous devez disposer d’un compte 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 continuer, assurez-vous que vos informations d’identification vous permettent de vous connecter à Adobe Analytics en utilisant l’une des méthodes suivantes :

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

Adobe Analytics datacenters collecte, traite et stocke 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 pour le 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 + en regard de la liste URL des centres de données, puis saisissez l’URL dans la zone.

  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 module externe ActivityMap fourni par Adobe Analytics doit maintenant ê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 module externe ActivityMap fourni par Adobe Analytics doit maintenant être utilisé.

Création d’une structure 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. Accédez à Adobe Analytics et cliquez sur [+] en regard de Configurations disponibles.

  3. Cliquez sur le 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 Adobe Analytics Framework

    puis cliquez sur Créer.

    La structure 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 la liste déroulante pour sélectionner l’identifiant de suite de rapports (par exemple, geometrixxauth) avec lequel la structure interagira.

    REMARQUE

    L’outil de recherche de contenu situé à gauche est renseigné par des variables Adobe Analytics (variables de 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 rendre la structure disponible sur l’instance de publication de votre site, dans l’onglet Page du sidekick, cliquez sur Activer la structure.

Configuration des paramètres de serveur pour Adobe Analytics

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

ATTENTION

Ces paramètres déterminent l'emplacement et le mode d'envoi des données. Il est donc impératif que vous ne modifiez pas ces paramètres et que votre représentant Adobe Analytics les configurez à la place.

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 des appels Adobe Analytics

      • cname - valeur par défaut du *nom de Société * du compte Adobe Analytics
      • 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 vous modifiez l’espace de nommage en CNAME, les appels effectués à Adobe Analytics ressembleront à CNAME.d1.omtrdc.net au lieu de <a3/> par défaut.

Association d’une page à une structure Adobe Analytics

Lorsqu’une page est associée à une structure Adobe Analytics, la page envoie des données à Adobe Analytics au chargement de la page. 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 à configurer avec 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 la liste déroulante Ajouter la configuration pour sélectionner Adobe Analytics dans 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 structure 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 à Adobe Analytics à l'aide d'un outil approprié ; par exemple, Débogueur Adobe Experience Cloud.

  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 à une structure Adobe Analytics, le nombre de vues de page peut être affiché dans la vue de 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 vue de page de 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 noeud 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.

Lors de la modification d’une configuration Adobe Analytics, vous devez également appuyer sur le bouton Modifier dans la page de configuration 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 l’infrastructure dans l’onglet Page du sidekick.

Sur cette page