Google Tag Manager 變數(Variables)介紹

更新時間：2024年12月4號

這一篇介紹GTM裡的變數。

認識變數

GTM中的變數是具名的預留位置，程式碼在網站或行動應用程式上執行時，系統會在這類位置中填入對應的值。

在GTM裡點擊「變數」，就可以看到變數的管理介面：

變數的分類

從變數的管理介面可以做知道變數分為兩類：

• 內建變數：是一種預先建立且無法自訂的特殊類別變數，不同容易類型的內建變數會不同。
• 使用者定義的變數：自訂變數

內建變數

這裡介紹網頁容器的變數。

網頁

以https://www.haranhuang.com/google/google-tag-manager?cid=132為示例。

• Page Hostname (網頁主機名稱)：表示主機名稱，這裡就是www.haranhuang.com
• 網頁路徑：表示網址的路徑，這裡就是/google/google-tag-manager
• 網頁網址：表示完整網站，這裡就是/google/google-tag-manager?cid=132
• Referrer (參照網址)：表示上一個頁面來源，如從網頁A這個頁面，那這裡就是A

公用程式

• 容器編號：表示容器ID，如GTM-TCH6XWZ。
• 容器版本：表示當前容器的版本標號，GTM每做一次發佈，就會生成一個版本標號。
• 環境名稱：如果透過環境的 [共用預覽畫面] 連結或環境程式碼片段送出容器請求，系統會傳回使用者提供的目前環境名稱；若是內建環境，系統會傳回「Live」、「Latest」或「Now Editing」，其他情況則會傳回空白字串。
• Event (事件)：存取 dataLayer 中的 event 鍵。這個鍵是目前 dataLayer 事件的名稱 (例如 gtm.js、gtm.dom、gtm.load 或自訂事件名稱)。
• HTML ID：允許自訂 HTML 代碼標示成功或失敗；搭配代碼觸發順序使用。
• 隨機號碼：傳回隨機號碼值。

錯誤

• Error Message (錯誤訊息)：存取 dataLayer 中的 gtm.errorMessage 鍵 (由 JavaScript 錯誤觸發條件設定)，結果會是包含錯誤訊息的字串。
• Error URL (錯誤網址)：存取 dataLayer 中的 gtm.errorUrl 鍵 (由 JavaScript 錯誤觸發條件設定)，結果會是包含錯誤發生處網址的字串。
• Error Line (錯誤行)：存取 dataLayer 中的 gtm.errorLine 鍵 (由 JavaScript 錯誤觸發條件設定)，結果會是檔案中發生錯誤的行數。
• Debug Mode (偵錯模式)：如果容器目前在預覽模式中運作，則傳回 true。

點擊

• Click Element (點擊元素)：存取 dataLayer 中的 gtm.element 鍵 (由點擊觸發條件設定)，結果會是點擊發生處 DOM 元素的參考資料。
• Click Classes (點擊類別)：存取 dataLayer 中的 gtm.elementClasses 鍵 (由點擊觸發條件設定)，結果會是所點擊 DOM 元素上類別屬性的字串值。
• Click ID (點擊 ID)：存取 dataLayer 中的 gtm.elementId 鍵 (由點擊觸發條件設定)，結果會是所點擊 DOM 元素上 ID 屬性的字串值。
• Click Target (點擊目標)：存取 dataLayer 中的 gtm.elementTarget 鍵 (由點擊觸發條件設定)。
• Click URL (點擊網址)：存取 dataLayer 中的 gtm.elementUrl 鍵 (由點擊觸發條件設定)。
• Click Text (點擊文字)：存取 dataLayer 中的 gtm.elementText 鍵 (由點擊觸發條件設定)。

這幾個變數通常用於點擊事件追蹤，用的最多的是Click Classes和Click ID，延伸閱讀：詳解Google Analytics 4 事件追蹤——自訂事件（觸發條件法）

表單

• Form Classes (表單類別)：存取 dataLayer 中的 gtm.elementClasses 鍵 (由表單觸發條件設定)，結果會是表單上類別屬性的字串值。
• Form Element (表單元素)：存取 dataLayer 中的 gtm.element 鍵 (由表單觸發條件設定)，結果會是表單 DOM 元素的參考資料。
• Form ID (表單 ID)：存取 dataLayer 中的 gtm.elementId 鍵 (由表單觸發條件設定)，結果會是表單上 ID 屬性的字串值。
• Form Target (表單目標)：存取 dataLayer 中的 gtm.elementTarget 鍵 (由表單觸發條件設定)。
• Form Text (表單文字)：存取 dataLayer 中的 gtm.elementText 鍵 (由表單觸發條件設定)。
• Form URL (表單網址)：存取 dataLayer 中的 gtm.elementUrl 鍵 (由表單觸發條件設定)。

這幾個變數通常用於表單提交追蹤，用的最多的是Form Classes和Form ID，延伸閱讀：Google Analytics 4 中做表單互動追蹤

紀錄

• History Source (記錄來源)：存取 dataLayer 中的 gtm.historyChangeSource 鍵 (由記錄變更觸發條件設定)。
• New History Fragment (新記錄片段)：存取 dataLayer 中的 gtm.newUrlFragment 鍵 (由記錄變更觸發條件設定)，結果會是紀錄事件之後的網頁網址片段部分 (亦稱為雜湊) 字串值。
• New History State (新記錄狀態)：存取 dataLayer 中的 gtm.newHistoryState 鍵 (由記錄變更觸發條件設定)，結果會是將網頁推送到紀錄以引發紀錄事件的狀態物件。
• Old History Fragment (舊記錄片段)：存取 dataLayer 中的 gtm.oldUrlFragment 鍵 (由記錄變更觸發條件設定)，結果會是紀錄事件之前的網頁網址片段部分 (亦稱為雜湊) 字串值。
• Old History State (舊記錄狀態)：存取 dataLayer 中的 gtm.oldHistoryState 鍵 (由記錄變更觸發條件設定)，結果會是在紀錄事件發生之前就啟用的狀態物件。

這幾個變數通常用於單頁應用追蹤（SPA/PWA）追蹤，延伸閱讀：Google Analytics 4 中做單頁應用追蹤（SPA/PWA）

捲動

• Scroll Depth Threshold (捲動深度門檻)：存取 dataLayer 中的 gtm.scrollThreshold 鍵 (由捲動深度觸發條件設定)。門檻是一個數值，用來指定導致觸發條件啟動的捲動深度。以百分比做為門檻時，該數值在 0 到 100 之間；以像素做為門檻時，該數值則代表指定的像素數量。
• Scroll Depth Units (捲動深度單位)：存取 dataLayer 中的 gtm.scrollUnits 鍵 (由捲動深度觸發條件設定)；單位可以是「像素」或「百分比」，您可以指定一種當做觸發條件啟動門檻的單位。
• Scroll Direction (捲動方向)：存取 dataLayer 中的 gtm.scrollDirection 鍵 (由捲動深度觸發條件設定)；方向可以是「垂直」或「水平」，表示觸發條件啟動門檻的方向。

影片

• Video Current Time (影片目前時間)：存取 dataLayer 中的 gtm.videoCurrentTime 鍵。這個鍵會是一個整數，用來代表影片中發生事件的時間 (以秒為單位)。
• Video Duration (影片播放時間)：存取 dataLayer 中的 gtm.videoDuration 鍵。這個鍵會是一個整數，用來代表影片總長度 (以秒為單位)。
• Video Percent (影片百分比)：存取 dataLayer 中的 gtm.VideoPercent 鍵。這個鍵會是一個整數 (0-100)，用來代表事件發生時影片的播放長度所佔百分比。
• Video Provider (影片提供者)：存取 dataLayer 中的 gtm.videoProvider 鍵 (由 YouTube 影片觸發條件設定)，結果會是影片提供者的名稱，亦即「YouTube」。
• Video Status (影片狀態)：存取 dataLayer 中的 gtm.videoStatus 鍵。這個鍵會是偵測到事件時的影片狀態 (例如「play」或「pause」)。
• Video Title (影片標題)：存取 dataLayer 中的 gtm.videoTitle 鍵 (由 YouTube 影片觸發條件設定)，結果會是影片標題。
• Video URL (影片網址)：存取 dataLayer 中的 gtm.videoUrl 鍵 (由 YouTube 影片觸發條件設定)，結果會是影片的網址，例如「https://www.youtube.com/watch?v=gvHcXIF0rTU」。
• Video Visible (影片可見)：存取 dataLayer 中的 gtm.videoVisible 鍵 (由 YouTube 影片觸發條件設定)。如果能在可視區域中看到影片，結果就會設為 True，如果看不到 (例如需捲動位置，或為「在背景播放」標籤)，則設為 False。

這幾個變數通常用於Youtube影片追蹤，延伸閱讀：Google Analytics 4 中對Youtube影片做追蹤

可見度

• Percent Visible (可見百分比)：存取 dataLayer 中的 gtm.visibleRatio 鍵 (由元素可見度觸發條件設定)。可見百分比是一個從 0 到 100 的數值，用來表示觸發條件啟動時，選取的元素有多大的比例處於可見狀態。
• On-Screen Duration (畫面持續時間)：存取 dataLayer 中的 gtm.visibleTime 鍵 (由元素可見度觸發條件設定)。畫面持續時間是一個數值，用來表示觸發條件啟動時，選取的元素處於可見狀態有多久 (以毫秒計)。

這幾個變數通常用於展示追蹤，延伸閱讀：「GTM」用元素可見度做表單提交跟蹤

使用者定義的變數

如果要創建使用者定義的變數，在GA4裡點擊「變數」——「新增」——「請選擇變數類型以開始設定…」，選擇變數類型：

在對其做設定即可。