在 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 标记）。这些不是事件名称。如需查看预定义的事件名称的列表，请参阅推荐事件参考文档。

名称	类型	默认值	说明	Ads	GA4	Merchant Center
achievement_id	string	未指定	已解锁的成就的 ID。是 unlock_achievement 事件的一部分，用于衡量游戏体验。		x
aw_feed_country	string	未指定	您用来上传商品数据的 Feed 所关联的国家/地区。请使用 CLDR 地区代码，例如 'US'。 是含购物车数据的转化报告的一部分。	x
aw_language	string	未指定	您用来上传商品数据的 Feed 所关联的语言。请使用 ISO 639-1 语言代码。是含购物车数据的转化报告的一部分。	x
aw_merchant_id	integer	未指定	Merchant Center ID。如果您将某件商品保存在多个 Merchant Center 账号中，并想控制系统应从哪个 Merchant Center 账号中读取该商品的数据（例如其销货成本），请提供此参数。是含购物车数据的转化报告的一部分。	x
content_group	string	未指定	借助内容组，您可以将网页和屏幕归类到自定义组中。了解详情		x	x
content_id	string	未指定	所选内容的标识符，例如 C_12345。这是 select_content 事件的一部分。		x	x
content_type	string	未指定	内容的类型，例如 'image'。是 share 和 select_content 事件的一部分。		x
coupon	string	未指定	与事件相关的优惠券名称/代码。 事件级和商品级 coupon 参数彼此独立。		x
country	string	未指定	用于捕获用户所在国家/地区的参数。请使用 ISO 3166-1 alpha-2 格式。（例如，'US' 表示美国）	x
currency	string	未指定	与该事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 * 如果设置 value，则必须提供 currency，这样才能准确计算收入指标。	x	x	x
delivery_postal_code	number	未指定	订单送货地址所对应的邮政编码的区域前缀（即用来指定区域的部分）。区域前缀用于确定商家在准时送达方面的表现。 提交此数据时，建议您仅添加邮政编码的前 3 位。 是 Google Ads 转化跟踪功能的一部分，用于验证运费数据。	x		x
discount	number	未指定	与相应商品相关的折扣值（金额形式）。	x	x
estimated_delivery_date	string	未指定	客户的购物车数据中，承诺的订单最晚送达日期（或“期限”）。如果订单包含正考虑免费快速配送的产品（新状态或原本就是这种状态），Google 使用会此日期来验证配送速度。 注意：此参数使用国际日期格式 (YYYY-MM-DD)。您在此处提交的日期应基于您为 delivery_postal_code 提交的地点的日期和时区。 是 Google Ads 转化跟踪功能的一部分，用于验证运费数据。	x
group_id	string	未指定	群组的 ID，例如 G_12345。是 join_group 事件的一部分，用于衡量特定群组或社交功能的受欢迎程度。		x
items	array<Item>	未指定	列出与该事件相关的商品。这是包含子参数的电子商务参数。您可以点击以下链接找到分别适用于对应产品的子参数： Google Ads：含购物车数据的转化报告 GA4：Item 参数参考	x	x	x
language	string	navigator.language	指定用户的语言偏好设置。	x	x	x
method	string	未指定	用户执行操作时选择采用的方法，例如 'email'。是 login、share 和 sign_up 事件的一部分。		x
payment_type	string	未指定	客户选择的付款方式，例如 'credit card'。		x
score	number	未指定	用户的得分。是 post_score 事件的一部分，用于衡量在游戏中的得分。		x
search_term	string	未指定	所搜索的具体字词。是 search 事件的一部分。		x
send_to	string	未指定	用于指定 Google 代码的目标账号 ID。需要与 groups 配置参数搭配使用。	x	x	x
shipping	number	未指定	与交易相关的运费，例如 4.99。	x	x	x
shipping_tier	string	未指定	用户为所购商品选择的配送级别（例如 'Ground'、'Air'、'Next-day'）。	x	x	x
tax	number	未指定	与交易相关的税费，例如 1.11。		x	x
transaction_id	string	未指定	交易的唯一标识符，例如 T_12345。 transaction_id 参数有助于避免出现重复的购买事件。	x	x	x
user_data	object	未指定	用于选择停止自动收集用户提供的数据的参数。 若要针对部分网页选择停止，请将 user_data 设置为 null。若要选择完全停止收集用户指定的数据，请使用 Google 代码设置。	x
user_properties	object	未指定	用于随事件发送其他 Google Analytics（分析）用户属性的参数。了解如何设置用户属性。		x
value	number	未指定	与该事件相关的货币价值，例如 12.99。 如需生成有意义的报告和填充“购买者”预测性受众群体，则必须提供 value。 * 如果设置 value，则还需要设置 currency。	x	x	x
virtual_currency_name	string	未指定	虚拟货币的名称。是 earn_virtual_currency 和 spend_virtual_currency 事件的一部分。		x

相关资源

• 重复使用配置设置
• 衡量电子商务事件
• 设置 Google Ads 代码
• Floodlight 参数和 Google 代码
• Merchant Center：商品数据属性