本檔案提供如何使用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
:只有將符合您條件的新推送事件傳送至Data Layer時,此選項才會觸發規則。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"}})