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陣列建置:
- 您的頁面會建立
window.adobeDataLayer陣列(如果尚未存在)。 - 您的網站程式碼會將專案新增到具有
push()的陣列。 專案可以是資料物件、事件物件或函式。 在ACDL載入之前,這些專案會在陣列中像佇列一樣等待。 - 當ACDL指令碼載入時,它會將方法新增到陣列,例如
getState()和addEventListener(),並以它自己的版本取代push()。 然後會以推送的順序處理每個佇列專案。 - 從那時起,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會將資料傳送至Edge Network。 您的程式碼或標籤規則會從ACDL讀取資料,並將其傳遞至Web SDK。 請參閱使用Web SDK傳送Adobe使用者端資料層資料。
Adobe Experience Manager
核心元件2.9.0和更新版本包含ACDL,並可自動將元件資料和事件推送至其中。 請參閱搭配核心元件使用Adobe使用者端資料層。
資料格式 data-format
ACDL不需要特定的資料結構。 您可以推送任何純物件,然後ACDL會將其合併至計算狀態。 由於許多指令碼和團隊依賴相同的資料,請考慮以下做法:
瀏覽器需求 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下的開放原始碼。
- Source程式碼和問題: GitHub上的
adobe/adobe-client-data-layer - 封裝: npm上的
@adobe/adobe-client-data-layer - 發行說明: GitHub發行版本
若要檢查頁面上執行的版本,請讀取瀏覽器主控台中的version屬性:
adobeDataLayer.version
後續步驟 next-steps
recommendation-more-help
experience-platform-help-collection