建立資料層
資料層是網站上的JavaScript結構,會公開Analytics實作收集的資料,例如頁面名稱、產品詳細資料和訂單ID。 您的網站程式碼會寫入資料層,而實作會從中讀取資料,以設定Analytics變數。 由於您的實施不依賴頁面的HTML,因此您可以重新設計網站而不會中斷資料收集。
先決條件
建立解決方案設計檔案:貴組織必須符合追蹤需求。 請確保在接洽組織內的開發團隊之前,已備妥解決方案設計文件。 解決方案設計所需的資料會決定資料層包含的內容。
選擇資料層規格 specifications
Adobe建議針對新的或重組的實作使用Adobe使用者端資料層 (ACDL)。 ACDL是開放原始碼的JavaScript程式庫,可讓您的網站以標準方式推送資料和事件至全域adobeDataLayer陣列。 標籤、網頁SDK和AppMeasurement都可以讀取,而Adobe Experience Manager核心元件可以自動填入標籤。
您的組織可以自由使用其他規格,例如客戶體驗數位資料層 (CEDDL) (將資料儲存在全域digitalData物件中)或自訂規格。 最重要的是貴組織必須符合其需求的規格。
下表比較ACDL與物件資料層(例如CEDDL):
adobeDataLayer)digitalData)adobeDataLayer.push({ page: { name: "Home" } })digitalData.page.pageInfo.pageName = "Home"adobeDataLayer.getState("page.name")或 資料層計算狀態 資料元素digitalData.page.pageInfo.pageName或核心標籤擴充功能中的 JavaScript變數 資料元素{ event: "page view" }),而您的實作會監聽該事件。 也會針對新增之前推送的事件執行監聽器。範例資料層 example
ACDL不需要特定的資料結構。 設計解決方案設計檔案周圍的結構,並為寫入或讀取資料層的每個人製作檔案。 本指南中的範例使用下列結構。
頁面載入時,網站程式碼會推送頁面資料和頁面檢視事件:
window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push({
event: "page view",
page: {
name: "Home",
section: "Products",
url: "https://example.com/products",
referrer: "https://example.com/"
}
});
訪客完成購買時,網站程式碼會推送訂單詳細資料和購買事件:
window.adobeDataLayer.push({
event: "purchase",
transaction: { id: "ABC123" },
products: [
{ name: "Example product", category: "Example category", quantity: 1, price: 25 }
]
});
ACDL會將每次推播合併為稱為計算狀態的單一物件,您的實施會讀取該物件。 事件物件會告知您的實施何時讀取它。 檢視資料及計算狀態和事件。
工作流程 workflow
使用資料層實施 Adobe Analytics 時,通常會依照下列步驟操作:
- 與您的網站開發團隊合作實作資料層:您的網站開發團隊主要負責確保資料層包含正確的值。 請與您的網站開發團隊一起檢閱此頁面,確保團隊之間的期望相同。 請參閱安裝Adobe使用者端資料層。
- 使用瀏覽器主控台驗證您的資料層:開啟瀏覽器的開發人員主控台,大部分的瀏覽器都可以使用
F12鍵來執行此作業。 執行adobeDataLayer.getState()以檢視計算狀態,或執行adobeDataLayer.getState("page.name")以檢視單一值。 請參閱驗證安裝。 - 將資料層連線至Adobe Analytics:此步驟因您組織的實作方法而異。 請參閱將資料層連線至Adobe Analytics。
將資料層連結至Adobe Analytics connect
下表顯示每種實作方法從Adobe Client Data Layer讀取的方式:
data物件,然後透過 傳送事件 動作傳送。addEventListener()的資料層事件,並在您呼叫sendEvent時從資料層設定XDM或data欄位。使用AppMeasurement讀取資料層 appmeasurement
ACDL在程式庫載入時將其getState()方法新增至adobeDataLayer陣列。 若要確定程式庫已載入且計算狀態包含最新資料,請讀取事件接聽程式中的值:
window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push(function(dl) {
dl.addEventListener("page view", function(event) {
s.pageName = dl.getState("page.name");
s.channel = dl.getState("page.section");
s.t();
});
});
接聽程式針對每個page view事件執行一次,包括新增接聽程式之前推播的事件。 本指南中的變數頁面(例如pageName)會顯示如何使用getState()讀取個別值。 在監聽器(如本監聽器)中,或在 資料層推播 事件觸發的Analytics擴充功能規則的自訂程式碼編輯器中,使用這些範例。
如果您的實作每頁傳送多個點選,例如在單頁應用程式中,請使用clearVars(),這樣來自一個點選的值就不會持續到下一個點選。
後續步驟
- 將資料層物件對應至資料元素:在Adobe Experience Platform標籤中使用您網站的資料層。
- Adobe Client Data Layer檔案:瞭解每個ACDL方法、事件和最佳實務。