Fonctionnalités de configuration d’Analytics pour les communautés

Présentation

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

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

Par exemple, lorsqu’un membre d’un site de communauté d’activation vue une ressource vidéo qui lui est affectée, le lecteur de ressources envoie des événements à Analytics, y compris des données de pulsation vidéo. Depuis le site communautaire, les administrateurs peuvent consulter divers rapports sur la lecture de la vidéo.

En outre, les analyses sont nécessaires pour :

• Dans l’environnement de publication :

  • Rapports sur les tendances communautaires
  • Autoriser les visiteurs du site à trier en fonction des critères "le plus vu", "le plus principal", "le plus aimé"
  • Nombre de Vues sur les listes UGC

• Dans l'environnement de l'auteur :

  • Affichage des données de participation dans la console de gestion des membres (vues, publications, mentions J’aime, etc.)
  • Résumé des tendances, pulsation vidéo et périphérique vidéo pour les rapports de ressources d’activation

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

• Ressources d'activation
• Forum
• Q&R
• Blog
• Bibliothèque de fichiers
• Calendrier

Cette section de la documentation décrit la connexion d’une suite de rapports Analytics aux fonctionnalités des communautés. Les étapes de base sont les suivantes :

1. Répliquer la clé de chiffrement pour vérifier que le chiffrement/déchiffrement se produit correctement sur toutes les instances AEM
2. Préparation d’une suite de rapports Adobe Analytics
3. Création d’un service et d’une structure AEM Analytics Cloud
4. Activation d’Analytics pour un site communautaire
5. Vérifier Analytics pour AEM mappage des variables
6. Identifier l'éditeur Principal
7. Publication du site de la communauté
8. Configurer l' importation des données de rapport d'Adobe Analytics vers le site de la communauté

Conditions préalables

Pour configurer les fonctionnalités d’Analytics pour les communautés, vous devez travailler avec votre gestionnaire de compte pour configurer un compte Adobe Analytics et une suite derapports. Une fois établies, les informations suivantes devraient être disponibles :

• Nom de la 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.

  (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

Report Suite Adobe Analytics pour le Rapports vidéo

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

En vous connectant à Adobe Marketing Cloud avec le nom de Société et le nom d’utilisateur, il est possible de configurer une suite de rapports nouvelle ou existante pour qu’elle dispose des éléments suivants :

• 11 Variables de conversion (evars)

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

• 7 Événements de réussite (événements)

  • event1 par event7 activé

  • 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 des communautés

• Gestion des vidéos

  • Console Rapports vidéo

    • Activer Video Core
    • Sélectionnez Enregistrer

  • Console de mesure 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 de événement, tandis que 11 eVar et 7 variables de événement sont requises pour les communautés.

Si vous utilisez une suite de rapports existante, il peut être nécessaire de modifier le mappage des variables avant d’activer la structure Analytics pour un site communautaire. Contactez votre gestionnaire de compte pour toute question concernant les variables dédiées aux communautés.

Analyses de pulsation vidéo

Lorsque la licence Video Heartbeat Analytics est concédée, une licence Marketing Cloud Org Id est attribuée.

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

• Création d’un service Analytics Cloud
• Activation d’ Analytics pour un site communautaire
• Associer le site Marketing Cloud Org Id à la communauté

La Marketing Cloud Org Id valeur peut être saisie au moment de la création d'un site communautaire ou ultérieurement 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) 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, en fin de compte, envoie un rapport cumulatif de la session vidéo aux serveurs Analytics principaux.

Si elle n’est pas activée, le code de pulsation vidéo n’est jamais instancié et seul le suivi de la progression vidéo et de la reprise de la position est conservé à SRP pour 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 de l’instance d’auteur :

• A partir de la navigation globale : Outils > Déploiement > Cloud Services
• Scroll down to Adobe Analytics
• Sélectionnez Configurer maintenant ou Afficher les configurations

Boîte de dialogue Créer une configuration

• Sélectionner [+] l'icône en regard de Configurations ​​disponibles pour créer une nouvelle configuration

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

• Titre

  (Obligatoire) Titre d’affichage de la configuration.

  Par exemple, saisissez Activation Community Analytics.

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

  For example, enter communities

• Template (Modèle)

  Sélectionner Adobe Analytics Configuration

• Sélectionnez Créer

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

Boîte de dialogue 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 d’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.

• 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 qui héberge la suite de rapports.

• Ne pas ajouter la balise de suivi sur la page

  Ne pas utiliser comme valeur par défaut (non cochée)

• Utiliser AppMeasurement

  Ne pas utiliser comme valeur par défaut (non cochée)

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

  Ne pas utiliser comme valeur par défaut (non cochée)

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

  Quitter comme valeur par défaut (cochée)

Pour enregistrer les paramètres :

• Select Connect to Analytics

  • En cas d’échec,

    • Vérifier que les entrées ne contiennent pas d'espace de début
    • Essayer un autre centre de données
    • Contactez votre représentant de compte

• Cliquez sur OK

Créer une structure

Après avoir configuré correctement la connexion de base à Adobe Analytics, il est nécessaire de créer ou de modifier une structure pour le site communautaire. L’objectif de cette structure est de mettre en correspondance les variables de fonction (AEM) Communautés avec les variables Analytics (suite de rapports).

• Sélectionner [+] l'icône en regard de Cadres ​​disponibles pour créer une nouvelle structure

• Titre

  (Obligatoire) Titre d’affichage de la structure

  Par exemple, saisissez Enablement Community Framework.

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

  For example, enter communities

• Template (Modèle)

  Sélectionner Adobe Analytics Framework

• Sélectionnez Créer

La création d’Analytics Framework ouvre la structure de configuration.

Configuration du cadre d’AEM Analytics

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

Sélectionner une Report Suite

Sélectionnez la suite de rapports configurée pour le 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 :
Report Suite Adobe Analytics pour le 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 Report Suites.

Boîte de dialogue Report Suites avant et après avoir sélectionné 'Ajouter l'élément'

1. Sélectionner un élément Ajouté + deux listes déroulantes s'affichent
2. Sélectionnez Report suite les suites de rapports associées au compte de Société qui 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. Choose a Run Mode
   Choisir la publication

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

Activation d’Analytics pour un site de la communauté

Activer pour le nouveau site de la communauté

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

• À l’étape 3

• Sous l’onglet ANALYTICS :

  • Cochez la case Activer Analytics .
  • Sélectionnez le cadre dans la liste déroulante.

• Vous pouvez éventuellement revenir à la configuration de la structure d’Analytics pour ajuster les mappages de variables.

Activer pour le site de la communauté existante

Pour ajouter le service cloud Analytics à un site communautaireexistant :

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

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

• Sélectionner les paramètres

• Dans la section Analytics :

  • Cochez la case Activer Analytics .
  • Sélectionnez le cadre dans la liste déroulante.

• Vous pouvez éventuellement revenir à la configuration de la structure d’Analytics pour ajuster les mappages de variables.

Activer pour les sites personnalisés

Pour que le suivi et l’importation Analytics fonctionnent correctement pour un site communautaire, un élément de page avec les attributs scf-js-site-title class et href doit être présent. Un seul élément de ce type doit exister sur la page, par exemple dans un sitepage.hbs script non modifié pour un site communautaire. 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 communautaire personnalisé qui chevauche le sitepage.hbs script, assurez-vous que l’élément est présent. La siteUrlvariable sera définie une fois rendue sur le serveur avant de servir au client.

Pour un site AEM générique qui comprend des composants Communautés, mais qui n'est pas créé avec l'Assistant de création desite, 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 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 pour les communautés

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

La configuration OSGi de l’environnement auteur AEM Communities Analytics Component Configurationfournit 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 pour Analytics sont créés, ils doivent être ajoutés à cette liste de composants configurés.

Configuration des composants

Remarque : les journal composants sont utilisés pour implémenter la fonction de blog.

Analyses mises en correspondance avec AEM variables

Une fois le site de la communauté enregistré avec Analytics activé et la structure de configuration du cloud sélectionnée, les variables AEM sont automatiquement mises en correspondance avec les variables eVar et les événements Analytics en commençant par evar1 et événement1, respectivement, et en augmentant par 1.

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

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

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

	Type de ressource d'activation	Titre du site	Type de fonction	Titre du groupe	Chemin d’accès du groupe	Type UGC	Titre UGC	Utilisateur (membre)	Chemin UGC	Chemin du site
	eVar1	eVar2	eVar3	eVar4	eVar5	eVar6	eVar7	eVar8	eVar9	eVar10
événement1Lecture des ressources	(une)	-	-	-	-	-	-	-	(i)	-
event2SCFView	(une)	(b)	©	(d)	(e)	(f)	(g)	(h)	(i)	j)
événement3SCFCreate (Post)	-	(b)	©	(d)	(e)	(f)	(g)	(h)	(i)	j)
event4SCFFollow	-	(b)	©	(d)	(e)	(f)	(g)	(h)	(i)	j)
event5SCFVoteUp	-	(b)	©	(d)	(e)	(f)	(g)	(h)	(i)	j)
event6SCFVoteDown	-	(b)	©	(d)	(e)	(f)	(g)	(h)	(i)	j)
event7SCFRate	-	(b)	©	(d)	(e)	(f)	(g)	(h)	(i)	j)

Exemples de valeurs d’eVar :

• TypeMIME : vidéo/mp4
• Titredu site communautaire : Communautés de Geometrixx
• Nomde la fonction communautaire : Forum
• Nomdu groupe de la communauté : Randonnée
• Chemin d’accès au contenu du groupe de la communauté : /content/sites/communautés/fr/groups/hiking
• UGC component resourceType: social/forum/composants/hbs/rubrique
• Titre du composant UGC : Rubriques de randonnée
• Identifiant de connexion (identifiant autorisé) : aaron.mcdonald@mailinator.com
• Chemin SRP vers UGC : /content/usergenerate/asi/…/forum/jmtz-topic3 ou chemin du composant à suivre: /content/sites/communautés/fr/jcr:content/content/Principal/forum
• Chemin d’accès au contenu du site de la communauté : /content/sites/community/fr

Modification du mappage des variables Analytics

Le mappage des variables evar et événement Analytics sur les variables AEM est visible à partir de la configuration de la structure après l’activation d’Analytics pour un site de la 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 la variable eVar ou le événement Analytics de votre choix depuis le rail de gauche et en la déposant dans la ligne correspondante de la table de mappage.

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

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

Exemple d’étape 1 : Faire glisser Analytics evar14 dans la table de mappage

Exemple d’étape 2 : Sélection de 'x' pour supprimer evar11 remplacée

Exemple d’étape 3 : AEM var eventdata.siteId a été remappé sur Analytics evar14

Publication du site de la communauté

Vérification du mappage des variables Analytics sur AEM

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

Voir sections :

• Analyses mises en correspondance avec AEM variables
• Modification du mappage des variables Analytics

Éditeur Principal

Lorsque le déploiement choisi est une batterie depublication, une instance de publication AEM doit être identifiée comme l’éditeur Principal pour l’interrogation du Adobe Analytics pour que les données de rapport soient écrites à SRP.

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

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

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é Crypto

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éCrypto.

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

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

Obtention de rapports à partir d’Analytics

Gestion des rapports

La configuration OSGi de l’auteur et de l’éditeur PrincipalAEM Communities Analytics Report Managementest utilisée pour requête Analytics.

En ce qui concerne 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 communautaire compatible Analytics a été publié, la configuration OSGi de l’éditeur PrincipalAEM Communities Analytics Report Importerpeut ê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 placer une charge importante sur le site communautaire.

L’intervalle d’ importation d’interrogation par défaut est défini sur 12 heures.

Personnalisation des rapports de composants

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

Le thème du forum est actuellement le seul exemple de cette personnalisation :

• Sur l’éditeur Principal

• Connexion avec des droits d’administrateur

• Navigate to CRXDE Lite

  • For example, http://localhost:4503/crx/de

• Sous le jcr:content noeud de la racine de langue

  • Par exemple, /content/sites/engage/en/jcr:content

• Accédez au composant configuré pour le rapports Analytics

  • Par exemple, analytics/reportConfigs/social_forum_components_hbs_topic

• Notez les périodes créées

  • last30Days
  • last90Days
  • thisYear

• Remarquez le totalnoeud

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

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 Envoyer des demandes d’accès et de suppression.

Ressources

• Adobe Marketing Cloud : Aide et référence d’Analytics
• AEM: Integrating with Adobe Analytics
• AEM: Analytics with External Providers