Google資料層擴充功能

Google資料層擴充功能可讓您在標籤實作中使用Google資料層。 此擴充功能可獨立使用，或同時與Google解決方案和Google的開放原始碼資料層協助程式庫搭配使用。

Helper Library提供與Adobe Client Data Layer (ACDL)類似的事件導向功能。 Google Data Layer擴充功能的資料元素、規則和動作，提供與ACDL擴充功能類似的功能。

安裝

若要安裝擴充功能，請導覽至資料收集UI中的擴充功能目錄，並選取​ Google資料層。

安裝後，擴充功能就會在每次載入Adobe Experience Platform Tags程式庫時，建立或存取資料層。

擴充功能檢視

擴充功能組態可用來定義擴充功能使用的資料層名稱。 若載入Adobe Experience Platform Tags時不存在具有已設定名稱的資料層，擴充功能會建立一個資料層。

資料層名稱預設為Google預設名稱dataLayer。

活動

擴充功能可讓您接聽資料層上的變更。

Google事件型別

Google支援兩種推播事件的方式：使用push()方法的Google Tag Manager，以及使用gtag()方法的Google Analytics4。

1.2.1之前的Google Data Layer擴充功能版本僅支援push()建立的事件，如本頁面的程式碼範例所示。

使用gtag()建立的1.2.1版和更新版本支援事件。 這是選擇性的，並可在擴充功能設定對話方塊中啟用。

如需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'會以數字(\d)追蹤myEvent：

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。 在前一種情況下，資料元素會傳回資料層變更時從計算狀態中取得的值。 在後一種情況下，會使用規則執行時的計算狀態。

切換開關可讓您選取資料元素是否應從整個計算狀態傳回值，或僅從事件資訊傳回值（若用於資料層變更所觸發的規則中）。

因此，資料元素可以傳回：

其他資訊

擴充功能的資料元素和事件對話方塊包含詳細的使用資訊和範例。

其他一般資訊在專案README中