Configuration d’Analytics pour les fonctionnalités des communautés

Présentation

Adobe Analytics et Adobe Experience Manager (AEM) sont les deux solutions de Adobe Marketing 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, lorsqu’un membre d’un site de communauté d’activation affiche une ressource vidéo qui lui est attribuée, le lecteur de ressources envoie des événements à Analytics, y compris des données de pulsation vidéo. 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 :

  • Dans l’environnement de publication :

    • Reporting sur la communauté tendances
    • Permet aux visiteurs du site de trier par "le plus consulté", "le plus principal", "le plus apprécié"
    • Affichage du nombre de listes UGC
  • Dans l’environnement de création :

    • Affichage des données de participation dans la console de gestion des membres (vues, publications, mentions "J’aime")
    • Synthèse des tendances, pulsation vidéo et périphérique vidéo pour la ressource d’activation rapports

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 :

  1. Répliquez la clé de chiffrement pour vous assurer que le cryptage/décryptage se produit correctement sur toutes les instances AEM

  2. Préparation d’une suite de rapports Adobe Analytics

  3. Créez un service cloud d’AEM et framework

  4. Activation d’Analytics pour un site de communauté

  5. Vérifier Analytics pour AEM mappage des variables

  6. Identifier l’éditeur Principal

  7. 🔗 Publier le site de la communauté

  8. Configurer l’importation des données de rapport d’Adobe Analytics vers le site de la communauté

Prérequis

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

  • Nom de l’entreprise

    Société associée au compte Adobe Analytics.

  • Nom d’utilisateur

    Nom d’utilisateur de connexion de l’utilisateur autorisé à gérer le compte Analytics.
    (doit inclure les privilèges d’accès aux services web).

  • Mot de passe

    Mot de passe de connexion de l’utilisateur autorisé.

  • Centre de données Analytics

    URL du centre de données Analytics pour le compte.

  • Suite de rapports

    Nom de la suite de rapports Analytics à utiliser.

Suite de rapports Adobe Analytics pour les rapports vidéo

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

En vous 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 :

  • 11 variables de conversion (eVars)

    • evar1 par evar11 activation

    • Peut réutiliser (renommer) des eVars existantes ou en créer de nouvelles à utiliser pour les fonctionnalités de communauté

  • 7 événements de succès (événements)

    • event1 par event7 activation

    • type Counter

      • not Counter (no subrelations)
    • Peut réutiliser (renommer) des événements existants ou en créer de nouveaux à utiliser pour les fonctionnalités de communauté

  • Gestion des vidéos

    • Console Rapports vidéo

      • Activer Video Core
      • Sélectionnez Enregistrer
    • Console de mesures coeur de la vidéo

      • Sélectionner Use Solution Variables
      • Sélectionnez Enregistrer

Si vous utilisez une nouvelle suite de rapports, sachez qu’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.

ATTENTION

Si vous utilisez une suite de rapports existante qui utilise déjà des variables dans

  • evar1 à evar11

  • event1 à event7

Ensuite, avant que le site de la communauté ne soit publié, il est important de restaurer le mappage préexistant en déplaçant les variables AEM automatiquement mises en correspondance avec les variables Analytics lorsque Analytics a été activé pour un site de la communauté.

Pour restaurer le mappage préexistant et déplacer AEM variables vers d’autres variables Analytics, reportez-vous à la section Modification du mappage de variables Analytics.

Si vous ne le faites pas, il se peut qu’il y ait une perte de données irrécupérable.

Video Heartbeat Analytics

Lorsque Video Heartbeat Analytics est sous licence, une Marketing Cloud Org Id est affectée.

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 :

La balise Marketing Cloud Org Id peut être saisie au moment de la création du site de la communauté ou ultérieurement par modification des propriétés du site de la communauté.

marketing-org-id

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) qui 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) et éventuellement d’envoi d’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

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 :

  • À partir de la navigation globale : Outils > Déploiement > Cloud Services
  • Faites défiler l’écran jusqu’à Adobe Analytics
  • Sélectionnez Configurer maintenant ou Afficher les configurations .

cloud-config

Boîte de dialogue Créer une configuration

  • Cliquez sur [+] icône en regard de Configurations disponibles pour créer une configuration.

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

create-cloud-config

  • Titre

    (Obligatoire) Titre affiché de la configuration.
    Par exemple, saisissez Activation Community Analytics

  • Name (Nom)

    (Facultatif) S’il n’est pas spécifié, le nom est défini par défaut sur un nom de noeud valide dérivé du titre.
    Par exemple, saisissez communities

  • Modèle

    Sélectionner Adobe Analytics Configuration

  • Sélectionnez Créer

    • Lance la page de configuration et ouvre la boîte de dialogue Analytics Settings

Boîte de dialogue de paramètres Analytics

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.

analytics-settings

  • Société

    Société associée au compte Adobe Analytics.

  • Nom d’utilisateur

    Nom d’utilisateur de connexion de l’utilisateur autorisé à gérer le compte Analytics.

  • Mot de passe

    Mot de passe de connexion de l’utilisateur autorisé.

  • Centre de données

    Sélectionnez le centre de données Analytics hébergeant la suite de rapports.

  • Ne pas ajouter la balise de suivi sur la page

    Laissez le paramètre par défaut (désélectionné).

  • Utiliser AppMeasurement

    Laissez le paramètre par défaut (désélectionné).

  • Ne pas importer des impressions de page de nuit (auteur)

    Laissez le paramètre par défaut (désélectionné).

  • Ne pas importer des impressions de page de nuit (publication)

    Laissez le paramètre par défaut (désélectionné).

Pour enregistrer les paramètres :

  • Sélectionnez Connexion à Analytics

    • En cas d’échec,

      • Vérifiez que les entrées ne contiennent pas d’espaces de début.
      • Essayez un autre centre de données.
  • Cliquez sur OK.

    analytics-enablement-settings

Créer une structure

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).

  • Cliquez sur [+] icône en regard de Structures disponibles pour créer une nouvelle structure.

    analytics-framework

  • Titre

    (Obligatoire) Titre affiché de la structure.
    Par exemple, saisissez Enablement Community Framework.

  • Name (Nom)

    (Facultatif) S’il n’est pas spécifié, le nom est défini par défaut sur un nom de noeud valide dérivé du titre.
    Par exemple, saisissez communities.

  • Modèle

    Sélectionner Adobe Analytics Framework.

  • Sélectionnez Créer.

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

Configuration de la structure d’AEM Analytics

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.

analytics-enablement-framework

Sélectionner une suite de rapports

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 entraver l’accès aux paramètres des suites de rapports.

Boîte de dialogue Suites de rapports avant et après la sélection de l’option "Ajouter un élément"

report-suite

  1. Sélectionnez Ajouter un élément +.

    Deux listes déroulantes s’affichent.

  2. Choisissez une balise Report suite.

    Les suites de rapports associées au compte d’entreprise peuvent être sélectionnées.

  3. Sélectionnez Oui dans la boîte de dialogue qui s’ouvre :

    Load default server settings?
     Do you want to load the default server settings and overwrite current values in the Server section?
    
  4. Choisissez une balise Run Mode.

  5. Sélectionnez Publier.

analytics-framework2

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

Activation d’Analytics pour un site de la communauté

Activation pour le nouveau site de la communauté

Pour ajouter le service cloud Analytics lors de la création d’un site de communauté :

  • À l’étape 3, sous l’onglet ANALYTICS :

    • Cochez la case Activer Analytics .
    • Sélectionnez la structure dans la liste déroulante.
  • Si vous le souhaitez, revenez à la configuration de la structure Analytics pour ajuster les mappages des variables.

Activer pour le site de la communauté existant

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

  • Accédez à la console Communautés > Sites .

  • Sélectionnez l’icône Modifier le site du site de la communauté.

  • Sélectionnez LES PARAMÈTRES.

  • Dans la section Analytics :

    • Cochez la case Activer Analytics .
    • Sélectionnez la structure dans la liste déroulante.
  • Si vous le souhaitez, revenez à la configuration de la structure Analytics pour ajuster les mappages des variables.

Activation pour les sites personnalisés

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 doit être présent. Un seul élément de ce type 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 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 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-configuration1

REMARQUE

Les composants de journal sont utilisés pour mettre en oeuvre la fonction de blog.

Analytics mappé sur 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, en commençant par evar1 et event1, respectivement, et en étant incrémentées de 1.

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

Voici un exemple de mappages par défaut après avoir suivi le tutoriel de prise en main :

map-analytics

Carte des eVars envoyées avec chaque événement

Type d’activation
Ressource
Titre du site
Type de fonction
Titre du groupe
Chemin du groupe
Type UGC
Titre UGC
User
(membre)
Chemin d’accès UGC<a0/
Chemin du site
eVar1 eVar2 eVar3 eVar4 eVar5 eVar6 eVar7 eVar8 eVar9 eVar10
event1
Lecture de ressource
(une) - - - - - - - (i) -
event2
SCFView
(une) (b) (c) (d) (e) (f) (g) (h) (i) (j)
event3
SCFCreate (Post)
- (b) (c) (d) (e) (f) (g) (h) (i) (j)
event4
SCFFollow
- (b) (c) (d) (e) (f) (g) (h) (i) (j)
event5
SCFVoteUp
- (b) (c) (d) (e) (f) (g) (h) (i) (j)
event6
SCFVoteDown
- (b) (c) (d) (e) (f) (g) (h) (i) (j)
event7
SCFRate
- (b) (c) (d) (e) (f) (g) (h) (i) (j)

Exemples de valeurs d’eVar :

  • Type MIME : video/mp4

  • titre du site de la communauté : Communautés de Geometrixx

  • nom de la fonction de la communauté : Forum

  • nom du groupe de communautés : La randonnée

  • chemin d’accès au contenu du groupe de communautés : /content/sites/<site name>/en/groups/hiking

  • Type de ressource du composant UGC : social/forum/components/hbs/topic

  • Titre du composant UGC : Rubriques de randonnée

  • login (authorizableId): aaron.mcdonald@mailinator.com

  • Chemin SRP vers UGC : /content/usergenerated/asi/.../forum/jmtz-topic3
    ou
    chemin du composant à suivre : /content/sites/<site name>/en/jcr:content/content/primary/forum

  • chemin d’accès au contenu du site de la communauté : /content/sites/<site name>/en

Modification du mappage des variables Analytics

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 Analytics 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 en faisant glisser l’eVar ou l’événement Analytics de votre choix depuis le rail de gauche et en le déposant sur la ligne correspondante dans le 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.

ATTENTION

Il est important de procéder à une recodification avant que le site de la communauté soit publié avec Analytics activé, faute de quoi il existe un risque de perte de données.

Exemple d’étape 1 : Déplacement d’Analytics evar14 dans la table de mappage

analytics-mapping-evar

Exemple d’étape 2 : Sélectionner "x" pour supprimer evar11 remplacé

analytics-mapping-evar1

Exemple d’étape 3 : AEM var eventdata.siteId mappé sur Analytics evar14

analytics-mapping-evar2

Publication du site de la communauté

Vérification d’Analytics pour AEM mappage des variables

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 cloud Analytics.

Voir les sections :

ATTENTION

Si vous utilisez une suite de rapports existante qui utilise déjà des variables dans

  • evar1 à evar11

  • event1 à event7

Ensuite, avant que le site de la communauté ne soit publié, il est important de restaurer le mappage préexistant et de déplacer les variables d’AEM des communautés qui ont été automatiquement mappées (lorsque Analytics a été activé pour le site de la communauté) vers d’autres variables Analytics. Ce remappage doit être cohérent dans tous les composants de Communities.

Si vous ne le faites pas, il se peut qu’il y ait une perte de données irrécupérable.

Éditeur Principal

Lorsque le déploiement choisi est une ferme de publication, une instance de publication AEM doit être identifiée comme l’é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 l’éditeur Principal, de sorte que toutes les instances de publication dans une batterie de publication s’identifient elles-mêmes comme l’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 Éditeur Principal .

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

ATTENTION

Il est important que l’éditeur Principal soit configuré pour empêcher l’interrogation de plusieurs instances de publication.

Réplication de la clé de chiffrement

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

Publier le site de la communauté et le service Analytics Cloud

Une fois que le service cloud Analytics a été activé pour un site de communauté et que, si nécessaire, le mappage d’Analytics sur AEM variables a été adapté, il est nécessaire de répliquer la configuration sur l’environnement de publication en (re)publiant le site de la communauté.

Obtention de rapports à partir d’Analytics

Gestion des rapports

La configuration OSGi de l’auteur et Principal éditeur, 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

Une fois qu’un site de communauté activé 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 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 Intervalle d’importation est définie sur 12 heures.

importateur de rapports

Personnalisation des rapports de composants

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 :

  • Sur l’Principal éditeur, connectez-vous avec les droits d’administrateur.

  • Accédez à CRXDE Lite. Par exemple, https://localhost:4503/crx/de.

  • Sous le noeud jcr:content de la racine de langue (par exemple /content/sites/engage/en/jcr:content),accédez au composant configuré pour la création de rapports Analytics.
    Par exemple, analytics/reportConfigs/social_forum_components_hbs_topic

  • Notez les périodes créées :

    • last30Days
    • last90Days
    • thisYear
  • Remarquez le noeud total.

    • La modification de la propriété interval remplace l’intervalle de l’importateur de rapports.
    • La valeur est exprimée en secondes et est définie sur 4 heures (14 400 secondes).

component-report

Gestion des données utilisateur dans 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

Sur cette page