使用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" }
});

您還需要下列專案,具體取決於您的方法:

JavaScript資料庫

Web SDK基底程式碼會排入命令佇列,直到其程式庫載入為止,而ACDL則會排入專案佇列,直到其程式庫載入為止。 由於這些佇列,您可以將程式碼新增至此頁面上的Web SDK基底程式碼之後的任何位置,無論哪個程式庫會先載入。

標籤延伸模組

選擇對應資料的方式 mapping

Web SDK會以兩個物件傳送資料。 選擇一或兩者:

物件
對應如何運作
使用時機
xdm
您可以在程式碼或標籤規則中,從資料層值中建置符合您XDM結構的物件。
您想要完整控制承載,或資料層已類似於您的架構。
data
您可以依原樣傳送資料層值。 您可以使用資料收集的資料準備將它們對應到資料串流中的XDM。
您想要將對應邏輯阻擋在頁面程式碼和標籤規則之外,或者數個網站共用一個妥善控管的資料層。

選擇值的來源 value-sources

當ACDL事件觸發程式碼或規則時,您可以從兩個位置讀取資料層值:

來源
JavaScript資料庫
標籤擴充功能
包含
已推送的物件
event.page.title,其中event是接聽程式的引數
%event.message.page.title%
僅限觸發事件的物件。
計算狀態
adobeDataLayer.getState("page.title")
路徑為page.title的 資料層計算狀態 資料元素
目前為止,所有從每次推播合併的資料。

將推送物件用於描述事件本身的值,例如新增購物車中的產品。 針對先前推送的值(例如使用者詳細資訊),使用計算狀態。 當程式碼或規則執行時,運算狀態已包含來自觸發該運算式的推播資料。 檢視監聽器收到的內容和使用規則中的推播資料。

傳送XDM資料 xdm

下列範例會從推送的物件傳送含有頁面標題的頁面檢視。

JavaScript資料庫

接聽事件並呼叫sendEvent:

code language-js
window.adobeDataLayer = window.adobeDataLayer || [];

function sendPageView(event) {
  alloy("sendEvent", {
    xdm: {
      eventType: "web.webpagedetails.pageViews",
      web: {
        webPageDetails: {
          name: event.page.title,
          pageViews: { value: 1 }
        }
      }
    }
  });
}

window.adobeDataLayer.push(function(dl) {
  dl.addEventListener("page view", sendPageView);
});

如需所有接聽程式選項,請參閱addEventListener()。

標籤延伸模組
  1. 使用Web SDK擴充功能建立 變數 資料元素。 選取​XDM,然後選取您的沙箱和結構描述。 此範例將資料元素命名為XDM variable。

  2. 建立規則並新增事件:

    • 延伸模組: Adobe使用者端資料層
    • 事件型別: 資料層推播
    • 於​觸發程式: 具名的特定事件,事件名稱為page view
    • 時間範圍: 全部
  3. 新增填入XDM物件的動作:

    • 擴充功能: Adobe Experience Platform Web SDK
    • 動作型別: 更新變數
    • 資料元素: XDM variable
    • 將web.webPageDetails.name設為%event.message.page.title%,並將web.webPageDetails.pageViews.value設為1。
  4. 新增傳送事件的動作:

    • 擴充功能: Adobe Experience Platform Web SDK
    • 動作型別: 傳送事件
    • 型別: web.webpagedetails.pageViews
    • XDM: %XDM variable%
  5. 儲存規則、將其新增至程式庫,然後建置程式庫。

如需所有事件選項,請參閱資料層推播。

每次在您的網站推播page view事件時,程式碼或規則都會將頁面檢視傳送至Edge Network。

以相同方式傳送互動。 例如,針對推播(例如{ event: "cart add", eventInfo: { sku: "HT105" } }),在cart add上接聽或觸發,並從eventInfo讀取產品。 有關描述商務互動的XDM欄位,請參閱收集商務、產品和訂單資訊。

傳送資料層以在資料串流中進行對應 data

若要對應資料串流而非程式碼或規則,請在data物件中傳送資料層值,並加入XDM eventType,以便事件可正確分類。

JavaScript資料庫
code language-js
function sendWithDataPrep(event) {
  alloy("sendEvent", {
    xdm: { eventType: "web.webpagedetails.pageViews" },
    data: this.getState()
  });
}

window.adobeDataLayer.push(function(dl) {
  dl.addEventListener("page view", sendWithDataPrep);
});

在ACDL接聽程式內,this參考資料層,因此this.getState()會傳回計算狀態。 若要只傳送其中一部分,請傳遞路徑,例如this.getState("page")。

標籤延伸模組
  1. 建立具有ACDL延伸的​ 資料層計算狀態 ​資料元素。 選取​整個計算狀態,或選取​ 特定路徑 ​並輸入您要傳送的資料路徑。 此範例將資料元素命名為ACDL state。

  2. 建立與傳送XDM資料具有相同​ 資料層推播 ​事件的規則。

  3. 從Web SDK擴充功能新增​ 傳送事件 ​動作:

    • 型別: web.webpagedetails.pageViews
    • 資料: %ACDL state%
  4. 儲存規則、將其新增至程式庫,然後建置程式庫。

然後,在您的資料流中,對應您傳送至XDM結構描述的欄位。 請參閱資料彙集🔗的資料準備。 您未對應且未設定服務讀取的資料不會儲存。 傳送整個計算狀態也會增加每個要求的大小,因此在資料層很大的頁面上,只傳送您對應的部分。

單頁應用程式 spa

在單頁應用程式中,當訪客檢視許多虛擬頁面時,頁面會保持開啟,而資料層歷程記錄會持續成長。 推送每個虛擬頁面檢視的page view事件,並在傳送歷程記錄後將其清除。 清除歷史記錄不會變更計算狀態,也不會移除監聽器和規則。

JavaScript資料庫

清除頁面檢視監聽器結尾的歷史記錄:

code language-js
function sendPageView(event) {
  alloy("sendEvent", { /* ... */ });
  this.length = 0;
}

請參閱清除歷程記錄。

標籤延伸模組
從ACDL擴充功能新增 清除資料層歷程記錄 動作,作為頁面檢視規則的最後一個動作。

時間與重複專案 timing

請依照下列作法,每個事件只傳送一次:

  • 使用all範圍。 兩種方法的預設值皆為: JavaScript中的scope選項和標籤中的​ 時間範圍 ​設定。 它會傳送在接聽程式或規則開始接聽之前推送的事件,例如在載入指令碼或標籤程式庫之前推送的頁面檢視。 只有在您實作的另一個部分已傳送先前事件時,才使用future。 檢視範圍。
  • 從單一位置傳送每個事件。 如果您自己的程式碼和標籤規則傳送相同的資料層事件,Adobe會收到兩次。
  • JavaScript資料庫:使用具名函式,並新增每個接聽程式一次。 ACDL會針對相同事件忽略相同函式的第二個註冊。 不過,如果每次重複執行的程式碼都傳遞新的匿名函式,ACDL每次都會新增一個新的接聽程式,而且每個事件都會傳送多次。
  • 標籤延伸模組:觸發特定事件名稱。 在​ 所有資料變更 ​上觸發的規則會在每次資料推送時執行,這會傳送比您預期多得多的事件。
recommendation-more-help
experience-platform-help-collection