onBeforeEventSend

La variable onBeforeEventSend callback vous permet d’enregistrer une fonction JavaScript qui peut modifier les données que vous envoyez juste avant que les données ne soient envoyées à Adobe. Ce rappel vous permet de manipuler la variable xdm ou data , y compris la possibilité d’ajouter, de modifier ou de supprimer des éléments. Vous pouvez également annuler de manière conditionnelle l’envoi de données, par exemple avec le trafic de robots côté client détecté.

WARNING
Ce rappel permet l’utilisation de code personnalisé. Si un code que vous incluez dans le rappel renvoie une exception non interceptée, le traitement de l’événement est interrompu. Les données ne sont pas envoyées à Adobe.

Configurez avant le rappel de l’envoi des événements à l’aide de l’extension de balise SDK Web. tag-extension

Sélectionnez la variable Fournir avant le code de rappel d’envoi d’événement lorsque configuration de l’extension de balise. Ce bouton ouvre une fenêtre modale dans laquelle vous pouvez insérer le code de votre choix.

  1. Connexion à experience.adobe.com à l’aide de vos informations d’identification Adobe ID.
  2. Accédez à Collecte de données > Balises.
  3. Sélectionnez la propriété de balise de votre choix.
  4. Accédez à Extensions, puis cliquez sur Configurer sur le SDK Web Adobe Experience Platform carte.
  5. Faites défiler l’écran vers le bas jusqu’à Collecte de données , puis cliquez sur le bouton Fournir avant le code de rappel d’envoi d’événement.
  6. Ce bouton ouvre une fenêtre modale avec un éditeur de code. Insérez le code souhaité, puis cliquez sur Enregistrer pour fermer la fenêtre modale.
  7. Cliquez sur Enregistrer sous paramètres d’extension, puis publiez vos modifications.

Dans l’éditeur de code, vous avez accès aux variables suivantes :

  • content.xdm: la variable XDM charge utile pour l’événement.
  • content.data: la variable data charge utile d’objet pour l’événement.
  • return true: quittez immédiatement le rappel et envoyez les données à l’Adobe avec les valeurs actuelles dans la variable content .
  • return false: quittez immédiatement le rappel et abandonnez l’envoi de données à Adobe.

Toute variable définie en dehors de content peuvent être utilisées, mais ne sont pas incluses dans la payload envoyée à Adobe.

// Use nullish coalescing assignments to add objects if they don't yet exist
content.xdm.commerce ??= {};
content.xdm.commerce.order ??= {};

// Then add the purchase ID
content.xdm.commerce.order.purchaseID = "12345";

// Use optional chaining to prevent undefined errors when setting tracking code to lower case
if(content.xdm.marketing?.trackingCode) content.xdm.marketing.trackingCode = content.xdm.marketing.trackingCode.toLowerCase();

// Delete operating system version
if(content.xdm.environment) delete content.xdm.environment.operatingSystemVersion;

// Immediately end onBeforeEventSend logic and send the data to Adobe for this event type
if (content.xdm.eventType === "web.webInteraction.linkClicks") {
  return true;
}

// Cancel sending data if it is a known bot
if (myBotDetector.isABot()) {
  return false;
}
TIP
Éviter le renvoi false lors du premier événement d’une page. Renvoi false le premier événement peut avoir un impact négatif sur la personnalisation.

Configurez avant le rappel de l’envoi d’événement à l’aide de la bibliothèque JavaScript du SDK Web library

Enregistrez le onBeforeEventSend rappel lors de l’exécution de la fonction configure . Vous pouvez modifier la variable content nom de la variable à n’importe quelle valeur en modifiant la variable de paramètre dans la fonction intégrée.

alloy("configure", {
  edgeConfigId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  onBeforeEventSend: function(content) {
    // Use nullish coalescing assignments to add a new value
    content.xdm._experience ??= {};
    content.xdm._experience.analytics ??= {};
    content.xdm._experience.analytics.customDimensions ??= {};
    content.xdm._experience.analytics.customDimensions.eVars ??= {};
    content.xdm._experience.analytics.customDimensions.eVars.eVar1 = "Analytics custom value";

    // Use optional chaining to change an existing value
    if(content.xdm.web?.webPageDetails) content.xdm.web.webPageDetails.URL = content.xdm.web.webPageDetails.URL.toLowerCase();

    // Remove an existing value
    if(content.xdm.web?.webReferrer) delete content.xdm.web.webReferrer.URL;

    // Return true to immediately send data
    if (sendImmediate == true) {
      return true;
    }

    // Return false to immediately cancel sending data
    if(myBotDetector.isABot()){
      return false;
    }

    // Assign the value in the 'cid' query string to the tracking code XDM element
    content.xdm.marketing ??= {};
    content.xdm.marketing.trackingCode = new URLSearchParams(window.location.search).get('cid');
  }
});

Vous pouvez également enregistrer votre propre fonction au lieu d’une fonction intégrée.

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

alloy("configure", {
  edgeConfigId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  onBeforeEventSend: lastChanceLogic
});
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636