onBeforeEventSend
Met de callback van onBeforeEventSend kunt u een JavaScript-functie registreren die de gegevens kan wijzigen die u verzendt vlak voordat die gegevens naar de Adobe worden verzonden. Met deze callback kunt u het object xdm of data bewerken, inclusief de mogelijkheid om elementen toe te voegen, te bewerken of te verwijderen. U kunt het verzenden van gegevens ook voorwaardelijk annuleren, zoals met ontdekt cliënt-zijbot verkeer.
Vorm vóór gebeurtenis verzend callback gebruikend de de markeringsuitbreiding van SDK van het Web tag-extension
Selecteer de Provide on before event send callback code knoop wanneer het vormen van de markeringsuitbreiding. Met deze knop opent u een modaal venster waarin u de gewenste code kunt invoegen.
- Login aan experience.adobe.comgebruikend uw geloofsbrieven van Adobe ID.
- Ga naar Data Collection > Tags.
- Selecteer de gewenste eigenschap tag.
- Navigeer naar Extensions en klik vervolgens op Configure op de Adobe Experience Platform Web SDK -kaart.
- Blader omlaag naar de sectie Data Collection en selecteer vervolgens de knop Provide on before event send callback code .
- Met deze knop opent u een modaal venster met een code-editor. Voeg de gewenste code in en klik op Save om het modale venster te sluiten.
- Klik op Save onder extensie-instellingen en publiceer uw wijzigingen.
In de code-editor hebt u toegang tot de volgende variabelen:
content.xdm: De XDMnuttige lading voor de gebeurtenis.content.data: De gegevensobjecten lading voor de gebeurtenis.return true: Sluit de callback onmiddellijk af en verzend gegevens naar de Adobe met de huidige waarden in hetcontent-object.return false: Sluit de callback onmiddellijk af en abort het verzenden van gegevens naar de Adobe.
Variabelen die buiten content worden gedefinieerd, kunnen worden gebruikt, maar worden niet opgenomen in de lading die naar de Adobe wordt verzonden.
// 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 niet op de eerste gebeurtenis op een pagina. Het retourneren van false op de eerste gebeurtenis kan een negatieve invloed hebben op de personalisatie.Vorm vóór gebeurtenis verzendt callback gebruikend de bibliotheek van JavaScript van SDK van het Web library
Registreer de callback onBeforeEventSend wanneer u de opdracht configure uitvoert. U kunt de naam van de variabele content wijzigen in elke gewenste waarde door de parametervariabele binnen de inline functie te wijzigen.
alloy("configure", {
datastreamId: "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');
}
});
U kunt ook uw eigen functie registreren in plaats van een inline functie.
function lastChanceLogic(content) {
content.xdm.application ??= {};
content.xdm.application.name = "App name";
}
alloy("configure", {
datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
onBeforeEventSend: lastChanceLogic
});