tl

La méthode tl() est un composant principal important d’Adobe Analytics. Elle prend toutes les variables Analytics définies sur la page, les compile dans une demande d’image et envoie ces données aux serveurs de collecte de données Adobe. Elle fonctionne de la même manière que la méthode t(), mais cette méthode n’incrémente pas les pages vues. Elle est utile pour le suivi des liens et d’autres éléments qui ne seraient pas considérés comme un chargement de page complet.

Si trackDownloadLinks ou trackExternalLinks sont activés, AppMeasurement appelle automatiquement la méthode tl() pour envoyer les données de suivi des liens de téléchargement et de sortie. Si votre organisation préfère avoir plus de contrôle sur les liens à suivre et sur leur comportement, vous pouvez appeler la méthode tl() manuellement. Les liens personnalisés ne peuvent être suivis que manuellement.

Suivi des liens à l’aide du SDK Web

Le SDK Web ne fait pas la distinction entre les appels de pages vues et les appels de suivi de liens ; tous deux utilisent la commande sendEvent .

Si vous utilisez un objet XDM et souhaitez qu’Adobe Analytics comptabilise un événement donné comme un appel de suivi des liens, assurez-vous que vos données XDM comprennent :

alloy("sendEvent", {
  "xdm": {
    "web": {
      "webInteraction": {
        "name": "My Custom Link",
        "URL": "https://example.com",
        "type": "other"
      }
    }
  }
});

Si vous utilisez un objet de données et souhaitez qu’Adobe Analytics comptabilise un événement donné comme un appel de suivi des liens, assurez-vous que votre objet de données comprend :

alloy("sendEvent", {
  "data": {
    "__adobe": {
      "analytics": {
        "linkName": "My custom link",
        "linkURL": "https://example.com",
        "linkType": "o"
      }
    }
  }
});

Suivi des liens à l’aide de l’extension Adobe Analytics

L’extension Adobe Analytics dispose d’un emplacement dédié pour définir un appel de suivi des liens.

Vous ne pouvez pas définir d’arguments facultatifs dans l’extension Analytics.

s.tl() dans AppMeasurement et l’éditeur de code personnalisé de l’extension Analytics

Appelez la méthode s.tl() lorsque vous souhaitez envoyer un appel de suivi à Adobe.

s.tl([Link object],[Link type],[Link name],[Override variable]);

Objet du lien (obligatoire)

L’argument d’objet du lien détermine si le navigateur attend jusqu’à 500 ms avant de quitter la page. Si une demande d’image est envoyée avant 500 ms, la page accède immédiatement au lien sur lequel l’utilisateur a cliqué.

// Include a 500ms delay with an exit link
s.tl(this,"e","Example exit link");

// Do not include a 500ms delay with an exit link
s.tl(true,"e","Example exit link");

Type de lien (obligatoire)

L’argument de type de lien est une chaîne d’un seul caractère qui détermine le type d’appel de suivi des liens. Il existe trois valeurs valides.

// Send a custom link
s.tl(true,"o","Example custom link");

// Send a download link
s.tl(true,"d","Example download link");

// Send an exit link
s.tl(true,"e","Example exit link");

Nom du lien (recommandé)

L’argument du nom du lien est une chaîne qui détermine l’élément de dimension de suivi des liens. Cette chaîne contient l’élément de dimension lorsque vous utilisez les dimensions Lien personnalisé, Lien de téléchargement ou Lien de sortie dans le compte rendu des performances. Si cet argument n’est pas défini, la variable linkURL est utilisée.

// When using the Download link dimension, this method call increases the occurrences metric for "Sea turtle PDF report" by 1.
s.tl(true,"d","Sea turtle PDF report");

Remplacements de variables (facultatif)

Permet de modifier les valeurs de variable pour un appel unique. Pour plus d’informations, voir Remplacements de variable.

var y = new Object();
y.eVar1 = "Override value";
y.linkTrackVars = "eVar1";
s.tl(true,"o","Example custom link",y);

Exemples et cas d’utilisation

Envoyez un appel de suivi de lien de base directement dans un lien HTML :

<a href="example.html" onClick="s.tl(true,'o','Example link');">Click here</a>

Utilisez JavaScript pour effectuer un appel de suivi de lien de base à l’aide d’arguments de méthode :

s.tl(true,"o","Example link");

Effectuez des appels de suivi de lien dans une fonction personnalisée

Vous pouvez consolider le code de suivi des liens dans une fonction JavaScript autonome. Des appels peuvent ensuite être effectués dans la fonction onClick de chaque lien. Définissez les éléments suivants dans un fichier JavaScript :

function trackClickInteraction(name){
  s.linkTrackVars = "eVar1,eVar2";
  s.eVar1 = name;
  s.eVar2 = s.pageName;
  s.tl(true,"o",name);
}

Vous pouvez ensuite appeler la fonction lorsque vous souhaitez effectuer le suivi d’un lien donné :

<!-- Use wherever you want to track links -->
<a href="example.html" onClick="trackClickInteraction('Example link');">Click here</a>

Éviter le suivi des liens en double

Si trackDownloadLinks ou trackExternalLinks sont activés, AppMeasurement effectue automatiquement un appel de suivi des liens si les filtres corrects correspondent. Si vous appelez également manuellement s.tl() pour ces clics sur les liens, vous pouvez envoyer des données en double à Adobe. Les données en double gonflent le nombre de rapports et les rendent moins précis.

Par exemple, la fonction suivante envoie deux appels de suivi de liens pour le même clic de lien (liens de téléchargement manuels et automatiques) :

function trackDownload(obj) {
  s.tl(obj,"d","Example PDF download");
}

Vous pouvez contribuer à empêcher les appels de suivi de liens en double en utilisant la fonction modifiée suivante. Il vérifie tout d’abord s’il existe un objet de lien et envoie un appel de suivi manuel des liens uniquement si l’objet de lien est une chaîne vide.

function linkCode(obj) {
  var lt = obj.href != null ? s.lt(obj.href) : "";
  if (lt=="") {
    s.tl(obj,"d","Example PDF download");
  }
}

Utilisation de la méthode tl() avec Activity Map

Vous pouvez utiliser la méthode tl() pour effectuer le suivi des éléments personnalisés et configurer le rendu des superpositions pour le contenu dynamique. Le paramètre linkName est également utilisé pour définir la dimension Lien Activity Map.

Lorsque la méthode tl() est appelée directement à partir de l’événement "onclick" de l’élément HTML, l’Activity Map peut afficher une superposition pour cet élément lorsque la page web est chargée. Par exemple :

<a href="index.html" onclick="s.tl(this,'o','Example custom link');">Example link text</a>

Lorsque la méthode tl() n’est pas appelée directement à partir de l’événement "onclick" de l’élément HTML, l’Activity Map ne peut afficher qu’une superposition après avoir cliqué sur l’élément. Par exemple :

<a href="index.html" onclick="someFn(event);">Example link text</a>
<script>
  function someFn (event) {
    s.tl(event.srcElement,'o','Example custom link');
  }
</script>