onBeforeLinkClickSend

Mit dem Rückruf onBeforeLinkClickSend können Sie eine JavaScript-Funktion registrieren, die die von Ihnen gesendeten Linktracking-Daten ändern kann, bevor diese Daten an Adobe gesendet werden. Mit diesem Rückruf können Sie das Objekt xdm oder data bearbeiten, einschließlich der Möglichkeit, Elemente hinzuzufügen, zu bearbeiten oder zu entfernen. Sie können das Senden von Daten auch bedingt abbrechen, z. B. mit erkanntem clientseitigem Bot-Traffic. Es wird auf Web SDK 2.15.0 oder höher unterstützt.

Dieser Rückruf wird nur ausgeführt, wenn clickCollectionEnabled aktiviert ist und filterClickDetails keine registrierte Funktion enthält. Wenn clickCollectionEnabled deaktiviert ist oder filterClickDetails eine registrierte Funktion enthält, wird dieser Rückruf nicht ausgeführt. Wenn onBeforeEventSend und onBeforeLinkClickSend beide registrierte Funktionen enthalten, wird zuerst onBeforeLinkClickSend ausgeführt.

Vor dem Link-Klick Callback mit der Web SDK-Tag-Erweiterung konfigurieren tag-extension

Wählen Sie bei der Konfiguration der Tag-Erweiterung die Schaltfläche Vor dem Link-Klick-Ereignis bereitstellen - Callback-Code senden aus.Diese Schaltfläche öffnet ein modales Fenster, in das Sie den gewünschten Code einfügen können.

Im Code-Editor haben Sie Zugriff auf die folgenden Variablen:

Alle Variablen, die außerhalb von content definiert sind, können verwendet werden, sind jedoch nicht in der Payload enthalten, die an Adobe gesendet wird.

// 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";

Ähnlich wie bei onBeforeEventSend können Sie return true die Funktion sofort abschließen oder return false den Versand von Daten an Adobe abbrechen. Wenn Sie das Senden von Daten in onBeforeLinkClickSend abbrechen, wenn sowohl onBeforeEventSend als auch onBeforeLinkClickSend registrierte Funktionen enthalten, wird die Funktion onBeforeEventSend nicht ausgeführt.

Vor dem Link-Klick Callback mit der Web SDK JavaScript-Bibliothek konfigurieren library

Registrieren Sie den Rückruf onBeforeLinkClickSend , wenn Sie den Befehl configure ausführen. Sie können den Variablennamen content in einen beliebigen Wert ändern, indem Sie die Parametervariable innerhalb der Inline-Funktion ändern.

alloy("configure", {
  datastreamId: "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;
    }
  }
});

Sie können auch Ihre eigene Funktion anstelle einer Inline-Funktion registrieren.

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

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