Adobe使用者端資料層擴充功能
本檔案提供如何使用Adobe Client Data Layer擴充功能的範例和最佳作法。
安裝
若要安裝擴充功能，請導覽至Experience PlatformUI或資料收集UI中的擴充功能目錄，然後選取「Adobe使用者端資料層」 。
目錄
擴充功能檢視
根據預設，ACDL指令碼會以變數名稱adobeDataLayer建立新的資料層。 擴充功能檢視可讓您視需要變更此名稱。 載入標籤時，您設定的名稱將會具現化。
adobeDataLayer物件仍在具現化，然後複製到您選取的新變數名稱。活動
擴充功能可讓您接聽Data Layer上的事件。 可使用下列事件：
接聽所有資料變更
如果選取此選項，事件接聽程式會接聽資料層所做的任何變更。
監聽器會追蹤下列範例推送事件：
adobeDataLayer.push({"data":"something"})adobeDataLayer.push({"event":"myevent","data":"something"})
監聽器不會追蹤下列範例推送事件：
adobeDataLayer.push({"event":"myevent"})
聆聽所有事件
如果您選取此選項，事件監聽器會監聽任何推送至資料層的事件。
監聽器會追蹤下列範例推送事件：
adobeDataLayer.push({"event":"myevent"})adobeDataLayer.push({"event":"myevent","data":"something"})
監聽器不會追蹤下列範例推送事件：
adobeDataLayer.push({"data":"something"})
接聽特定事件
如果您指定事件，事件接聽程式會追蹤符合特定字串的任何事件。
例如，使用此組態時設定myEvent會導致接聽程式只追蹤下列推播事件：
adobeDataLayer.push({"event":"myEvent"})
您也可以變更事件接聽程式的範圍。 不同選項概述如下：
all：這是預設選項，會在您過去符合或未來會推送上述所選條件時，觸發規則。 如果您使用非同步實施，這是最安全的選項。future：只有將符合您條件的新推播事件傳送至資料層時，此選項才會觸發規則。past：此選項只會針對符合您條件的舊推送事件觸發規則。 符合您條件的新推播會遭忽略，且不再觸發規則。
動作
以下各節概述擴充功能支援的動作。
重設資料層
此擴充功能提供您重設資料層長度的方法，可協助您將單頁應用程式(SPA)的大小維持在有限範圍內。
不過，目前不可能完全移除先前在推送方法期間設定的資訊。
重設和設定計算狀態 動作會複製最後一個計算狀態、清空資料層物件，並重新推送最後一個狀態。
推送至資料層
擴充功能提供將JSON內容推送至資料層本身的動作。此動作可讓您直接在JSON中使用資料元素。 在JSON編輯器中，應使用百分比標籤法參考資料元素（例如%dataElementName%）。
{
"page": {
"url": "%url%",
"previous_url": "%previous_url%",
"concatenated_values": "static string %dataElement%"
}
}
資料元素
以下各節說明擴充功能所提供的獨特資料元素型別。
計算狀態
根據您的設定方式，「資料層計算狀態」資料元素可能會傳回下列兩個專案之一：
- 完整的資料層狀態：依預設，會傳回完整的資料層計算狀態。
- 特定路徑：您可以指定要傳回資料層的路徑。 路徑是使用點標籤法指定（例如，
data.foo）。
資料層大小
此資料元素會傳回資料層的大小。 資料層的大小是以已推送至此物件的元素數量表示。
在下列推播事件清單中，此資料元素會傳回整數2：
adobeDataLayer.push({"event":"myEvent"})
adobeDataLayer.push({"data":{"foo":"bar"}})