Configuration des statistiques sur les ressources avec AEM Assets et Adobe Experience Platform Launch

Dans cette série de vidéos en 5 parties, nous passons en revue la configuration et la configuration de Asset Insights pour les Experience Manager déployés via Adobe Launch.

Partie 1 : Présentation des informations sur les ressources

Présentation des statistiques sur les ressources. Installez les composants principaux, l’exemple de composant d’image et d’autres packages de contenu pour préparer votre environnement.

Schéma d’architecture

Schéma d’architecture

ATTENTION

Veillez à télécharger la dernière version des composants principaux pour votre implémentation.

La vidéo utilise les composants de base v2.2.2 qui ne sont plus la dernière version ; veillez à utiliser la dernière version avant de passer à la section suivante.

Partie 2 : Activation du suivi des statistiques des ressources pour un exemple de composant d'image

Améliorations apportées aux composants principaux et utilisation du composant proxy (exemple de composant d’image) pour Asset Insights. Modification des stratégies de modèle de page de contenu pour activer le composant d’image d’exemple pour le site de référence.

REMARQUE

Le composant Image Core comprend la possibilité de désactiver le suivi UUID en désactivant le suivi de l’UUID de la ressource (valeur d’identificateur unique pour un noeud créé dans JCR).

Le composant Image de base utilise l’attribut data-asset-id dans le <div> parent d’une balise d’image pour activer/désactiver cette fonction. Le composant proxy remplace le composant principal par les modifications suivantes.

  • Supprime la balise data-asset-id de la balise div parente d'un élément <img> dans le fichier image.html
  • Ajoute data-aem-asset-id directement à l’élément <img> dans image.html
  • Ajoute la valeur data-trackable='true' à l'élément <img> dans image.html
  • data-aem-asset- idand data-trackable='true' sont conservés au même niveau de noeud
REMARQUE

data-aem-asset-id='image.UUID' et data-trackable='true' sont les attributs clés qui doivent être présents pour les impressions de ressources. Pour Asset Click Insights, en plus des attributs de données ci-dessus présents dans la balise <img>, la balise parent <a> doit avoir une valeur href valide.

Partie 3 : Adobe Analytics — Création de Report Suite, activation de la collecte de données en temps réel et du Rapports AEM Assets

Une suite de rapports avec collecte de données en temps réel est créée pour le suivi des ressources. La configuration d’AEM Assets Insights est configurée à l’aide des informations d’identification Adobe Analytics.

REMARQUE

La collecte de données en temps réel et le Rapports des ressources AEM doivent être activés pour votre suite de rapports Adobe Analytics. L’activation du Rapports d’actifs AEM réserve les variables d’analyse pour le suivi des informations sur les actifs.

Pour la configuration AEM Assets Insights, vous avez besoin des informations d’identification suivantes :

  • Centre de données
  • Nom de la Société Analytics
  • Nom d’utilisateur Analytics
  • Secret partagé (peut être obtenu à partir de Adobe Analytics > Admin > Paramètres de Société > Service Web).
  • Report Suite (Veillez à sélectionner la Report Suite appropriée utilisée pour le Rapports des ressources)

Partie 4 : Utilisation d'Adobe Experience Platform Launch pour l'ajout de l'extension Adobe Analytics

Ajouter Adobe Analytics Extension, Création de règles de chargement de page et Intégration d’AEM avec lancement avec un compte technique IMS Adobe.

REMARQUE

Veillez à répliquer toutes vos modifications de l’instance d’auteur à l’instance de publication.

Règle 1 : Suivi de page (pagetracker.js)

//For AEM 6.3
<script type="text/javascript" src="http://localhost:4503/etc/clientlibs/foundation/assetinsights/pagetracker.js"></script>
//For AEM 6.4
<script type="text/javascript" src="http://localhost:4503/etc.clientlibs/dam/clientlibs/assetinsights/pagetracker.js"></script>

Le suivi de page met en oeuvre deux rappels (enregistrés dans le code incorporé de ressource)

  • &lt;code>assetAnalytics.core.assetLoaded&lt;/code> <code><code>: appelé lorsque le événement "load" est distribué pour l’élément asset-DOM.</code></code>
  • &lt;code>assetAnalytics.core.assetClicked&lt;/code> <code><code>: appelé lorsque le événement "click" est distribué pour l’élément asset-DOM, ceci n’est pertinent que lorsque l’élément asset-DOM-element a une balise d’ancrage en tant que parent avec un attribut href externe valide</code></code>

Enfin, Pagetracker implémente une fonction d'initialisation en tant que.

  • &lt;code>assetAnalytics.dispatcher.init()&lt;/code> <code><code>: appelé pour initialiser le composant Pagetracker.</code></code> Ceci DOIT être appelé avant que l’un des événements-statistiques-ressources (impressions et/ou clics) ne soit généré à partir de la page Web.
  • &lt;code>assetAnalytics.dispatcher.init()&lt;/code> <code><code>: accepte facultativement un objet AppMeasurement — s’il est fourni, il ne tente pas de créer une nouvelle instance de l’objet AppMeasurement.</code></code>

Règle 2 : Suivi d’images — Action 1 (asset-insights.js)

/*
 * AEM Asset Insights
 */

var sObj = window.s;
_satellite.notify('in assetAnalytics customInit');
(function initializeAssetAnalytics() {
 if ((!!window.assetAnalytics) && (!!assetAnalytics.dispatcher)) {
 _satellite.notify('assetAnalytics ready');
 /** NOTE:
  Copy over the call to 'assetAnalytics.dispatcher.init()' from Assets Pagetracker
  Be mindful about changing the AppMeasurement object as retrieved above.
  */
 assetAnalytics.dispatcher.init(
                                "",  /** RSID to send tracking-call to */
                                "",  /** Tracking Server to send tracking-call to */
                                "",  /** Visitor Namespace to send tracking-call to */
                                "",  /** listVar to put comma-separated-list of Asset IDs for Asset Impression Events in tracking-call, e.g. 'listVar1' */
                                "",  /** eVar to put Asset ID for Asset Click Events in, e.g. 'eVar3' */
                                "",  /** event to include in tracking-calls for Asset Impression Events, e.g. 'event8' */
                                "",  /** event to include in tracking-calls for Asset Click Events, e.g. 'event7' */
                                sObj  /** [OPTIONAL] if the webpage already has an AppMeasurement object, please include the object here. If unspecified, Pagetracker Core shall create its own AppMeasurement object */
                                );
 sObj.usePlugins = true;
 sObj.doPlugins = assetAnalytics.core.updateContextData;
}
 else {
 _satellite.notify('assetAnalytics not available. Consider updating the Custom Page Code', 4);
 }
})();

Règle 2 : Suivi d’images — Action 2 (image-tracker.js)

/*
 * AEM Asset Insights
 */

document.querySelectorAll('[data-aem-asset-id]').forEach(function(element) {
    assetAnalytics.core.assetLoaded(element);
    var parent = element.parentElement;
    if (parent.nodeName == "A") {
        parent.addEventListener("click", function() {
            assetAnalytics.core.assetClicked(this)
        });
    }
});
  • assetAnalytics.core.assetLoaded() : est appelé à la fin du chargement de la page et déclenche des impressions de ressources pour toutes les images pouvant faire l’objet d’un suivi.
  • Variable Analytics qui transporte la liste de ressources chargée : contextData['c.a.assets.idList']
  • assetAnalytics.core.assetClicked() : est appelé lorsque l’élément DOM de l’actif comporte une balise d’ancrage avec une valeur href valide. Lorsqu’un utilisateur clique sur un fichier, un cookie est créé avec l’ID de fichier sur lequel l’utilisateur a cliqué comme valeur.(Nom du cookie : a.assets.clickedid)
  • Variable Analytics qui transporte la liste de ressources chargée : contextData['c.a.assets.clickedid']
  • Source de l'Origine : contextData['c.a.assets.source']

Instruction de débogage de la console

//Launch Build Info
_satellite.buildInfo

//Enables debug messages
_satellite.setDebug(true);

//Asset Insight JS Object
assetAnalytics

//List of trackable images
document.querySelectorAll(".cmp-image__image");

Deux extensions de navigateur Google Chrome sont référencées dans la vidéo comme moyen de déboguer Analytics. Des extensions similaires sont également disponibles pour d’autres navigateurs.

Il est également possible de passer de la gestion dynamique des balises en mode de débogage avec l’extension Chrome suivante : Lancement et commutateur DTM. Cela permet de vérifier plus facilement s’il existe des erreurs liées au déploiement de la gestion dynamique des balises. En outre, vous pouvez basculer manuellement la gestion dynamique des balises en mode de débogage via n’importe quel navigateur outils de développement -> Console JS en ajoutant le fragment de code suivant :

Partie 5 : Test du suivi Analytics et de la synchronisation des données Insight

Configuration de l’état du Planificateur de tâche de synchronisation des Rapports de ressources AEM et du rapport Statistiques des ressources

Sur cette page