Google資料層擴充功能
Google資料層擴充功能可讓您在標籤實作中使用Google資料層。 此擴充功能可獨立使用,或同時與Google解決方案和Google的開放原始碼搭配使用 資料層協助程式庫.
Helper Library提供與Adobe Client Data Layer (ACDL)類似的事件導向功能。 Google資料層擴充功能的資料元素、規則和動作,可提供與 ACDL擴充功能.
安裝
若要安裝擴充功能,請導覽至資料收集UI中的擴充功能目錄,然後選取「 」 Google資料層.
安裝後,擴充功能就會在每次載入Adobe Experience Platform Tags程式庫時,建立或存取資料層。
擴充功能檢視
擴充功能組態可用來定義擴充功能使用的資料層名稱。 若載入Adobe Experience Platform Tags時不存在具有已設定名稱的資料層,擴充功能會建立一個資料層。
資料層名稱預設為Google預設名稱 dataLayer
.
活動
- Adobe Experience Platform Tags事件(程式庫已載入等)。
- JavaScript事件。
- 使用推送至資料層的資料 事件 關鍵字。
擴充功能可讓您接聽資料層上的變更。
請閱讀Google檔案,或如果對此點不確定,請進行研究。
Google事件型別
Google支援兩種推送事件的方法:Google Tag Manager,使用 push()
方法和Google Analytics4,使用 gtag()
方法。
Google Data Layer 1.2.1之前的擴充功能版本僅支援以下專案建立的事件: push()
,如本頁面的程式碼範例所示。
1.2.1版和更新版本支援使用建立的事件 gtag()
. 這是選擇性的,並可在擴充功能設定對話方塊中啟用。
有關詳細資訊 push()
和 gtag()
事件,請參閱 Google檔案. 擴充功能的設定和規則對話方塊中也提供資訊。
聆聽資料層的所有推送
如果選取此選項,事件接聽程式會接聽資料層所做的任何變更。
接聽排除事件的推送
如果您選取此選項,事件接聽程式會接聽任何資料推送到資料層的動作,但不包括事件。
監聽器會追蹤下列範例推送事件:
dataLayer.push({"data":"something"})
監聽器不會追蹤下列範例推送事件:
dataLayer.push({"event":"myevent"})
dataLayer.push({"event":"myevent","data":"something"})
接聽所有事件
如果您選取此選項,事件監聽器會監聽任何推送至資料層的事件。
監聽器會追蹤下列範例推送事件:
dataLayer.push({"event":"myevent"})
dataLayer.push({"event":"myevent","data":"something"})
監聽器不會追蹤下列範例推送事件:
dataLayer.push({"data":"something"})
接聽特定事件
如果您指定事件,事件接聽程式會追蹤符合特定字串的任何事件。
例如,設定 myEvent
使用此設定時,監聽器只會追蹤下列推播事件:
dataLayer.push({"event":"myEvent"})
可以使用(ECMAScript / JavaScript)規則運算式來比對事件名稱。
例如,設定'myEvent\d'將追蹤 myEvent
以數字(\d):
dataLayer.push({"event":"myEvent1"})
dataLayer.push({"event":"myEvent2"})
動作
推送至資料層 push-to-data-layer
擴充功能提供將JSON推送至資料層的兩項動作:自由文字欄位,可手動建立要推送的JSON;以及從1.2.0版啟動索引鍵值多欄位對話方塊。
自由文字JSON
自由文字動作可讓您直接在JSON中使用資料元素。 在JSON編輯器中,應使用百分比標籤法參考資料元素。 例如 %dataElementName%
。
{
"page": {
"url": "%url%",
"previous_url": "%previous_url%",
"concatenated_values": "static string %dataElement%"
}
}
索引鍵值多欄位
較新的索引鍵值多欄位對話方塊是更方便使用的介面,可讓您設定推送,而不需手動寫入JSON。
Google DL重設為計算狀態
擴充功能提供重設資料層的動作。 若用於處理Google資料層變更的規則中,資料層會重設為觸發規則時資料層的計算狀態。 如果動作用於不會處理Google資料層變更的規則中,動作會清空資料層。
資料元素
提供的資料元素可用於執行Google資料層變更(推送事件)所觸發的規則,或用於不相關的規則,例如Library Loaded。 在前一種情況下,資料元素會傳回資料層變更時從計算狀態中取得的值。 在後一種情況下,會使用規則執行時的計算狀態。
切換開關可讓您選取資料元素是否應從整個計算狀態傳回值,或僅從事件資訊傳回值(若用於資料層變更所觸發的規則中)。
因此,資料元素可以傳回:
- 空白欄位:資料層計算狀態。
- 具有索引鍵的欄位(例如以上範例中的page.previous_url):事件物件或計算狀態中的索引鍵值。
其他資訊
擴充功能的資料元素和事件對話方塊包含詳細的使用資訊和範例。
其他一般資訊請參閱 專案讀我檔案