ActivityMap.link

Dernière mise à jour : 17 juillet 2024
  • Rubriques :

Créé pour :

  • Administration
  • Développeur

La variable ActivityMap.link vous permet de remplacer la logique utilisée par l’Activity Map pour définir les valeurs de lien. Cette variable est utile dans les zones où vous souhaitez avoir plus de contrôle que ce que ActivityMap.linkExclusions fournit.

CAUTION
Cette variable remplace complètement la logique Activity Map. La définition d’une fonction de remplacement qui renvoie des valeurs incorrectes peut entraîner des problèmes de collecte de données avec les dimensions Activity Map et la superposition Activity Map.

Remplacement des valeurs de lien à l’aide du SDK Web

Vous pouvez utiliser le rappel OnBeforeLinkClickSend pour modifier la charge utile du SDK Web ou interrompre l’envoi de données.

Remplacement de lien à l’aide de l’extension Adobe Analytics

Il n’existe pas de champ dédié dans l’extension Adobe Analytics pour utiliser cette variable. Utilisez l’éditeur de code personnalisé, en respectant la syntaxe AppMeasurement.

Attribuez à cette variable une fonction qui :

  • reçoit l’élément d’HTML sur lequel l’utilisateur a cliqué ; et
  • Renvoie une valeur string . Cette valeur string est la valeur finale utilisée pour la dimension Lien Activity Map.

Si la valeur renvoyée est falsy, toutes les variables de données contextuelles Activity Map sont effacées et aucune donnée de lien n’est suivie.

Exemples

N’utilisez que l’attribut title des balises <a>. Si l’attribut title n’est pas présent, aucun lien n’est suivi.

s.ActivityMap.link = function(clickedElement) {
  var linkId;
  if (clickedElement && clickedElement.tagName.toUpperCase() === 'A') {
    linkId = clickedElement.getAttribute('title');
  }
  return linkId;
}

Renvoie le nom du lien défini manuellement dans s.tl s’il existe, sinon renvoie l’URL du lien.

s.ActivityMap.link = function(ele, linkName) {
  if (linkName) {
    return linkName;
  }
  if (ele && ele.tagName == 'A' && ele.href) {
    return ele.href;
  }
}

Au lieu de remplacer complètement la logique de lien par défaut, vous pouvez la modifier de manière conditionnelle.

<script>
  // Copy the original link function
  var originalLinkFunction = s.ActivityMap.link;
  // Return the link name from s.tl, a modified activity map value, or the original activity map value
  s.ActivityMap.link = function(element,linkName)
  {
    return linkName || customFunction(element) || originalLinkFunction(element,linkName);
  };
</script>

<button type="button" onclick="s.tl(this,'o',customFunction(this)">Add To Cart</button>
  1. Si linkName est transmis, la méthode a été appelée par tl(). Renvoie ce que tl() a transmis en tant que linkName.
  2. Lorsqu'il est appelé par un Activity Map, un linkName n'est jamais transmis. Par conséquent, appelez customFunction() avec l'élément de lien. Vous pouvez utiliser n’importe quelle fonction personnalisée dont vous souhaitez renvoyer une valeur.
  3. Si aucune des valeurs renvoyées ci-dessus n’est utilisée, utilisez le nom du lien normalement collecté comme secours.
Page précédentetl
Page suivanteActivityMap.region

Analytics