Configuration d’Analytics pour les fonctionnalités des communautés analytics-configuration-for-communities-features

Vue d’ensemble overview

Adobe Analytics et Adobe Experience Manager (AEM) sont les deux solutions de Adobe Experience Cloud.

Adobe Analytics peut être configuré pour AEM Communities afin que, lorsqu’un membre interagit avec les fonctionnalités de communauté prises en charge, des événements soient envoyés à Adobe Analytics à partir duquel des rapports sont générés.

Par exemple, sur le site de la communauté, les administrateurs peuvent consulter divers rapports concernant la lecture de la vidéo.

En outre, les analyses sont nécessaires pour :

Fonctionnalités de communautés prises en charge :

Cette section de la documentation décrit comment connecter une suite de rapports Analytics aux fonctionnalités de Communities. Les étapes de base sont les suivantes :

Conditions préalables prerequisites

Pour configurer les fonctionnalités Analytics for Communities, il est nécessaire de travailler avec le représentant de votre compte pour configurer un compte Adobe Analytics et une suite de rapports. Une fois établies, les informations suivantes doivent être disponibles :

Suite de rapports Adobe Analytics pour les rapports vidéo adobe-analytics-report-suite-for-video-reporting

À l’aide du Gestionnaire de Report Suites de Adobe Experience Cloud, les suites de rapports Analytics peuvent être configurées de sorte qu’un site de communauté puisse être activé pour fournir des rapports pour les fonctionnalités de communauté.

En se connectant à Adobe Experience Cloud avec nom de société et nom d’utilisateur, il est possible de configurer une suite de rapports nouvelle ou existante pour que :

Si vous utilisez une nouvelle suite de rapports, une nouvelle suite de rapports ne peut comporter que 4 eVars et 6 variables d’événements, tandis que 11 eVar et 7 variables d’événements sont requises pour Communities.

Si vous utilisez une suite de rapports existante, il peut être nécessaire de modifier le mappage de variables avant d’activer la structure Analytics pour un site de communauté.

Contactez le représentant de votre compte pour toute question concernant les variables dédiées aux communautés.

Video Heartbeat Analytics video-heartbeat-analytics

Lorsque Video Heartbeat Analytics est sous licence, un Marketing Cloud Org Id est attribué.

Pour activer la création de rapports Video Heartbeat après avoir configuré la suite de rapports Analytics pour la création de rapports vidéo :

Le Marketing Cloud Org Id peut être saisi au moment de la création d'un site communautaire ou plus tard en modifiant les propriétés du site communautaire.

Lorsque Video Heartbeat Analytics est activé, le code JavaScript (JS) du lecteur vidéo instancie le code de bibliothèque Video Heartbeat (également dans JS). Le code gère toute la logique d’envoi de mises à jour d’état vidéo aux serveurs de suivi vidéo Analytics toutes les 10 secondes (non configurables). Il envoie éventuellement un rapport cumulatif de la session vidéo aux serveurs Analytics principaux.

Si cette option n’est pas activée, le code de pulsation vidéo n’est jamais instancié et seul le suivi de progression et de reprise de la vidéo est conservé à la SRP pour la création de rapports.

Configuration du service Analytics Cloud AEM aem-analytics-cloud-service-configuration

Pour créer une intégration Analytics qui intègre Adobe Analytics au site de la communauté AEM, utilisez l’interface utilisateur standard sur l’instance de création :

Boîte de dialogue Créer une configuration create-configuration-dialog

Dans la boîte de dialogue Créer une configuration , les valeurs à renseigner identifient la configuration.

Boîte de dialogue de paramètres Analytics analytics-settings-dialog

La création initiale d’une nouvelle configuration Analytics entraîne l’affichage de la configuration et une nouvelle boîte de dialogue pour l’entrée des paramètres Analytics. Cette boîte de dialogue nécessite les informations de compte prérequises obtenues auprès du représentant du compte.

Pour enregistrer les paramètres :

Créer une structure create-framework

Après une configuration réussie de la connexion de base à Adobe Analytics, il est nécessaire de créer ou de modifier une structure pour le site de la communauté. L’objectif de la structure est de mapper les variables de fonctionnalités (AEM) de communautés aux variables Analytics (suite de rapports).

La création de la structure Analytics ouvre la structure pour la configuration.

Configuration de la structure d’AEM Analytics aem-analytics-framework-configuration

L’objectif de la structure est de mapper AEM variables aux variables Analytics (eVars et événements). Les variables Analytics disponibles pour le mappage sont définies dans la suite de rapports.

Sélectionner une suite de rapports select-report-suite

Sélectionnez la suite de rapports qui a été configurée pour la création de rapports vidéo.

Si une suite de rapports n’a pas encore été créée ou n’a pas été correctement configurée, reportez-vous à la section précédente :
Suite de rapports Adobe Analytics pour les rapports vidéo

Le Sidekick n’est pas nécessaire et peut être réduit afin de ne pas bloquer l’accès aux paramètres des suites de rapports.

Boîte de dialogue Suites de rapports avant et après avoir sélectionné "Ajouter un élément" report-suites-dialog-before-and-after-selecting-add-item

Le service et la structure cloud Analytics sont désormais terminés. Les mappages sont définis une fois qu’un site de communauté est créé avec ce service Analytics activé.

Activation d’Analytics pour un site communautaire enable-analytics-for-a-community-site

Activation pour le nouveau site de la communauté enable-for-new-community-site

Pour ajouter le service Analytics Cloud lors de la création d'un site communautaire :

Activer pour le site de la communauté existant enable-for-existing-community-site

Pour ajouter le service Analytics Cloud à un site communautaire existant :

Activation pour les sites personnalisés enable-for-customized-sites

Pour que le suivi et l’importation Analytics fonctionnent correctement pour un site de communauté, un élément de page avec les attributs scf-js-site-title et href doit être présent. Un seul élément de ce type doit exister sur la page, par exemple dans un script sitepage.hbs non modifié pour un site de communauté. La valeur de siteUrl est extraite et envoyée à Adobe Analytics en tant que chemin d’accès au site.

# present in default sitepage.hbs
# only one scf-js-site-title class should be included
# this example sets it to be hidden as it serves no visual purpose
<div
    class="navbar-brand scf-js-site-title"
    href="{{siteUrl}}.html"
    style="visibility: hidden;"
>
</div>

Pour un site de communauté personnalisé qui chevauche le script sitepage.hbs, assurez-vous que l’élément est présent. La variable siteUrl est définie lors du rendu sur le serveur avant de servir au client.

Pour un site d’AEM générique qui comprend des composants Communities, mais qui n’est pas créé avec l’ assistant de création de site, il est nécessaire d’ajouter l’élément . La valeur de href doit être le chemin d’accès au site. Par exemple, si le chemin du site est /content/my/company/en, utilisez :

<div
    class="navbar-brand scf-js-site-title"
    href="/content/my/company/en.html"
    style="visibility: hidden;"
>
</div>

Fonctionnalités d’Analytics for Communities analytics-for-communities-features

Analytics est automatiquement utilisé pour plusieurs fonctions de communauté.

La configuration OSGi de l’environnement de création, AEM Communities Analytics Component Configuration, fournit une liste des composants créés pour Analytics. Le mappage automatique des variables est déterminé par les composants répertoriés.

Si de nouveaux composants personnalisés créés sont créés et créés pour Analytics, ils doivent être ajoutés à cette liste de composants configurés.

Configuration des composants component-configuration

Analytics mappé sur AEM variables mapped-analytics-to-aem-variables

Une fois le site de la communauté enregistré, avec Analytics activé et la structure de configuration cloud sélectionnée, les variables AEM sont automatiquement mises en correspondance avec les eVars et les événements Analytics. Elle commence par evar1 et event1, respectivement, et est incrémentée de 1.

Si vous utilisez une suite de rapports existante qui a mappé l’une des variables d’evar1 à evar11 et event1 à event7, il devient nécessaire de supprimer les variables AEM et restaurer le mappage d’origine.

Voici un exemple de mappages par défaut :

Carte des eVars envoyées avec chaque événement map-of-evars-sent-with-each-event

Exemples de valeurs d’eVar :

Modification du mappage des variables Analytics modifying-analytics-variable-mapping

La mise en correspondance des eVars et événements Analytics avec les variables AEM est visible à partir de la configuration de la structure une fois qu’Analytics est activé pour un site de communauté.

Une fois Analytics activé et avant la publication du site de la communauté, le mappage peut être modifié dans la structure. Faites simplement glisser l’eVar ou l’événement Analytics de votre choix depuis le rail de gauche et déposez-le dans la ligne correspondante du tableau de mappage.

Pour éviter les mappages en double, veillez à supprimer l’eVar ou l’événement Analytics remplacé de la ligne en la survolant et en sélectionnant le "X" qui apparaît à droite de l’élément de variable Analytics.

Si les eVars et événements Communities remplacent les mappages qui existaient auparavant dans la suite de rapports, puis, pour éviter toute perte de données, affectez les variables AEM des fonctionnalités Communities à d’autres eVars ou événements Analytics et restaurez les mappages d’origine.

Exemple d’étape 1 : faire glisser Analytics evar14 dans la table de mappage example-step-dragging-analytics-evar-into-mapping-table

Exemple : sélection de "x" pour supprimer evar11 remplacé example-step-selecting-x-to-remove-replaced-evar

Exemple d’étape 3 : AEM var eventdata.siteId mappé sur Analytics evar14 example-step-aem-var-eventdata-siteid-remapped-to-analytics-evar

Publication du site de la communauté publishing-the-community-site

Vérification d’Analytics pour AEM mappage des variables verify-analytics-to-aem-variable-mapping

Il est conseillé de vérifier le mappage des variables avant de publier le site de la communauté, qui publie également le service et la structure Analytics Cloud.

Voir les sections :

Éditeur de Principal primary-publisher

Lorsque le déploiement choisi est une ferme de publication, une instance de publication AEM doit être identifiée en tant qu’éditeur principal pour interroger Adobe Analytics pour que les données de rapport puissent être écrites dans SRP.

Par défaut, la configuration OSGi AEM Communities Publisher Configuration identifie son instance de publication comme éditeur principal, de sorte que toutes les instances de publication dans une batterie de publication s’identifient elles-mêmes comme instance principale.

Par conséquent, il est nécessaire de modifier la configuration sur toutes les instances de publication secondaires pour décocher la case Principal Publisher .

Pour obtenir des instructions spécifiques, reportez-vous à la section principale de l’éditeur de Déploiement de communautés.

Réplication de la clé de chiffrement replicate-the-crypto-key

Les informations d’identification Adobe Analytics sont chiffrées. Pour faciliter la réplication ou la transmission d’informations d’identification d’analyse chiffrées entre l’auteur et les éditeurs, toutes les instances AEM doivent partager la même clé de chiffrement principale.

Pour ce faire, suivez les instructions de la section Répliquer la clé de chiffrement.

Site de la communauté Publish et service Analytics Cloud publish-community-site-and-analytics-cloud-service

Une fois le service Analytics Cloud activé pour un site de communauté et, si nécessaire, le mappage d’Analytics sur AEM variables est ajusté, répliquez la configuration sur l’environnement de publication en (re)publiant le site de communauté.

Obtention de rapports à partir d’Analytics obtaining-reports-from-analytics

Gestion des rapports report-management

La configuration OSGi de l’auteur et de l’éditeur principal, AEM Communities Analytics Report Management, est utilisée pour interroger Analytics.

Sur l’auteur, les requêtes concernent les rapports en temps réel.

Sur l’éditeur principal, les requêtes sont utilisées pour fournir des informations en vue de l’importation des données Analytics de l’importateur de rapports.

L’intervalle de requête est défini par défaut sur 10 secondes.

Importateur de rapports report-importer

Une fois qu’un site de communauté activé Analytics a été publié, la configuration OSGi, AEM Communities Analytics Report Importer de l’éditeur principal peut être configurée pour définir l’intervalle d’interrogation par défaut pour les configurations qui ne sont pas configurées individuellement dans CRXDE.

L’intervalle d’interrogation contrôle la fréquence des demandes à Adobe Analytics pour que les données soient extraites et enregistrées dans SRP.

Lorsque les données peuvent être classées comme "données massives", des sondages plus fréquents peuvent imposer une charge importante sur le site de la communauté.

L’interrogation par défaut Import interval est défini sur 12 heures.

Personnalisation des rapports de composants component-report-customization

Actuellement, pour personnaliser les mesures à suivre, les noeuds sont créés dans le référentiel qui définit des périodes pour lesquelles générer un rapport sur cette mesure.

Le sujet du forum est actuellement le seul exemple de cette personnalisation :

Gestion des données utilisateur dans Analytics manage-user-data-in-analytics

Adobe Analytics fournit des API qui vous permettent d’accéder, d’exporter et de supprimer des données utilisateur. Pour plus d’informations, voir Soumettre les demandes d’accès et de suppression.

Ressources resources