onBeforeLinkClickSend

Il onBeforeLinkClickSend callback consente di registrare una funzione JavaScript che può modificare i dati di tracciamento dei collegamenti inviati immediatamente prima che tali dati vengano inviati ad Adobe. Questo callback consente di manipolare xdm o data , inclusa la possibilità di aggiungere, modificare o rimuovere elementi. Puoi anche annullare completamente l’invio di dati in modo condizionale, ad esempio con il traffico bot lato client rilevato. È supportato dall’SDK web 2.15.0 o versione successiva.

Questo callback viene eseguito solo quando clickCollectionEnabled è abilitato e filterClickDetails non contiene una funzione registrata. Se clickCollectionEnabled è disabilitato o se filterClickDetails contiene una funzione registrata, quindi il callback non viene eseguito. Se onBeforeEventSend e onBeforeLinkClickSend entrambi contengono funzioni registrate, onBeforeLinkClickSend viene eseguito per primo.

Configurare prima del collegamento fai clic su Invia callback utilizzando l’estensione tag Web SDK tag-extension

Seleziona la Fornisci su prima del collegamento clic evento invia codice di callback quando configurazione dell’estensione tag. Questo pulsante apre una finestra modale in cui puoi inserire il codice desiderato.

Nell’editor di codice puoi accedere alle seguenti variabili:

Qualsiasi variabile definita al di fuori di content possono essere utilizzati, ma non sono inclusi nel payload inviato ad 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";

Simile a onBeforeEventSend, è possibile return true per completare immediatamente la funzione, oppure return false per interrompere l’invio di dati ad Adobe. Se interrompi l’invio di dati in onBeforeLinkClickSend quando entrambi onBeforeEventSend e onBeforeLinkClickSend contengono funzioni registrate, onBeforeEventSend La funzione non viene eseguita.

Configurare su prima del collegamento fare clic su Invia callback utilizzando la libreria JavaScript dell'SDK Web library

Registra il onBeforeLinkClickSend callback durante l'esecuzione di configure comando. È possibile modificare il content nome variabile a qualsiasi valore desiderato modificando la variabile di parametro all'interno della funzione in linea.

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

È inoltre possibile registrare una propria funzione invece di una funzione in linea.

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