在 Google 代碼管理工具中重複使用事件設定

本頁適用對象：在 Google 代碼管理工具中維護 Google 代碼，且想定義事件層級設定的使用者。

什麼是事件設定變數？

您可以利用「Google 代碼：事件設定」變數，在多個 Google 代碼和 GA4 事件代碼中重複使用事件設定。

舉例來說，假設您有一家網路商店正在舉辦特賣會，並想追蹤有多少人使用您提供的折扣代碼，則可透過「Google 代碼：事件設定」變數重複使用參數，而不必將 discount 參數加進每個代碼。

如何使用事件設定變數

如何建立新的事件設定變數：

1. 開啟 Google 代碼管理工具
2. 在工作區中，開啟左側的「變數」選單。
3. 按一下「新增」，建立新的使用者定義變數。
4. 在「變數設定」中，選取「Google 代碼：事件設定」變數。
5. 新增要重複使用的參數。下方提供預先定義的參數表格。如果這些參數都不符合需求，您隨時可以建立自訂參數。只要在「名稱」欄位輸入您選擇的名稱即可。
6. 選用：在事件中加入 Google Analytics 使用者屬性：
   1. 在「Google Analytics 使用者屬性」下方，按一下「新增屬性」。
   2. 設定要隨著事件傳送的鍵/值組合：

      • 將「屬性名稱」設為您要傳送的類別，例如 favorite_food。

      • 將「值」設為使用者專屬資料，例如 apple。
7. 為變數命名並按一下「儲存」。

重複使用 Google 代碼中的設定

如要為每個事件傳送事件層級參數，請在 Google 代碼中使用事件設定變數。

1. 在工作區中，開啟左側的「代碼」選單。
2. 選取要套用設定變數的「Google 代碼」。
3. 重複使用設定：
   • 如要重複使用「配置設定」，請從下拉式清單中選取「Google 代碼：配置設定」變數。
   • 如要重複使用「共用事件設定」，請從下拉式清單中選取「Google 代碼：事件設定」變數。
   • 如要查看哪些參數沿用自設定變數，請按一下「顯示沿用的設定」。
   • 如果只要編輯 Google 代碼的沿用參數，請按一下「編輯」圖示 。
   • 如要還原經過編輯的沿用參數，請按一下「重設」圖示 。
4. 「儲存」代碼並「發布」容器。

 

重複使用 GA4 事件代碼中的設定

如要只為特定 GA4 事件傳送事件層級參數，請將事件設定變數新增至 GA4 事件代碼。

1. 在工作區中，開啟左側的「代碼」選單。
2. 選取要套用設定變數的 GA4 事件代碼。
3. 重複使用設定：
   • 如要重複使用「事件設定」，請從下拉式選單中選取「Google 代碼：事件設定」變數。
   • 如要查看哪些參數沿用自設定變數，請按一下「顯示沿用的設定」。
   • 如果只要編輯 Google 代碼的沿用參數，請按一下「編輯」圖示 。
   • 如要還原經過編輯的沿用參數，請按一下「重設」圖示 。
4. 「儲存」代碼並「發布」容器。

事件設定的有效參數

下表列出預先定義的參數，以及這些參數可與哪些產品搭配使用 (以 x 標示)，並依參數類型分組。這些不是事件名稱。如需預先定義事件的名稱清單，請參閱建議事件參考資料。

注意：除了 language 參數外，下列所有參數皆為 undefined。language 的預設值為 navigator.language。

字串

名稱	說明	廣告	GA4	Merchant Center
achievement_id	已解鎖的成就 ID。這是 unlock_achievement 事件的一部分，用於評估遊戲體驗。		x
aw_feed_country	此為與上傳商品所在動態饋給相關聯的國家/地區，請使用 CLDR 地域代碼，例如 'US'。 這是「透過購物車資料回報的轉換」的一部分。	x
aw_language	此為上傳商品所在動態饋給採用的語言，請使用 ISO 639-1 語言代碼。 這是「透過購物車資料回報的轉換」的一部分。	x
content_group	內容群組可用來將網頁和畫面分類到自訂值區。 瞭解詳情		x	x
content_id	所選內容的 ID，例如 C_12345。這是 select_content 事件的一部分。		x	x
content_type	內容類型，例如 'image'。這是 share 和 select_content 事件的一部分。		x
coupon	與事件相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。		x
國家/地區	用來擷取使用者所在國家/地區的參數。請使用 ISO 3166-1 alpha-2 格式 (例如 'US' 代表美國)。	x
貨幣	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 *如已設定 value，則還需要使用 currency 才能準確計算收益指標。	x	x	x
estimated_delivery_date	在顧客的購物車資料中，訂單承諾的最晚送達日期 (最長運送時間)。如果訂單含有「免運費」和「快速到貨」商品 (包含新狀態或維護狀態)，Google 會以該日期為運送速度的驗證依據。 注意：這個參數採用的是國際日期格式 (YYYY-MM-DD)。在這裡提交的日期應以 delivery_post_code 參數所設位置的日期和時區為準。 這是 Google Ads 轉換追蹤的一部分，用於驗證運送資料。	x
group_id	群組 ID，例如 G_12345。這是 join_group 事件的一部分，用來評估特定群組或社交功能的熱門程度。		x
語言	指定使用者的語言偏好設定。	x	x	x
method	使用者選擇的做法，例如 'email'。這是 login、share 和 sign_up 事件的一部分。		x
payment_type	顧客選擇的付款方式，例如 'credit card'。		x
search_term	搜尋的字詞。這是 search 事件的一部分。		x
send_to	指定 Google 代碼目的地 ID。可與 groups 設定參數搭配使用。	x	x	x
delivery_tier	為交付所購買商品選取的運送層級 (例如 'Ground'、'Air'、'Next-day')。	x	x	x
transaction_id	交易的專屬 ID，例如 T_12345。 transaction_id 參數可避免單筆購買產生重複事件。	x	x	x
virtual_currency_name	虛擬貨幣的名稱。這是 earn_virtual_currency 和 spend_virtual_currency 事件的一部分。		x

整數

名稱	說明	廣告	GA4	Merchant Center
aw_merchant_id	Merchant Center ID。如果您將一項商品保留在數個 Merchant Center 帳戶中，並想控管系統應從哪個 Merchant Center 帳戶讀取商品資料 (例如其銷貨成本)，請提供這項參數。這是「透過購物車資料回報的轉換」的一部分。	x

數字

名稱	說明	廣告	GA4	Merchant Center
delivery_post_code	訂單運送地址中郵遞區號的區域前置碼 (標示區域的部分)。區域前置碼用來判斷商家配送服務的準時送達情形。 提交這項資料時，建議只提供郵遞區號的前 3 碼。 這是 Google Ads 轉換追蹤的一部分，用於驗證運送資料。	x		x
discount	與項目相關聯的折扣金額。	x	x
score	使用者的分數。這是 post_score 事件的一部分，用於評估遊戲內分數。		x
廣告放送	與交易相關聯的運費，例如 4.99。	x	x	x
稅	與交易相關聯的稅金費用，例如 1.11。		x	x
值	事件的金額價值，例如 12.99。 必須設定 value 才能產生有意義的報表，以及填入「購買者」預測目標對象。 *如已設定 value，則需要一併設定 currency。	x	x	x

陣列<Item>

名稱	說明	廣告	GA4	Merchant Center
項目	列出事件的項目。這是包含子參數的電子商務參數。您可以找到以下項目的子參數： Google Ads：透過購物車資料回報的轉換 GA4：項目參數參考資料	x	x	x

物件

名稱	說明	廣告	GA4	Merchant Center
user_data	此參數用於停止自動收集使用者提供的資料。 如要停止收集特定網頁的資料，請設定 user_data to null。如要完全停用使用者定義的資料收集功能，請使用 Google 代碼設定。	x
user_properties	參數，可透過事件傳送其他 Google Analytics 使用者屬性。瞭解如何設定使用者屬性。		x

相關資源

• 重複使用配置設定
• 評估電子商務事件
• 設定 Google Ads 代碼
• Floodlight 參數和 Google 代碼
• Merchant Center：產品資料屬性