在 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 標示)。這些不是事件名稱。如需預先定義事件的名稱清單，請參閱建議事件參考資料。

名稱	類型	預設值	說明	Google Ads	GA4	Merchant Center
achievement_id	字串	未定義	已解鎖的成就 ID。這是 unlock_achievement 事件的一部分，用於評估遊戲體驗。		x
aw_feed_country	字串	未定義	與上傳項目所屬動態饋給相關的國家/地區。請使用 CLDR 地域代碼，例如 'US'。 這是「透過購物車資料回報的轉換」報表的一部分。	x
aw_language	字串	未定義	上傳項目所屬動態饋給採用的語言。請使用 ISO 639-1 語言代碼。這是「透過購物車資料回報的轉換」報表的一部分。	x
aw_merchant_id	整數	未定義	Merchant Center ID。如果您在多個 Merchant Center 帳戶有同個項目，且想指定要從哪個帳戶擷取項目資料 (例如銷貨成本)，請提供這項參數。這是「透過購物車資料回報的轉換」報表的一部分。	x
content_group	字串	未定義	內容群組可用來將網頁和畫面分類到自訂值區。瞭解詳情		x	x
content_id	字串	未定義	所選內容的 ID，例如 C_12345。這是 select_content 事件的一部分。		x	x
content_type	字串	未定義	內容類型，例如 'image'。屬於 share 和 select_content 事件。		x
coupon	字串	未定義	與事件相關聯的優待券名稱/代碼。 事件層級與項目層級的 coupon 參數各自獨立。		x
country	字串	未定義	用來擷取使用者所在國家/地區的參數。請使用 ISO 3166-1 alpha-2 格式 (例如 'US' 代表美國)。	x
currency	字串	未定義	與事件相關聯的項目幣別，採用 3 個字母的 ISO 4217 格式。 * 如已設定 value，則還需要使用 currency 才能準確計算收益指標。	x	x	x
delivery_postal_code	數字	未定義	訂單運送地址中郵遞區號的區域前置碼 (標示區域的部分)。區域前置碼用來判斷商家配送服務的準時送達情形。 提交這項資料時，建議只提供郵遞區號的前 3 碼。 這是 Google Ads 轉換追蹤的一部分，用於驗證運送資料。	x		x
discount	數字	未定義	與項目相關聯的折扣金額。	x	x
estimated_delivery_date	字串	未定義	在客戶的購物車資料中，訂單承諾的最晚送達日期 (最長運送時間)。如果訂單含有「免運費」和「快速到貨」商品 (包含新狀態或維護狀態)，Google 會以該日期為運送速度的驗證依據。 注意：這個參數採用的是國際日期格式 (YYYY-MM-DD)。在這裡提交的日期應以 delivery_postal_code 參數所設位置的日期和時區為準。 這是 Google Ads 轉換追蹤的一部分，用於驗證運送資料。	x
group_id	字串	未定義	群組 ID，例如 G_12345。這是 join_group 事件的一部分，用來評估特定群組或社交功能的熱門程度。		x
items	陣列<Item>	未定義	列出事件的項目。這是包含子參數的電子商務參數。您可以找到以下項目的子參數： Google Ads：透過購物車資料回報的轉換 GA4：項目參數參考資料	x	x	x
language	字串	navigator.language	指定使用者的語言偏好設定。	x	x	x
method	字串	未定義	使用者選擇的做法，例如 'email'。這是 login、share 和 sign_up 事件的一部分。		x
payment_type	字串	未定義	客戶選擇的付款方式，例如 'credit card'。		x
score	數字	未定義	使用者的分數。這是 post_score 事件的一部分，用於評估遊戲內分數。		x
search_term	字串	未定義	搜尋的字詞。這是 search 事件的一部分。		x
send_to	字串	未定義	指定 Google 代碼目的地 ID。可與 groups 設定參數搭配使用。	x	x	x
shipping	數字	未定義	與交易相關聯的運費，例如 60。	x	x	x
shipping_tier	字串	未定義	選取配送已購商品的運送層級，例如 'Ground' (陸運)、'Air' (空運)、'Next-day' (隔日)。	x	x	x
tax	數字	未定義	與交易相關聯的稅金費用，例如 30。		x	x
transaction_id	字串	未定義	交易的專屬 ID，例如 T_12345。 transaction_id 參數可避免單筆購買產生重複事件。	x	x	x
user_data	物件	未定義	此參數用於停止自動收集使用者提供的資料。 如要停止收集特定網頁的資料，請將 user_data 設為 null。如要完全停用使用者定義的資料收集功能，請使用 Google 代碼設定。	x
user_properties	物件	未定義	此參數可隨事件傳送更多 Google Analytics (分析) 使用者屬性。瞭解如何設定使用者屬性。		x
value	數字	未定義	事件金額，例如 390。 必須設定 value 才能產生有意義的報表，以及填入「購買者」預測目標對象。 * 如已設定 value，則要一併設定 currency。	x	x	x
virtual_currency_name	字串	未定義	虛擬貨幣的名稱。這是 earn_virtual_currency 和 spend_virtual_currency 事件的一部分。		x

相關資源

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