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é.
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.
- Connexion à experience.adobe.com à l’aide de vos informations d’identification Adobe ID.
- Accédez à Collecte de données > Balises.
- Sélectionnez la propriété de balise de votre choix.
- Accédez à Extensions, puis cliquez sur Configurer sur le SDK Web Adobe Experience Platform carte.
- 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.
- 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.
- 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 variablecontent
.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;
}
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
});