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 :
Dans l'environnement de l'auteur :
Les fonctionnalités des communautés prises en charge sont les suivantes :
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 :
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 de rapports. 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
En utilisant le 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 se connectant à Adobe Marketing Cloud avec nom de la Société et 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
activation7 Événements de réussite (événements)
event1
par event7
activation
Type Counter
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
Console Rapports vidéo
Video Core
Console de mesure coeur de la vidéo
Use Solution Variables
Si vous utilisez une nouvelle suite de rapports, sachez qu’une nouvelle suite de rapports ne peut comporter que 4 variables evar et 6 variables événement, tandis que 11 variables evar et 7 variables é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.
Si vous utilisez une suite de rapports existante qui utilise déjà des variables dans
evar1
à evar11
event1
à event7
Avant la publication du site de la communauté, il est important de restaurer la mise en correspondance existante en déplaçant les variables AEM qui étaient automatiquement mises en correspondance avec les variables Analytics lorsque Analytics était activé pour un site de la communauté.
Pour restaurer le mappage préexistant et déplacer les variables AEM vers d’autres variables Analytics, voir la section Modification du mappage des variables Analytics.
Si vous ne le faites pas, vous risquez de perdre des données irrécupérables.
Lorsque la licence Video Heartbeat Analytics est concédée, un Marketing Cloud Org Id
est attribué.
Pour activer le rapports Video Heartbeat après configuration de la suite de rapports Analytics pour le rapports vidéo :
Marketing Cloud Org Id
au site communautaireLe Marketing Cloud Org Id
peut être saisi au moment de la création du site communautaire ou plus tard par modification des 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.
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 :
[+]
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 Activer les analyses de la communauté.
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 communautés
Template
Sélectionner Adobe Analytics Configuration
Sélectionnez Créer
Analytics Settings
.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 requiert les informations de compte prérequises obtenues auprès du représentant du compte.
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.
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 :
Sélectionnez Se connecter à Analytics.
En cas d’échec,
Cliquez sur OK
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).
[+]
en regard de Structures 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.
Par exemple, saisissez communautés
Modèle
Sélectionner Adobe Analytics Framework
Sélectionnez Créer
La création d’Analytics Framework ouvre la structure de configuration.
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 suite de rapports.
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.
Report suite
les suites de rapports associées au compte de Société doivent pouvoir être sélectionnées.Load default server settings? Do you want to load the default server settings and overwrite current values in the Server section?
Run Mode
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é.
Pour ajouter le service cloud Analytics lors de la création d’un nouveau site communautaire :
À l’étape 3
Sous l'onglet ANALYTICS :
Vous pouvez éventuellement revenir à la configuration de la structure d’Analytics pour ajuster les mappages de variables.
Pour ajouter le service cloud Analytics à un site communautaire existant :
Accédez à la console [!UICONTROL 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 :
Vous pouvez éventuellement revenir à la configuration de la structure d’Analytics pour ajuster les mappages de variables.
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 élément de ce type doit exister sur la page, par exemple 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 chevauche le script sitepage.hbs
, assurez-vous que l’élément est présent. La variable siteUrl
est définie une fois générée 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>
Analytics est automatiquement utilisé pour plusieurs fonctions de communautés.
L’environnement auteur Configuration OSGi, 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 pour Analytics sont créés, ils doivent être ajoutés à cette liste de composants configurés.
Remarque : les composants journal
sont utilisés pour implémenter la fonction de blog.
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 de prise en main :
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 | eVar 9 | eVar10 | |
événement1Lecture des ressources | (une) | - | - | - | - | - | - | - | (i) | - |
événement2SCFView | (une) | (b) | © | (d) | (e) | (f) | (g) | (h) | i) | j) |
événement3SCFCreate (Post) | - | b) | c) | d) | e) | f) | g) | h) | i) | j) |
événement4SCFFollow | - | b) | c) | d) | e) | f) | g) | h) | i) | j) |
événement5SCFVoteUp | - | b) | c) | d) | e) | f) | g) | h) | i) | j) |
événement6SCFVoteDown | - | b) | c) | d) | e) | f) | g) | h) | i) | j) |
événement7SCFRate | - | b) | c) | d) | e) | f) | g) | h) | i) | j) |
Exemples de valeurs d’eVar :
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.
Il est important de procéder à une mise en mémoire avant que le site de la communauté soit publié avec Analytics activé, sans quoi il y a un risque de perte de données.
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 :
Si vous utilisez une suite de rapports existante qui utilise déjà des variables dans
evar1
à evar11
event1
à event7
Ensuite, avant la publication du site de la communauté, il est important de restaurer la mise en correspondance existante et de déplacer les variables AEM communautés qui étaient automatiquement mises en correspondance (lorsque Analytics était activé pour le site de la communauté) vers d’autres variables Analytics. Ce réacheminement doit être cohérent pour tous les composants des communautés.
Si vous ne le faites pas, vous risquez de perdre des données irrécupérables.
Lorsque le déploiement choisi est une ferme de publication, une instance de publication AEM doit être identifiée comme l’éditeur Principal pour l’interrogation de Adobe Analytics pour que les données du rapport soient écrites dans 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 Principal Publisher.
Pour obtenir des instructions spécifiques, consultez la section Principale de l'éditeur Déploiement des communautés.
Il est important que l’éditeur Principal soit configuré pour empêcher l’interrogation de plusieurs instances de publication.
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 à l'adresse Répliquer la clé Crypto.
Une fois que le service cloud Analytics a été activé pour un site communautaire et que, si nécessaire, la mise en correspondance d’Analytics avec AEM variables a été ajustée, il est nécessaire de répliquer la configuration dans l’environnement de publication en (re)publiant le site communautaire.
La configuration OSGi de l’auteur et de l’éditeur Principal AEM Communities Analytics Report Management
, <a2/>, est 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.
Une fois qu’un site communautaire compatible 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 placer une charge importante sur le site communautaire.
L’interrogation par défaut intervalle d’importation est définie sur 12 heures.
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
Accédez à CRXDE Lite
Sous le noeud jcr:content
de la racine de langue
/content/sites/engage/en/jcr:content
Accédez au composant configuré pour le rapports Analytics
analytics/reportConfigs/social_forum_components_hbs_topic
Notez les périodes créées
last30Days
last90Days
thisYear
Remarquez le noeud total
interval
remplacera l'intervalle d'importation de rapports.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.