代碼的用途是檢測網頁和行動應用程式，在發生特定類型的事件時傳送資料。這類資料包括事件類型和參數，說明事件相關資訊。
什麼是事件？
「事件」是指使用者與網站的某個元件互動。這些事件包括但不限於：
- 載入網頁
- 連結點擊
- 表單提交
- 影片播放
- 購買
- 訂閱
- 應用程式安裝次數
什麼是參數？
參數是與事件相關聯的資料，參數範例包括：
- 項目值
- 優待券代碼
- 登入方式
- 交易 ID
- 幣別
透過事件和參數，您可以深入瞭解自己的客戶偏好，並且協助您解答一些問題，例如：哪些產品網頁獲得最多瀏覽次數？哪些按鈕獲得點擊的頻率較高？哪些廣告活動會促成購買或訂閱？
event 指令
event 指令 (與 Google 代碼搭配使用) 會將事件資料傳送至 Google 廣告和評估產品。event 指令的原型如下：
gtag('event', '<type>', {<parameters>});
<type> 是事件類型，例如 Google Ads 轉換事件或 Google Analytics (分析) 4 事件名稱。<parameters> 是名稱/值組合的物件，包含描述事件的資料。
代碼管理工具中的事件
系統會根據使用的代碼類型，設定代碼管理工具中的事件。例如：
- Google Ads 的轉換事件會與 Google Ads 轉換追蹤代碼一併傳送。
- Google Analytics (分析) 4 中的事件是透過「Google Analytics (分析)：GA4 事件」代碼設定。
- 您可以在「Google Analytics (分析)：通用 Analytics (分析) 代碼」中，透過「追蹤類型」設定設定通用 Analytics (分析) 代碼的事件。
- Floodlight 事件是設定 Floodlight 計數器或 Floodlight 銷售代碼。
代碼管理工具會使用觸發條件，指定要追蹤及監聽哪些事件，讓網頁或行動應用程式中發生該事件。事件發生時，代碼就會觸發，並將資料傳送至指定產品。
Google Ads 轉換
Google Ads 轉換事件會評估使用者與廣告互動後的活動。這些轉換可以代表造成新訂閱項目、購買或應用程式下載等事件。開始使用代碼之前，建議您先前往 Google Ads 說明中心進一步瞭解這個功能的運作方式。
如要設定 Google Ads 轉換標記，您必須輸入必要的 Google Ads 轉換 ID 和轉換標籤，並視需要輸入轉換價值、貨幣代碼和/或交易 ID。
gtag.js
如果是 Google 代碼的導入作業，事件會與 gtag('event',
'conversion'...) 一併傳送。例如：
gtag('event', 'conversion', {
'send_to': 'AW-CONVERSION_ID/CONVERSION_LABEL',
'value': 1.0,
'currency': 'USD',
'transaction_id': '12345',
});
代碼管理工具
- 在「代碼管理工具」中建立新的 Google Ads 代碼，在主畫面上依序選取「新增代碼」>「代碼設定」>「Google Ads 轉換追蹤」。
- 登入 Google Ads 帳戶，收集您要用來完成代碼設定的值：
- 在 Google Ads 帳戶中，按一下「工具與設定」(
) 選單。 - 選取「評估」下方的「轉換」，開啟「轉換動作」表格。
- 在「轉換動作」欄中，選取要使用的轉換名稱。
- 展開「代碼」設定分頁，查看代碼詳情。
- 選取「使用 Google 代碼管理工具」。
- 複製「轉換 ID」和「轉換標籤」的值。
- 在 Google Ads 帳戶中，按一下「工具與設定」(
在代碼管理工具中，將步驟 2 取得的「轉換 ID」和「轉換標籤」值加進個別欄位。您可以視需要新增「轉換價值」、「交易 ID」和「貨幣代碼」。如果可以，請務必為這些欄位值使用代碼管理工具變數。(例如大部分情況下，交易 ID 都會使用變數。)
在「觸發條件」部分中選擇一或多項觸發條件，指定啟動代碼的時機。
按一下「儲存」完成代碼設定。
進一步瞭解如何設定 Google Ads 轉換。
Google Analytics (分析) 4 事件
在 Google Analytics (分析) 4 資源中，每個可評估的使用者動作都視為一個事件。事件可以是載入網頁、連結點擊、表單完成、在購物車中加入商品、結帳、捲動頁面、影片觀看、應用程式安裝等。Google Analytics (分析) 4 事件支援自訂參數和使用者屬性，因此 Google Analytics (分析) 4 非常適合靈活運用這些事件評估活動。
Google 的代碼平台代表的是四種主要的事件類型。這些參考資料可能因產品而異，但一般可分為以下類別：
自動收集的事件是指從 gtag.js 或代碼管理工具代碼傳送的事件，您不必進行額外檢測。自動收集事件的常見範例包括
ad_click、page_view和video_progress。瞭解詳情。加強型評估事件是指您在 Google Analytics (分析) 中啟用事件時，從 gtag.js 或代碼管理工具代碼傳送的事件。加強型評估事件的常見範例包括
scroll、click和file_download。瞭解詳情。建議事件適用於常見的成效評估事件，需要額外的背景資訊才能產生有意義的結果。常見的建議事件範例包括
login、purchase和search。這類項目需要其他背景資訊，因此不會自動傳送。瞭解詳情。自訂事件：這是指您自行定義的事件。系統尚未自動收集這些事件或建議事件。實際上，您應嘗試盡可能使用自動收集的事件或建議事件，並只在先前的類型不符合需求時，才使用自訂事件類型。瞭解詳情。
如要瞭解如何為 gtag.js 或 Google 代碼管理工具設定事件，請參閱「設定事件」一文。
通用 Analytics (分析) 事件
通用 Analytics (分析) 事件是以舊版事件/類別/標籤/值模型為基礎。
gtag.js
請使用以下語法使用 gtag('event') 指令：
gtag('event', <action>, {
'event_category': <category>,
'event_label': <label>,
'value': <value>
});
以下程式碼會傳送動作為 'Downloads'、'MP3' 類別以及「Debussy - Clair de lune」標籤的事件：
gtag('event', 'Downloads', {
'event_category' : 'MP3',
'event_label' : 'Debussy - Clair de lune'
});
如果省略 <category> 或 <label>，系統會將其設為預設值 (not set)。
代碼管理工具
如要在 Google 代碼管理工具中傳送通用 Analytics (分析) 事件，需要兩個元件：
- Google Analytics (分析)：通用 Analytics (分析) 代碼
- 讓代碼啟動的觸發條件。
通用 Analytics (分析) 事件的結構如下：
| 名稱 | 類型 | 預設值 | 說明 |
|---|---|---|---|
| <action> | 字串 | 在 Google Analytics (分析) 事件報表中顯示為事件動作的值。 | |
| <category> | 字串 | "(未設定)" | 事件的類別。 |
| <label> | 字串 | "(未設定)" | 事件的標籤。 |
| <value> | 數字 | 非負整數，會顯示為 vent 值。 |
如要進一步瞭解 Google Analytics (分析) 如何解讀事件結構，請參閱 Google Analytics (分析) 事件參數的分析。
Floodlight 活動
「Floodlight 活動」是對應您要評估的特定事件的轉換，例如完成購物或造訪網頁。 當使用者看到您其中一則廣告後採取指定動作，即稱為「轉換」。瞭解詳情。
gtag.js
Floodlight 活動會透過 gtag('event','conversion') 從 Google 代碼傳送。此程式碼應放在定義 gtag() 函式之後，最好放在 <head> 區段內，以獲得最佳效能。
資料欄位會以參數字串的形式在 send_to 屬性中傳送。欄位會因代碼類型、計算方法，以及您傳入代碼的其他資料而有所不同。
以下是 Floodlight 轉換活動的範例：
gtag('event', 'conversion', {
'allow_custom_scripts': true,
'u1': '[variable]', // custom Floodlight variable
'send_to': 'DC-[floodlightConfigID]/[activityGroupTagString]/[activityTagString]+[countingMethod]'
});
代碼管理工具
Google 代碼管理工具可用來設定 Floodlight 活動。詳情請參閱說明中心說明文件。