Configurer le suivi des liens Adobe Analytics configuring-link-tracking-for-adobe-analytics

CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

Lorsque des utilisateurs cliquent sur des liens figurant sur les pages de votre site web, vous pouvez enregistrer diverses informations dans Adobe Analytics. Par exemple, utilisez le suivi des liens pour découvrir comment les utilisateurs interagissent avec votre site, effectuez le suivi des téléchargements de fichiers et des liens de sortie.

  1. À l’aide de la Navigation, accédez via Déploiement, Services Cloud à la section Adobe Analytics.

  2. Avec Afficher les configurations, ouvrez le framework Adobe Analytics requis.

  3. Développez l’objet Configuration du suivi des liens et configurez selon les besoins (cette page fournit des détails supplémentaires) :

    aa-08

Suivi des téléchargements de fichiers tracking-file-downloads

Configurez le framework Adobe Analytics de sorte que les fichiers téléchargés à partir des pages associées soient automatiquement suivis en tant que téléchargements dans Adobe Analytics. Lorsque vous activez le suivi des téléchargements, seuls les types de fichiers spécifiés sont suivis.

Le suivi des téléchargements des types de fichiers suivants est effectué par défaut :

  • exe
  • zip
  • wav
  • mp3
  • mov
  • mpg
  • avi
  • wmv
  • doc
  • pdf
  • xls

Si, par exemple, avec le suivi des téléchargements activé pour les fichiers PDF, chaque fois que les utilisateurs cliquent sur les liens vers des fichiers PDF, le téléchargement du fichier PDF est suivi.

Les propriétés de suivi des téléchargements du framework sont implémentées comme code dans le fichier analytics.sitecatalyst.js généré pour une page. L’exemple de code suivant présente la configuration par défaut du suivi des téléchargements :

s.trackDownloadLinks= true;
s.linkDownloadFileTypes= 'exe,zip,wav,mp3,mov,mpg,avi,wmv,doc,pdf,xls';

Pour permettre le suivi des téléchargements pour votre framework Adobe Analytics :

  1. Ouvrez le framework Adobe Analytics et développez la section Configuration du suivi des liens.
  2. Activer Suivi des téléchargements.
  3. Dans le Types de fichiers de téléchargement saisissez les extensions de nom de fichier pour les types de fichiers dont vous souhaitez effectuer le suivi.

Vous pouvez effectuer le suivi des clics sur des liens externes (liens de sortie) sur vos pages.

Pour effectuer le suivi des liens externes pour votre framework Adobe Analytics :

  1. Ouvrez le framework Adobe Analytics et développez la section Configuration du suivi des liens.
  2. Configurez les propriétés suivantes en fonction de vos besoins.

Propriétés de suivi lorsque l’utilisateur clique sur des liens externes :

  • Suivi externe
    Active le suivi des liens externes.

  • Filtres externes
    (Facultatif) Définit des filtres pour apparier les URL externes des cibles de lien. Lorsque les liens cibles correspondent au filtre, le lien est suivi. Les filtres externes sont utiles pour effectuer le suivi de certains liens externes uniquement sur vos pages.

    Pour spécifier les liens externes à suivre, tapez entièrement ou partiellement l’URL du lien cible. S’il y a plusieurs filtres, séparez-les par une virgule. Entourez les chaînes littérales par des guillemets simples. Si aucune valeur (la valeur par défaut est '', deux guillemets simples) n’est entrée, tous les liens externes sont suivis.

  • Filtres internes
    Définit des filtres pour apparier les URL des liens internes. Lorsque le lien cible des URL qui correspondent à ce filtre, le lien n’est pas suivi. La valeur par défaut est une commande JavaScript qui renvoie le nom d’hôte de l’URL pour l’adresse de la fenêtre active.

    Pour spécifier les liens internes qui ne sont pas suivis, tapez entièrement ou partiellement l’URL interne du lien cible. S’il y a plusieurs filtres, séparez-les par une virgule. Entourez les chaînes littérales par des guillemets simples.

    La valeur par défaut est 'javascript:,'+window.location.hostname.

  • Laisser la chaîne de requête
    Inclut les paramètres URL lors de l’évaluation de correspondances avec des filtres internes et externes.

    Activez cette option pour inclure les paramètres URL lors de l’évaluation d’URL du lien cible par rapport aux filtres externes et internes.

Les propriétés de suivi des liens externes sont implémentées en tant que code dans le fichier analytics.sitecatalyst.js généré pour une page. L’exemple de code suivant est généré pour une page qui est associée à un framework ayant activé le suivi des liens externes avec la configuration suivante :

  • Le filtre externe est 'google.com'.
  • Le filtre interne est la valeur par défaut de 'javascript:,'+window.location.hostname.
  • Les chaînes de requête ne sont pas incluses lors de l’évaluation du lien cible par rapport aux filtres.
s.trackExternalLinks= false;
s.linkExternalFilters= 'google.com';
s.linkInternalFilters= 'javascript:,'+window.location.hostname;
s.linkLeaveQueryString= false;

Vous pouvez configurer AEM pour envoyer des données d’événement et de variable à Adobe Analytics lorsqu’un utilisateur clique sur un lien. Les propriétés Configuration du suivi des liens vous permettent de spécifier les événements et les variables Adobe Analytics à suivre lorsque des clics sur des liens se produisent.

Les mappages de framework déterminent les valeurs d’événement et de variable. Vous pouvez mapper les variables Adobe Analytics sur les variables de vos composants de contenu qui stockent les données que vous souhaitez suivre lorsque l’utilisateur clique sur des liens.

Pour envoyer des données de variable avec des clics sur des liens :

  1. Ouvrez le framework Adobe Analytics et développez la section Configuration du suivi des liens.
  2. Configurez les propriétés suivantes en fonction de vos besoins.

Pour envoyer des propriétés données variables avec des clics sur des liens :

  • Événements de suivi des liens
    Entrez les variables d’événement Adobe Analytics que vous voulez utiliser pour compter les clics sur les liens.

    S’il y a plusieurs noms de variables, séparez-les par une virgule.

    La valeur par défaut de None signifie qu’aucun suivi d’événement n’a lieu.

  • Variables de suivi des liens
    Entrez les variables Adobe Analytics à envoyer à Adobe Analytics lorsque les visiteurs cliquent sur des liens. S’il y a plusieurs noms de variables, séparez-les par une virgule.

    La valeur par défaut de None signifie qu’aucune donnée de variable n’est envoyée.

Lorsque vous spécifiez les événements et les variables à envoyer, la configuration est mise en œuvre sous forme de code dans le fichier analytics.sitecatalyst.js généré pour une page. L’exemple de code suivant est généré pour une page lorsque le framework suit l’événement event10 et la propriété prop4 :

s.linkTrackEvents= 'event10';
s.linkTrackVars= 'prop4';

Suivez les procédures ci-dessous pour découvrir le comportement du suivi des liens de l’intégration Adobe Analytics. Les procédures montrent les résultats de Débogueur Adobe Experience Cloud.

Configuration générale general-configuration

Cet exemple illustre le fonctionnement du mappage dans le cas du suivi et du débogueur :

  1. Ouvrez la structure associée à une page web.

  2. Faites glisser le composant Page vers la zone de mappages de la structure. Le composant Page fait partie du groupe de composants Général dans le Sidekick.

    note note
    NOTE
    Le composant que vous devez utiliser dans un scénario réel dépend du composant hérité (le cas échéant).
    Dans le cas contraire, votre propre composant doit y être exposé (en définissant un sous-noeud d’analyse dans son composant de page).

    Configurez le mappage en fonction du tableau suivant, en faisant glisser la variable Analytics (SiteCatalyst) depuis le panneau latéral gauche :

Variable CQ
Entrée dans le navigateur des variables
Variable Adobe Analytics
pagedata.title
eVar personnalisé 1 (eVar1)
eVar1
eventdata.events.pageView
Personnalisé 1 (event1)
event1
  1. Faites glisser le composant Recherche vers la zone de mappages de la structure. Le composant Recherche fait partie du groupe de composants Général dans le sidekick. Configurez le mappage en fonction du tableau suivant, en faisant glisser la variable Analytics (SiteCatalyst) depuis le panneau latéral gauche :
Variable CQ
Entrée dans le navigateur des variables
Variable Adobe Analytics
eventdata.keyword
eVar personnalisé 2 (eVar2)
eVar2
eventdata.results
eVar personnalisé 3 (eVar3)
eVar3
eventdata.events.search
Personnalisé 2 (event2)
event2
  1. Dans votre structure, développez la variable Configuration du suivi des liens zone.

  2. Désélectionnez Suivi des téléchargements.

  3. Sélectionner Suivi externe.

  4. Désélectionner Laisser la chaîne de requête.

  5. Utilisez la valeur suivante pour que la liste Filtres externes l’identifie en tant qu’URL externe :

    ‘yahoo.com’

  6. Ajoutez la valeur suivante au champ Événements de suivi des liens  :

    code language-none
        event1,event2
    
  7. Ajoutez la valeur suivante au champ Variables de suivi des liens  :

    code language-none
        eVar1,eVar2
    
  8. Sur la page qui est associée au framework, ajoutez un composant Texte. Dans le composant Texte, ajoutez un lien hypertexte avec l’adresse suivante :

    https://search.yahoo.com/?p=this

  9. Passez en mode Aperçu et cliquez sur le lien.

L’appel ressemblera à ceci une fois affiché avec Adobe Marketing Cloud Debugger :

aa-leavequerysearch-blank

NOTE
L’URL ne contient pas la chaîne de requête : ?p=this

Inclure le paramètre d’URL include-the-url-parameter

  1. Dans le cadre, développez la variable Configuration du suivi des liens zone.
  2. Activer Laisser la chaîne de requête.
  3. Rechargez l’aperçu de la page, puis cliquez sur le lien.

Les détails des appels qui apparaissent dans Adobe Marketing Cloud Debugger sont similaires à l’exemple suivant :

aa-leavequerysearch-active

NOTE
Cette fois, l’URL contient la chaîne de requête : ?p=this

Le suivi des liens ad hoc permet aux créateurs de contenu de configurer le suivi des liens pour un composant. La configuration du composant remplace la fonction Configuration du suivi des liens de la structure, donc sur les pages associées à la structure, Texte Les composants peuvent être configurés pour le suivi des liens des URL.

Le suivi des liens ad hoc vous permet de suivre les liens de téléchargement et les liens externes, ainsi que les données d’événement et de variable.

Pour activer le suivi des liens ad hoc, vous devez :

Configurez votre framework Adobe Analytics pour activer le suivi des liens ad hoc.

  1. Ouvrez le framework Adobe Analytics et développez la section Configuration du suivi des liens.

  2. Activer Suivi de liens ad hoc.

    note note
    NOTE
    Tous les types d’utilisateurs n’ont pas tous accès à cette case à cocher. Contactez votre administrateur de site si vous avez besoin d’un accès.
NOTE
La configuration XSS Antisamy se trouve à présent dans SLING dans le chemin d’accès /libs/sling/xss.config.xml et les règles suivantes doivent être ajoutées pour que les liens ad hoc fonctionnent :

Extension de règle de balise d’ancrage anchor-tag-rule-extension

<attribute name="onclick">
    <literal-list>
        <literal value="CQ_Analytics.Sitecatalyst.customTrack(this)"/>
    </literal-list>
</attribute>
<attribute name="adhocenable">
    <literal-list>
        <literal value="true"/>
        <literal value="false"/>
    </literal-list>
</attribute>
<attribute name="adhocevents">
    <regexp-list>
        <regexp name="anything"/>
    </regexp-list>
</attribute>
<attribute name="adhocevars">
    <regexp-list>
        <regexp name="anything"/>
    </regexp-list>
</attribute>

Pour pouvoir configurer le suivi des liens ad hoc pour les composants Texte eux-mêmes, les configurations suivantes doivent avoir déjà été mises en œuvre :

Appliquez la procédure suivante afin de configurer le suivi des liens pour un composant Texte  :

  1. Ouvrez la page en mode d’édition et modifiez le composant Texte.

  2. Sélectionnez le texte que vous souhaitez utiliser comme hypertexte et cliquez sur le bouton Lien hypertexte.

  3. Ajoutez l’URL cible dans la zone Lier à, puis développez la zone Suivi des liens.

    note note
    NOTE
    Le suivi des liens personnalisés est visible sous la forme d’une action distincte, en regard de l’action Lier/Dissocier (icône Analytics).
    Elle ne sera activée que si vous avez sélectionné un lien valide dans l’éditeur de texte enrichi.

    aa-17

  4. Activez le Suivi des liens personnalisés pour remplacer la configuration de suivi des liens du framework Adobe Analytics et activer le suivi des liens pour le lien actuel.

  5. (Facultatif) Pour suivre les événements avec le clic sur les liens, ajoutez les noms d’événement Adobe Analytics dans le champ Inclure les variables Adobe Analytics. Pour ajouter plusieurs noms d’événements, séparez-les par des virgules, par exemple

    event1, event22.

  6. (Facultatif) Pour suivre les données de variable avec le clic sur les liens, ajoutez les variables Adobe Analytics dans le champ Inclure les variables Adobe Analytics. Utilisez l’un des formats suivants :

    • *<Variable-name>*: *<Dynamic Value>*
    • *<Variable-name>*: *‘CONSTANT’*

    Les exemples suivants illustrent chaque format :

    • eVar10:pagedata.title
    • prop1: ‘Aubergine'

    S’il y a plusieurs valeurs, séparez-les par une virgule.

  7. Cliquez sur OK.

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8