onBeforeEventSend
onBeforeEventSend
回呼可讓您註冊JavaScript函式,該函式可變更您在傳送資料給Adobe之前所傳送的資料。 此回呼可讓您操作xdm
或data
物件,包括新增、編輯或移除元素的功能。 您也可以有條件地完全取消傳送資料,例如使用偵測到的使用者端機器人流量。
WARNING
此回呼允許使用自訂程式碼。 如果您包含在回呼中的任何程式碼擲回未攔截到的例外狀況,處理事件時就會中止。 資料不會傳送至Adobe。
使用Web SDK標籤擴充功能設定在事件傳送回呼之前 tag-extension
在設定標籤延伸模組時,選取 Provide on before event send回呼代碼 按鈕。 此按鈕會開啟一個強制回應視窗,您可在其中插入所需的程式碼。
- 使用您的Adobe ID憑證登入experience.adobe.com。
- 導覽至 資料彙集 > 標籤。
- 選取所需的標籤屬性。
- 導覽至 擴充功能,然後按一下Adobe Experience Platform Web SDK卡片上的 設定。
- 向下捲動至Data Collection區段,然後選取按鈕 在事件傳送回撥代碼前提供。
- 此按鈕會開啟包含程式碼編輯器的模型視窗。 插入想要的程式碼,然後按一下[儲存] 以關閉模型視窗。
- 按一下擴充功能設定下的 [儲存],然後發佈您的變更。
在程式碼編輯器中,您可以存取下列變數:
任何在content
外部定義的變數都可以使用,但不包含在傳送給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
避免在頁面上的第一個事件上傳回
false
。 在第一個事件中傳回false
可能會對個人化產生負面影響。使用Web SDK JavaScript程式庫設定在事件傳送回呼之前 library
執行configure
命令時登入onBeforeEventSend
回呼。 您可以透過變更內嵌函式內的引數變數,將content
變數名稱變更為任何您想要的值。
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');
}
});
您也可以註冊自己的函式,而非內嵌函式。
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
});
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636