Adobe使用者端資料層擴充功能

本檔案提供如何使用Adobe Client Data Layer擴充功能的範例和最佳作法。

安裝

若要安裝擴充功能，請導覽至Experience PlatformUI或資料收集UI中的擴充功能目錄，然後選取「Adobe使用者端資料層」。

目錄中的ACDL擴充功能檢視

擴充功能檢視

根據預設，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"}})

本頁內容