onBeforeLinkClickSend

Med motringningen onBeforeLinkClickSend kan du registrera en JavaScript-funktion som kan ändra länkspårningsdata som du skickar precis innan dessa data skickas till Adobe. Med det här återanropet kan du ändra objektet xdm eller data, inklusive möjligheten att lägga till, redigera eller ta bort element. Du kan också villkorligt avbryta sändningen av data helt och hållet, t.ex. med identifierad robottrafik på klientsidan. Den stöds i Web SDK 2.15.0 eller senare.

Det här återanropet körs bara när clickCollectionEnabled är aktiverat och filterClickDetails inte innehåller någon registrerad funktion. Om clickCollectionEnabled är inaktiverat, eller om filterClickDetails innehåller en registrerad funktion, körs inte det här återanropet. Om onBeforeEventSend och onBeforeLinkClickSend båda innehåller registrerade funktioner körs onBeforeLinkClickSend först.

Konfigurera före länk genom att klicka på Skicka återanrop med tillägget Web SDK-tagg tag-extension

Klicka på knappen Provide on before link click event send callback code när du konfigurerar taggtillägget. Med den här kommandoknappen öppnas ett modalt fönster där du kan infoga den önskade koden.

I kodredigeraren har du tillgång till följande variabler:

Alla variabler som definierats utanför content kan användas, men inkluderas inte i nyttolasten som skickas till 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";

På samma sätt som onBeforeEventSend kan du return true slutföra funktionen direkt, eller return false om du vill avbryta överföringen av data till Adobe. Om du avbryter sändning av data i onBeforeLinkClickSend när både onBeforeEventSend och onBeforeLinkClickSend innehåller registrerade funktioner, körs inte funktionen onBeforeEventSend.

Konfigurera före länk genom att klicka på Skicka återanrop med Web SDK JavaScript-biblioteket library

Registrera onBeforeLinkClickSend-återanropet när du kör kommandot configure. Du kan ändra variabelnamnet content till vilket värde som helst genom att ändra parametervariabeln inuti den infogade funktionen.

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;
    }
  }
});

Du kan också registrera en egen funktion i stället för en infogad funktion.

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
});