onBeforeLinkClickSend

El onBeforeLinkClickSend la devolución de llamada le permite registrar una función de JavaScript que puede alterar los datos de seguimiento de vínculos que envía justo antes de que dichos datos se envíen al Adobe. Esta llamada de retorno le permite manipular la variable xdm o data , incluida la posibilidad de agregar, editar o eliminar elementos. También puede cancelar de forma condicional el envío de datos, por ejemplo, con el tráfico de bots del lado del cliente detectado. Es compatible con el SDK web 2.15.0 o posterior.

Esta llamada de retorno solo se ejecuta cuando clickCollectionEnabled está habilitado y filterClickDetails no contiene una función registrada. If clickCollectionEnabled está desactivado, o si filterClickDetails contiene una función registrada, la llamada de retorno no se ejecuta. If onBeforeEventSend y onBeforeLinkClickSend ambas contienen funciones registradas, onBeforeLinkClickSend se ejecuta primero.

Configure en antes de que el vínculo haga clic en enviar llamada de retorno mediante la extensión de etiqueta del SDK web tag-extension

Seleccione el Proporcionar antes del código de devolución de llamada de envío de evento de clic de vínculo botón cuando configuración de la extensión de etiqueta. Este botón abre una ventana modal donde puede insertar el código deseado.

En el editor de código, tiene acceso a las siguientes variables:

Cualquier variable definida fuera de content se pueden usar, pero no se incluyen en la carga útil enviada al 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 forma similar a onBeforeEventSend, puede return true para completar la función inmediatamente, o return false para anular el envío de datos al Adobe. Si interrumpe el envío de datos en onBeforeLinkClickSend cuando ambos onBeforeEventSend y onBeforeLinkClickSend contener funciones registradas, la variable onBeforeEventSend La función no se ejecuta.

Activar la configuración antes de hacer clic en el vínculo para enviar la llamada de retorno mediante la biblioteca JavaScript del SDK web library

Registre el onBeforeLinkClickSend devolución de llamada al ejecutar configure comando. Puede cambiar el content nombre de la variable a cualquier valor que desee cambiando la variable del parámetro dentro de la función dentro de la línea.

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

También puede registrar su propia función en lugar de una función en línea.

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