Documentation Analytics Guide de mise en œuvre

ActivityMap.link

Dernière mise à jour : 23 juin 2025

Rubriques :
Implémentation d’Appmeasurement

Créé pour :

Administration
Développeur

La variable ActivityMap.link vous permet de remplacer la logique utilisée par 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.

ATTENTION

Cette variable remplace complètement la logique Activity Map. La définition d’une fonction de remplacement ici 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 de Web SDK

Vous pouvez utiliser OnBeforeLinkClickSend rappel pour modifier la payload de Web SDK ou abandonner 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.

ActivityMap.link dans AppMeasurement et l’éditeur de code personnalisé de l’extension Analytics

Affectez à cette variable une fonction qui :

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

Si la valeur renvoyée est false, 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 de titre des balises <a>. Si l’attribut de titre 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;
}

Renvoyer le nom du lien défini manuellement dans s.tl s’il existe, sinon renvoyer 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>

Si linkName est transmis, la méthode a été appelée par tl(). Renvoyez ce qui tl() transmis en tant que linkName.
Lorsqu’un linkName est appelé par Activity Map, il n’est jamais transmis. Appelez donc customFunction() avec l’élément de lien. Vous pouvez utiliser n’importe quelle fonction personnalisée que vous souhaitez pour renvoyer une valeur.
Si aucune des valeurs ci-dessus ne renvoie de valeur, utilisez le nom du lien normalement collecté comme solution de secours.

recommendation-more-help