Adobe使用者端資料層總覽

Adobe Client Data Layer (ACDL)是小型的開放原始碼JavaScript程式庫,可讓您的網站以標準方式公開資料與事件,給頁面上的任何指令碼。 您的網站程式碼會將資料和事件推送至名為adobeDataLayer的JavaScript陣列。 標籤規則、網頁SDK和其他指令碼會讀取該資料並監聽這些事件,而不論ACDL指令碼何時載入。

本指南會記錄ACDL程式庫。 若要在資料收集UI中使用ACDL,請參閱Adobe使用者端資料層標籤擴充功能。

為何使用資料層 why

若沒有資料層,標籤通常會從頁面中刮取值,例如DOM中的文字或URL中的引數。 這些實作會在頁面設計變更時中斷,而且只能收集頁面顯示的內容。 資料層可區分兩種職責:

  • 您的網站代碼​說明頁面上所發生的情況,例如頁面名稱、訪客檢視的產品或他們提交的表單。
  • 您的標籤和其他指令碼​將決定如何處理這些資訊,例如要將哪些資料傳送到Adobe以及何時傳送。

ACDL在此模式中新增了下列功能:

  • 非同步載入。 網站程式碼可在ACDL指令碼載入前推送資料。 ACDL在載入時會依序處理所有內容,因此您可以使用async或defer載入而不遺失資料。
  • 事件和接聽程式。 指令碼可監聽已命名事件或資料變更,包括新增監聽器之前發生的事件。
  • 計算狀態。 ACDL會將每次資料推送合併至任何指令碼可隨時讀取的單一物件。
  • 歷程記錄。 陣列會保留推送的資料和事件的記錄,協助您對實作進行偵錯。

運作方式 how-it-works

ACDL是圍繞純JavaScript陣列建置:

  1. 您的頁面會建立window.adobeDataLayer陣列(如果尚未存在)。
  2. 您的網站程式碼會將專案新增到具有push()的陣列。 專案可以是資料物件、事件物件或函式。 在ACDL載入之前,這些專案會在陣列中像佇列一樣等待。
  3. 當ACDL指令碼載入時,它會將方法新增到陣列,例如getState()和addEventListener(),並以它自己的版本取代push()。 然後會以推送的順序處理每個佇列專案。
  4. 從那時起,ACDL會在推送每個新專案時立即處理它。 它會將資料合併至計算狀態、符合事件接聽程式的呼叫,並將陣列中的資料和事件物件保留為history。
// Site code: describe what happened on the page
window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push({
  page: { title: "Home", language: "en" }
});
window.adobeDataLayer.push({ event: "page view" });

// Another script: react to what happened
window.adobeDataLayer.push(function(dl) {
  dl.addEventListener("page view", function(event) {
    console.log("Page title:", dl.getState("page.title"));
  });
});

因為接聽程式使用預設的all 範圍,所以它會針對page view事件執行,即使該事件是先推播的。

ACDL會在頁面內儲存及分發資料。 它不會將資料傳送至任何地方。 若要將資料傳送至Adobe,請使用標籤或網頁SDK來讀取資料層。 請參閱使用Web SDK傳送Adobe使用者端資料層資料。

ACDL搭配其他Adobe工具的運作方式 adobe-tools

工具
與ACDL的關係
標記
ACDL標籤擴充功能可以載入程式庫、在推送資料或事件時觸發規則、讀取資料元素中的計算狀態,以及推送資料或清除規則動作中的歷史記錄。
網頁SDK
網頁SDK會將資料傳送至Edge Network。 您的程式碼或標籤規則會從ACDL讀取資料,並將其傳遞至Web SDK。 請參閱使用Web SDK傳送Adobe使用者端資料層資料。
Adobe Experience Manager
核心元件2.9.0和更新版本包含ACDL,並可自動將元件資料和事件推送至其中。 請參閱搭配核心元件使用Adobe使用者端資料層。

資料格式 data-format

ACDL不需要特定的資料結構。 您可以推送任何純物件,然後ACDL會將其合併至計算狀態。 由於許多指令碼和團隊依賴相同的資料,請考慮以下做法:

  • 在您寫入資料層之前,先同意結構,並為所有推送或讀取資料的人記錄該結構。
  • 使用與JSON相容的值,例如字串、數字、布林值、純物件和陣列。 其他值(例如Date物件和函式)在合併後無法繼續使用。 檢視值型別。
  • 考慮您的目的地。 如果您將資料傳送到Adobe Experience Platform,您可以將資料結構成類似於XDM結構描述,以方便對應,或保留您自己的結構,並使用資料收集的資料準備將其對應到資料串流中。

瀏覽器需求 browser-requirements

ACDL 3.x使用瀏覽器的structuredClone()函式和現代JavaScript語法。 它需要下列其中一種瀏覽器或更新版本:

  • Chrome 98
  • Edge 98
  • Firefox 94
  • Safari 15.4

ACDL 2.x的瀏覽器需求較低。 請參閱從2.x升級至3.x瞭解版本之間的差異。

版本和原始程式碼 source

ACDL是Apache授權2.0下的開放原始碼。

若要檢查頁面上執行的版本,請讀取瀏覽器主控台中的version屬性:

adobeDataLayer.version

後續步驟 next-steps

recommendation-more-help
experience-platform-help-collection