onBeforeLinkClickSend

O retorno de chamada onBeforeLinkClickSend permite registrar uma função JavaScript que pode alterar os dados de rastreamento de link enviados antes que esses dados sejam enviados para o Adobe. Este retorno de chamada permite manipular o objeto xdm ou data, incluindo a capacidade de adicionar, editar ou remover elementos. Você também pode cancelar condicionalmente o envio de dados, como com o tráfego de bot do lado do cliente detectado. Ele é compatível com o SDK da Web 2.15.0 ou posterior.

Este retorno de chamada só é executado quando clickCollectionEnabled está habilitado e filterClickDetails não contém uma função registrada. Se clickCollectionEnabled estiver desabilitado ou se filterClickDetails contiver uma função registrada, esse retorno de chamada não será executado. Se onBeforeEventSend e onBeforeLinkClickSend contêm funções registradas, onBeforeLinkClickSend é executado primeiro.

Configurar no antes do link e clicar em enviar retorno de chamada usando a extensão de tag do SDK da Web tag-extension

Selecione o botão Fornecer antes do link para enviar código de retorno de chamada ao configurar a extensão de marca. Esse botão abre uma janela modal onde você pode inserir o código desejado.

No editor de código, você tem acesso às seguintes variáveis:

Qualquer variável definida fora de content pode ser usada, mas não está incluída na carga enviada para o 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 modo semelhante a onBeforeEventSend, você pode return true para concluir a função imediatamente ou return false para suspender o envio de dados para o Adobe. Se você anular o envio de dados em onBeforeLinkClickSend quando onBeforeEventSend e onBeforeLinkClickSend contiverem funções registradas, a função onBeforeEventSend não será executada.

Configurar no antes do link e clicar em enviar retorno de chamada usando a biblioteca JavaScript do SDK da Web library

Registre o retorno de chamada onBeforeLinkClickSend ao executar o comando configure. Você pode alterar o nome da variável content para qualquer valor desejado alterando a variável de parâmetro dentro da função embutida.

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

Você também pode registrar sua própria função em vez de uma função em linha.

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