本頁面由 Cloud Translation API 翻譯而成。

Switch to English

設定 Google 產品及傳送事件資料

安裝 Google 代碼之後，您可以在程式碼的任一處呼叫 gtag() 指令，

本頁將說明如何：

使用 config 指令在你的網站和 Google 產品之間建立資料流
使用 event 指令將活動傳送到你的 Google 產品
使用 set 指令設定隨每個事件傳送的值

事前準備

本指南假設您已完成下列事項：

熟悉 Google 代碼的運作方式
安裝 Google 代碼

如要設定資料流程，您必須符合以下條件：

存取已安裝 Google 代碼的網站程式碼
您要連結到 Google 代碼的 Google 產品的代碼 ID

什麼是代碼編號？如何查看廣告代碼編號？

標記 ID 可用來識別 Google 代碼。單一 Google 代碼可包含多個代碼 ID。假設您使用 Google Ads，您的代碼現在有兩個 ID：一個舊版 ID (AW) 和一個 Google 代碼 ID (GT)。

螢幕上顯示 Google Ads 中含兩個代碼 ID 的 Google 代碼的畫面。

代碼 ID 可互換。下表概略說明哪些代碼與 Google 代碼相容。

前置字串	ID 類型	說明
GT-XXXXXX	Google 代碼	每個新建立的 Google 代碼都會獲得一個 GT 前置字元和專屬 ID。
G-XXXXXX	Google 代碼 (舊版前置字元)	Google Analytics (分析) 4 代碼是帶有 G 前置字元和專屬 ID 的 Google 代碼。
AW-XXXXXX	Google 代碼 (舊版前置字元)	Google Ads 代碼是附有 AW 前置字元和專屬 ID 的 Google 代碼。
DC：XXXXXX	Google 代碼 (舊版前置字元)	Google Floodlight 代碼是包含 DC 前置字元和專屬 ID 的 Google 代碼。

通用 Analytics (分析) (UA) 代碼與 Google 代碼 (GT) 不相容。

找出您的代碼 ID：

步驟 1：將 Google 產品連結到您的代碼

關於 `config` 指令

config 指令會指明您要傳送事件資料的 Google 產品，指令採用以下格式：

gtag('config', 'TAG_ID', {<additional_config_params>});

其他設定參數

您可以在選用 {<additional_config_params>} 物件中指定參數，藉此調整及擴充 config 指令。舉例來說，加入下列參數後，Google Analytics (分析) 網頁瀏覽就不會自動傳送：

gtag('config', 'TAG_ID', {'send_page_view': false});

設定資料收集

如要為 Google 產品設定資料收集功能，請新增含有標記 ID 的 config 指令。

範例

Google 代碼 (GT-XXXXXX) 會將資料傳送到您為其定義的目的地，例如 Google Ads 和 GA4。

以下範例說明您設定 Google 代碼，並將 Floodlight 新增為目的地時的程式碼外觀。

如要將資料傳送至 Floodlight (代碼 ID DC-ZZZZZZ)，請在初始化 Google 代碼後再加入另一個 config 指令：

<head>
 ...
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXX"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments)};
  gtag('js', new Date());
  gtag('config', 'GT-XXXXXX');
  gtag('config', 'DC-ZZZZZZ');
</script>
</head>

特定產品的`config`行為

根據 TAG_ID 中指定的產品，config 指令也可能啟動該產品的特定行為。例如，在某些情況下，config 指令會指示 gtag.js 啟動網頁瀏覽事件。

如要進一步瞭解 config 指令相對於個別產品的行為，請參閱產品專屬的說明文件：

步驟 2：使用 `event` 傳送資料

關於 `event` 指令

event 指令可讓您將事件資料傳送到您透過 config 指定的產品。指令採用以下格式：

gtag('event', 'event_name', {
  'key': 'value',
});

關於事件名稱和鍵/值組合

建議事件：建議事件是由您自行導入，當中包含預先定義的鍵/值組合的事件。這些事件可解鎖現有和未來的報表功能。

自訂事件：如要定義自己的事件和資料結構，您可以輸入自訂值來傳送自訂事件。

設定事件

初始化 Google 代碼後，您可以在程式碼中任何位置呼叫 event 方法。

定義事件。如果您使用建議事件，請務必使用標準化事件名稱和預先定義的鍵/值組合。
定義觸發事件的時機，例如當網頁載入或透過使用者點擊按鈕時傳送事件。

範例

以下範例說明使用者按一下按鈕後，一種一種方式可評估電子報訂閱量。這個範例使用自訂事件並將其傳送至 Google Analytics (分析) 4 資源。

<head>
   ...
   /* 1. Initialize the Google tag and gtag.js library */
   <!-- Google tag (gtag.js) -->
   <script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
   <script>
     window.dataLayer = window.dataLayer || [];
     function gtag(){dataLayer.push(arguments)};
     gtag('js', new Date());
     gtag('config', 'TAG_ID');
   </script>
</head>

<body>
   <script>
     let date = Date.now();
     /* 2. Define your event. */
     function newsletterSignup() {
       gtag('event', 'newsletter_signup', {
       'time': date,
       });
   }
   </script>
   ...
   /* 3. Trigger your event */
   <button type="submit" onlick="newsletterSignup()">Sign me up!</button>
   ...
</body>

選用：透過 `set` 傳送每個事件的資料

set 指令可讓您設定參數，以便與網頁上每個後續事件建立關聯。

指令採用以下格式：

gtag('set', {'key': 'value'});

範例

如果網站上的所有交易都使用相同的貨幣，您可以使用 set 指令指定 currency 欄位：

gtag('set', {'currency': 'USD'});

您可以使用單一 set 指令設定多個屬性：

gtag('set', {
  'country': 'US',
  'currency': 'USD'
});

後續步驟

完成 Google 產品和事件的設定程序後，您就能完成基本 Google 代碼設定。

如果您正在管理多項產品，並想進一步管理這些產品的資料流，請參閱分組和轉送資料一文。