onBeforeLinkClickSend

La variable onBeforeLinkClickSend callback vous permet d’enregistrer une fonction JavaScript qui peut modifier les données de suivi des liens que vous envoyez juste avant que ces données ne soient envoyées à Adobe. Ce rappel vous permet de manipuler la variable xdm ou data , y compris la possibilité d’ajouter, de modifier ou de supprimer des éléments. Vous pouvez également annuler de manière conditionnelle l’envoi de données, par exemple avec le trafic de robots côté client détecté. Elle est prise en charge sur le SDK Web 2.15.0 ou version ultérieure.

Ce rappel ne s’exécute que lorsque clickCollectionEnabled est activé et filterClickDetails ne contient pas de fonction enregistrée. If clickCollectionEnabled est désactivé, ou si filterClickDetails contient une fonction enregistrée, puis ce rappel ne s’exécute pas. If onBeforeEventSend et onBeforeLinkClickSend contiennent tous deux des fonctions enregistrées, onBeforeLinkClickSend est exécuté en premier.

Configurez avant le rappel de rappel de clic sur les liens à l’aide de l’extension de balise SDK Web. tag-extension

Sélectionnez la variable Fournir avant le code de rappel d’événement de clic sur les liens lorsque configuration de l’extension de balise. Ce bouton ouvre une fenêtre modale dans laquelle vous pouvez insérer le code de votre choix.

Dans l’éditeur de code, vous avez accès aux variables suivantes :

Toute variable définie en dehors de content peuvent être utilisées, mais ne sont pas incluses dans la payload envoyée à Adobe.

// Set an already existing value to something else
content.xdm.web.webPageDetails.URL = "https://example.com/current.html";

// Use nullish coalescing assignments to create objects if they don't yet exist, preventing undefined errors.
// Can be omitted if you are certain that the object is already defined
content.xdm._experience ??= {};
content.xdm._experience.analytics ??= {};
content.xdm._experience.analytics.customDimensions ??= {};
content.xdm._experience.analytics.customDimensions.eVars ??= {};

// Then set the property to the clicked element
content.xdm._experience.analytics.customDimensions.eVars.eVar1 = content.clickedElement;

// Use optional chaining to check if each object is defined, preventing undefined errors
if(content.xdm.web?.webInteraction?.type === "other") content.xdm.web.webInteraction.type = "download";

De la même manière que onBeforeEventSend, vous pouvez return true pour exécuter immédiatement la fonction ; ou return false pour abandonner l’envoi de données à Adobe. Si vous abandonnez l’envoi de données dans onBeforeLinkClickSend lorsque les deux onBeforeEventSend et onBeforeLinkClickSend contiennent des fonctions enregistrées, l’objet onBeforeEventSend ne s’exécute pas.

Configurez avant le rappel de rappel de clic sur les liens à l’aide de la bibliothèque JavaScript SDK Web library

Enregistrez le onBeforeLinkClickSend rappel lors de l’exécution de la fonction configure . Vous pouvez modifier la variable content nom de la variable à n’importe quelle valeur en modifiant la variable de paramètre dans la fonction intégrée.

alloy("configure", {
  edgeConfigId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  onBeforeLinkClickSend: function(content) {
    // Add, modify, or delete values
    content.xdm.web.webPageDetails.URL = "https://example.com/current.html";

    // Return true to complete the function immediately
    if (sendImmediate == true) {
      return true;
    }

    // Return false to cancel sending data immediately
    if(myBotDetector.isABot()){
      return false;
    }
  }
});

Vous pouvez également enregistrer votre propre fonction au lieu d’une fonction intégrée.

function lastChanceLinkLogic(content) {
  content.xdm.application ??= {};
  content.xdm.application.name = "App name";
}

alloy("configure", {
  edgeConfigId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  onBeforeLinkClickSend: lastChanceLinkLogic
});