Configuration d’Analytics pour les fonctionnalités de Communities analytics-configuration-for-communities-features

Vue d’ensemble overview

Adobe Analytics et Adobe Experience Manager (AEM) sont deux solutions d’Adobe Experience Cloud.

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

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

En outre, l’analyse est nécessaire pour :

Les fonctionnalités de communautés prises en charge sont les suivantes :

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 d’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

Grâce au Gestionnaire de suites de rapports d’Adobe Experience Cloud, les suites de rapports Analytics peuvent être configurées afin qu’un site communautaire puisse être activé pour fournir des rapports sur les fonctionnalités de Communities.

En vous connectant à Adobe Experience Cloud avec Nom de société et Nom d’utilisateur, vous pouvez configurer une suite de rapports nouvelle ou existante pour obtenir les éléments suivants :

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

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

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

Analyse de pulsation vidéo video-heartbeat-analytics

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

Pour activer le rapport de pulsation vidéo après configuration de la suite de rapports Analytics pour le rapport vidéo :

La Marketing Cloud Org Id peut être saisie au moment de la création du site communautaire ou ultérieurement en modifiant les propriétés du site communautaire.

Lorsque l’analyse de pulsation vidéo est activée, le code JavaScript (JS) du lecteur vidéo instancie le code de la bibliothèque de pulsation vidéo (également en JS). Le code gère toute la logique d’envoi des mises à jour de statut vidéo aux serveurs de suivi vidéo Analytics toutes les 10 secondes (non configurable). Il envoie finalement un rapport cumulatif de la session vidéo aux principaux serveurs Analytics.

Si ce paramètre n’est pas activé, le code de pulsation vidéo n’est jamais instancié et seul le suivi de la progression vidéo et de la position de reprise est conservé dans le SRP pour la création de rapports.

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

Pour créer une intégration Analytics qui intègre Adobe Analytics au site de la communauté AEM, à l’aide de 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 Paramètres Analytics analytics-settings-dialog

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

Pour enregistrer les paramètres :

Créer une structure create-framework

Une fois la configuration de la connexion de base à Adobe Analytics terminée, il est nécessaire de créer ou de modifier un framework pour le site de la communauté. L’objectif du framework est de mapper des variables de fonctionnalité Communities (AEM) à des variables Analytics (suite de rapports).

La création du framework Analytics ouvre le framework pour la configuration.

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

L’objectif du framework est de mapper des variables AEM à des 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 les rapports vidéo.

Si une suite de rapports n’a pas encore été créée ou n’est pas correctement configurée, consultez 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 le framework Analytics Cloud sont maintenant terminés. Les mappages sont définis après la création d’un site de la communauté avec ce service Analytics activé.

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

Activer 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é existante enable-for-existing-community-site

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

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

Pour que le suivi et l’importation Analytics fonctionnent correctement pour un site communautaire, un élément de page avec la classe scf-js-site-title et les attributs href doit être présent. Un seul de ces éléments doit exister sur la page, comme c’est le cas dans un script sitepage.hbs non modifié pour un site communautaire. La valeur de siteUrl est extraite et envoyée à Adobe Analytics en tant que chemin du 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 communautaire personnalisé qui recouvre 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 la diffusion au client.

Pour un site AEM générique qui inclut des composants de communautés, mais qui n’est pas créé avec l’assistant de création de site site, il est nécessaire d’ajouter l’élément . La valeur de href doit correspondre au chemin d’accès au site. Par exemple, si le chemin d’accès au 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 fonctionnalités de Communities.

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

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

Configuration du composant component-configuration

Variables Analytics mappées à AEM mapped-analytics-to-aem-variables

Une fois le site de la communauté enregistré, avec Analytics activé et le framework de configuration cloud sélectionné, les variables AEM sont automatiquement mappées aux eVars et é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 dans evar1 à evar11 et event1 à event7, il devient nécessaire de remapper les variables AEM et de restaurer le mappage d’origine.

Voici un exemple de mappages par défaut :

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

Exemples pour les valeurs eVar :

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

Le mappage des eVars et des événements Analytics aux variables AEM est visible à partir de la configuration du framework une fois qu’Analytics est activé pour un site communautaire.

Une fois Analytics activé et avant la publication du site de la communauté, le mappage peut être modifié dans le framework. 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 appropriée du tableau de mappage.

Pour éviter les mappages en double, veillez à supprimer l’evar ou l’événement Analytics remplacé de la ligne en le survolant et en sélectionnant le « X » qui s’affiche à droite de l’élément de variable Analytics.

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

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

Exemple d’étape 2 : sélection de « x » pour supprimer l’evar11 remplacée example-step-selecting-x-to-remove-replaced-evar

Exemple d’étape 3 : AEM var eventdata.siteId remappé 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 du mappage d’Analytics aux variables AEM verify-analytics-to-aem-variable-mapping

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

Voir les sections :

Principal Publisher primary-publisher

Lorsque le déploiement choisi est une ferme de publication, une instance de publication AEM doit être identifiée comme éditeur principal pour interroger Adobe Analytics afin que les données du rapport soient écrites dans SRP.

Par défaut, la configuration OSGi AEM Communities Publisher Configuration identifie son instance de publication comme l’éditeur principal, de sorte que toutes les instances de publication d’une ferme de publication s’identifient comme l’instance principale.

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

Pour obtenir des instructions spécifiques, consultez la section sur l’éditeur principal dans Déploiement de communautés.

Répliquer 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 des informations d’identification d’analyse chiffrées entre l’instance de création et l’instance de publication, 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é de publication et service Analytics Cloud publish-community-site-and-analytics-cloud-service

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

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.

En mode de création, 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 de 10 secondes par défaut.

Importateur de rapports report-importer

Une fois qu’un site de la communauté activé pour Analytics a été publié, la configuration OSGi de l’éditeur principal, AEM Communities Analytics Report Importer, 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 requêtes à 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 volumineuses », des sondages plus fréquents peuvent placer une charge importante sur le site de la communauté.

L’interrogation par défaut Intervalle d’importation est définie sur 12 heures.

Personnalisation des rapports de composants component-report-customization

Actuellement, pour personnaliser les mesures à suivre, des nœuds sont créés dans le référentiel pour définir les périodes pendant 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 aux données utilisateur, de les exporter et de les supprimer. Pour plus d’informations, voir Soumettre des demandes d’accès et de suppression.

Ressources resources