使用Web SDK傳送Adobe使用者端資料層資料
Adobe使用者端資料層(ACDL)會收集頁面上的資料和事件,但不會將其傳送至任何地方。 若要將其傳送到Adobe Experience Platform Edge Network,請以下列其中一種方式將ACDL事件連線到Web SDK:
- JavaScript資料庫:您自己的程式碼會接聽ACDL事件並呼叫Web SDK
sendEvent命令。 - 標籤擴充功能:標籤規則會使用ACDL擴充功能來觸發ACDL事件,並使用Web SDK擴充功能來傳送資料。
本頁面的每個區段都會顯示這兩種方法。
先決條件 prerequisites
您的網站程式碼會推送您要傳送的資料和事件。 此頁面上的範例針對每個頁面檢視使用以下推送:
window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push({
event: "page view",
page: { title: "Home", language: "en" }
});
您還需要下列專案,具體取決於您的方法:
選擇對應資料的方式 mapping
Web SDK會以兩個物件傳送資料。 選擇一或兩者:
選擇值的來源 value-sources
當ACDL事件觸發程式碼或規則時,您可以從兩個位置讀取資料層值:
event.page.title,其中event是接聽程式的引數%event.message.page.title%將推送物件用於描述事件本身的值,例如新增購物車中的產品。 針對先前推送的值(例如使用者詳細資訊),使用計算狀態。 當程式碼或規則執行時,運算狀態已包含來自觸發該運算式的推播資料。 檢視監聽器收到的內容和使用規則中的推播資料。
傳送XDM資料 xdm
下列範例會從推送的物件傳送含有頁面標題的頁面檢視。
接聽事件並呼叫sendEvent:
| code language-js |
|---|
|
如需所有接聽程式選項,請參閱addEventListener()。
-
使用Web SDK擴充功能建立 變數 資料元素。 選取XDM,然後選取您的沙箱和結構描述。 此範例將資料元素命名為
XDM variable。 -
建立規則並新增事件:
- 延伸模組: Adobe使用者端資料層
- 事件型別: 資料層推播
- 於觸發程式: 具名的特定事件,事件名稱為
page view - 時間範圍: 全部
-
新增填入XDM物件的動作:
- 擴充功能: Adobe Experience Platform Web SDK
- 動作型別: 更新變數
- 資料元素:
XDM variable - 將
web.webPageDetails.name設為%event.message.page.title%,並將web.webPageDetails.pageViews.value設為1。
-
新增傳送事件的動作:
- 擴充功能: Adobe Experience Platform Web SDK
- 動作型別: 傳送事件
- 型別:
web.webpagedetails.pageViews - XDM:
%XDM variable%
-
儲存規則、將其新增至程式庫,然後建置程式庫。
如需所有事件選項,請參閱資料層推播。
每次在您的網站推播page view事件時,程式碼或規則都會將頁面檢視傳送至Edge Network。
以相同方式傳送互動。 例如,針對推播(例如{ event: "cart add", eventInfo: { sku: "HT105" } }),在cart add上接聽或觸發,並從eventInfo讀取產品。 有關描述商務互動的XDM欄位,請參閱收集商務、產品和訂單資訊。
傳送資料層以在資料串流中進行對應 data
若要對應資料串流而非程式碼或規則,請在data物件中傳送資料層值,並加入XDM eventType,以便事件可正確分類。
| code language-js |
|---|
|
在ACDL接聽程式內,this參考資料層,因此this.getState()會傳回計算狀態。 若要只傳送其中一部分,請傳遞路徑,例如this.getState("page")。
-
建立具有ACDL延伸的 資料層計算狀態 資料元素。 選取整個計算狀態,或選取 特定路徑 並輸入您要傳送的資料路徑。 此範例將資料元素命名為
ACDL state。 -
建立與傳送XDM資料具有相同 資料層推播 事件的規則。
-
從Web SDK擴充功能新增 傳送事件 動作:
- 型別:
web.webpagedetails.pageViews - 資料:
%ACDL state%
- 型別:
-
儲存規則、將其新增至程式庫,然後建置程式庫。
然後,在您的資料流中,對應您傳送至XDM結構描述的欄位。 請參閱資料彙集🔗的資料準備。 您未對應且未設定服務讀取的資料不會儲存。 傳送整個計算狀態也會增加每個要求的大小,因此在資料層很大的頁面上,只傳送您對應的部分。
單頁應用程式 spa
在單頁應用程式中,當訪客檢視許多虛擬頁面時,頁面會保持開啟,而資料層歷程記錄會持續成長。 推送每個虛擬頁面檢視的page view事件,並在傳送歷程記錄後將其清除。 清除歷史記錄不會變更計算狀態,也不會移除監聽器和規則。
時間與重複專案 timing
請依照下列作法,每個事件只傳送一次:
- 使用
all範圍。 兩種方法的預設值皆為: JavaScript中的scope選項和標籤中的 時間範圍 設定。 它會傳送在接聽程式或規則開始接聽之前推送的事件,例如在載入指令碼或標籤程式庫之前推送的頁面檢視。 只有在您實作的另一個部分已傳送先前事件時,才使用future。 檢視範圍。 - 從單一位置傳送每個事件。 如果您自己的程式碼和標籤規則傳送相同的資料層事件,Adobe會收到兩次。
- JavaScript資料庫:使用具名函式,並新增每個接聽程式一次。 ACDL會針對相同事件忽略相同函式的第二個註冊。 不過,如果每次重複執行的程式碼都傳遞新的匿名函式,ACDL每次都會新增一個新的接聽程式,而且每個事件都會傳送多次。
- 標籤延伸模組:觸發特定事件名稱。 在 所有資料變更 上觸發的規則會在每次資料推送時執行,這會傳送比您預期多得多的事件。
相關頁面 related
sendEvent命令和 傳送事件 動作:傳送事件的所有Web SDK選項。addEventListener()和資料層推播:所有接聽ACDL事件的選項。