Connexion à Adobe Analytics et création de frameworks connecting-to-adobe-analytics-and-creating-frameworks

CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

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, celle-ci 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 prerequisites

Compte Adobe Analytics adobe-analytics-account

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.
CAUTION
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 avoir Accès aux services web des privilèges.

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 configuring-aem-to-use-your-adobe-analytics-data-centers

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 par défaut le centre de données de San Jose (https://api.omniture.com/admin/1.4/rest/).

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.

    note note
    NOTE
    Contactez votre administrateur de site pour savoir si vous avez accès à cette console.
  3. Sélectionnez l’élément Configuration nommé Adobe AEM client HTTP 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 configuring-the-connection-to-adobe-analytics

CAUTION
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 Activity Map fourni par Adobe Analytics doit désormais être utilisé.

Configuration pour Activity Map configuring-for-the-activity-map

CAUTION
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 Activity Map fourni par Adobe Analytics doit désormais être utilisé.

Création d’un framework Adobe Analytics creating-a-adobe-analytics-framework

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 :

  • Tous: Les informations de l’instance d’auteur et de publication renseignent la suite de rapports.
  • Auteur: Seules les informations provenant de l’instance d’auteur renseignent la suite de rapports.
  • Publier: Seules les informations provenant de l’instance de publication renseignent la suite de rapports.
NOTE
La sélection du type d’instance de serveur ne limite pas les appels à Adobe Analytics, elle contrôle simplement les appels qui 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 le Créer une structure dialog :

    • Spécifiez un Titre.
    • Vous pouvez éventuellement spécifier la variable Nom, pour le noeud 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.

    note note
    NOTE
    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 configuring-server-settings-for-adobe-analytics

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

CAUTION
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 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
    • Il est utilisé pour envoyer des données à partir de 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 associating-a-page-with-a-adobe-analytics-framework

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 récupérées à partir 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 à la 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 le Cloud Services .

  4. Utilisez le menu déroulant Ajouter une configuration pour sélectionner Adobe Analytics parmi les options disponibles. Si l’héritage est défini, vous devez le désactiver avant que le sélecteur ne soit 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électionner Enregistrer et fermer.

  7. Publier la page pour activer la page et les configurations/fichiers connectés.

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

  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. A partir de l'exemple fourni, l'appel doit contenir la valeur renseignée (c'est-à-dire aubergine) en eVar7 et la liste des événements doit contenir event3.

Pages vues page-views

Lorsqu’une page est associée à un framework Adobe Analytics, le nombre de pages vues peut être affiché dans la vue 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 configuring-the-import-interval

Configurez l’instance appropriée de la Adobe AEM configuration des interrogations gérées service :

  • 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 des configurations et/ou des structures Adobe Analytics editing-adobe-analytics-configurations-and-or-frameworks

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 des frameworks Adobe Analytics deleting-adobe-analytics-frameworks

Pour supprimer une structure Adobe Analytics, commencez par l’ouvrir pour modification.

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

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8