什么是事件设置变量？
您可以利用 Google 代码：事件设置变量，在多个 Google 代码和 GA4 事件代码中重复使用事件设置。
例如，假设您拥有一家网店，正在开展促销活动。现在，您想要跟踪有多少用户使用您提供的折扣代码。这种情况下，您就可以利用 Google 代码：事件设置变量来重复使用 discount 参数，而无需手动为每个代码添加该参数。
如何使用事件设置变量
若要创建新的事件设置变量，请按以下步骤操作：
- 打开 Google 跟踪代码管理器
- 在您的工作区中，打开左侧的变量菜单。
- 新建一个由用户定义的变量。
- 在变量配置中，选择 Google 代码：事件设置变量。
- 添加要重复使用的参数。您可以在下方找到预定义参数表格。如果所有这些参数都不满足您的需求，您可以随时创建自定义参数，只需在名称字段中输入您选择的名称即可。
- 可选：将 Google Analytics 用户属性添加到事件中。
- 在 Google Analytics 用户属性下，点击添加属性。
- 设置要随此事件一起发送的键值对：
-
将属性名称设置为您希望发送的类别，例如
favorite_food。 - 将值设置为特定用户数据，例如
apple。
-
- 为变量命名并保存。
在 Google 代码中重复使用设置
要随每个事件发送事件级参数，请在 Google 代码中使用事件设置变量。
- 在您的工作区中，打开左侧的代码菜单。
- 选择您要应用设置变量的 Google 代码。
- 重复使用设置：
- 要重复使用配置设置，请从下拉列表中选择 Google 代码：配置设置变量。
- 要重复使用共享事件设置，请从下拉列表中选择 Google 代码：事件设置变量。
- 要查看从设置变量沿用的具体参数，请点击显示沿用的设置。
- 要只修改沿用的 Google 代码的参数，请点击修改图标
。 - 要还原修改后的沿用参数，请点击重置图标
。
- 保存代码并发布容器。
。
。
在 GA4 事件代码中重复使用设置
如需仅针对选定的 GA4 事件发送事件级参数，请将事件设置变量添加到 GA4 事件代码中。
- 在您的工作区中，打开左侧的代码菜单。
- 选择要应用设置变量的 GA4 事件代码。
- 重用设置：
- 要重复使用事件设置，请从下拉列表中选择 Google 代码：事件设置变量。
- 要查看从设置变量沿用的具体参数，请点击显示沿用的设置。
- 要只修改沿用的 Google 代码的参数，请点击修改图标 。
- 要还原修改后的沿用参数，请点击重置图标 。
- 保存代码并发布容器。
对事件设置有效的参数
下表按参数类型列出了预定义参数以及您可以在哪些产品中使用这些参数（用 x 标记）。这些不是事件名称。如需查看预定义的事件名称的列表，请参阅推荐事件参考文档。
注意：下列所有参数均为未定义，language 参数除外。language 的默认值为 navigator.language。
字符串
|
名称 |
说明 |
广告 |
GA4 |
Merchant Center |
|
achievement_id |
已解锁的成就的 ID。是 unlock_achievement 事件的一部分，用于衡量游戏体验。 |
|
x |
|
|
aw_feed_country |
您用来上传商品数据的 Feed 所关联的国家/地区。请使用 CLDR 地区代码，例如“ 这是包含购物车数据的转化报告的一部分。 |
x |
|
|
|
aw_language |
您用来上传商品数据的 Feed 所关联的语言。请使用 ISO 639-1 语言代码。 这是包含购物车数据的转化报告的一部分。 |
x |
|
|
|
content_group |
借助内容组，您可以将网页和屏幕归类到自定义组中。 了解详情 |
|
x |
x |
|
content_id |
所选内容的标识符，例如 |
|
x |
x |
|
content_type |
内容的类型，例如“ |
|
x |
|
|
coupon |
与事件相关的优惠券名称/代码。 事件级和商品级 coupon 参数彼此独立。 |
|
x |
|
|
国家/地区 |
用于捕获用户所在国家/地区的参数。请使用 ISO 3166-1 alpha-2 格式。（例如，“ |
x |
|
|
|
currency |
与该事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 *如果设置 |
x |
x |
x |
|
estimated_delivery_date |
客户的购物车数据中，订单承诺的最晚送达日期（或“期限”）。如果订单包含正考虑免费快速配送的产品（新状态或原本就是这种状态），Google 使用此日期来验证配送速度。 注意：此参数使用国际日期格式 (YYYY-MM-DD)。您在此处提交的日期应基于您为 这是 Google Ads 转化跟踪功能的一部分，用于验证送货数据。 |
x |
|
|
|
group_id |
群组的 ID，例如 |
|
x |
|
|
language |
指定用户的语言偏好设置。 |
x |
x |
x |
|
method |
|
x |
|
|
|
payment_type |
客户选择的支付方式，例如“ |
|
x |
|
|
search_term |
所搜索的具体字词。这是 search 事件的一部分。 |
|
x |
|
|
send_to |
用于指定 Google 代码的目标账号 ID。需要与 groups 配置参数搭配使用。 |
x |
x |
x |
|
delivery_tier |
用户为所购商品选择的配送级别（例如 |
x |
x |
x |
|
transaction_id |
交易的唯一标识符，例如
|
x |
x |
x |
|
virtual_currency_name |
虚拟货币的名称。 这是 |
|
x |
|
integer
|
名称 |
说明 |
广告 |
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 |
|
|
delivery |
与交易相关的配送费，例如 |
x |
x |
x |
|
tax |
与交易相关的税费，例如 |
|
x |
x |
|
value |
与该事件相关的货币价值，例如 如需生成有意义的报告和填充“购买用户”预测性受众群体，则必须提供 value。 * 如果设置 |
x |
x |
x |
array<Item>
|
名称 |
说明 |
广告 |
GA4 |
Merchant Center |
|
items |
列出与该事件相关的商品。这是包含子参数的电子商务参数。您可以点击以下链接找到分别适用于对应产品的子参数：
|
x |
x |
x |
对象
|
名称 |
说明 |
广告 |
GA4 |
Merchant Center |
|
user_data |
用于选择停止自动收集用户提供的数据的参数。 若要针对部分网页选择停止，请将 user_data 设置为 |
x |
|
|
|
user_properties |
用于随事件发送其他 Google Analytics 用户属性的参数。了解如何设置用户属性。 |
|
x |
|
相关资源