本指南介绍了如何为 gtag.js Universal Analytics 和 Google Analytics(分析)4 维护各自的电子商务实现方式。
如需获取其他升级指南和资源,请访问开发者迁移中心。
结果
按照本指南中的说明操作后,您将取得以下结果:为新的 GA4 媒体资源实现 Google Analytics(分析)4 电子商务事件,同时让现有的 Universal Analytics 电子商务实现方式保持不变。您将向 Universal Analytics 媒体资源和 Google Analytics(分析)4 媒体资源发送不同的电子商务事件。
请注意,如果您同时针对 UA 和 GA4 实现电子商务,您的 Google Analytics(分析)4 媒体资源将会使用 GA4 电子商务实现方式。
准备工作
使用电子商务迁移助手工具确认以下描述是否符合您当前的实现情况:
- 您使用的是 Universal Analytics 媒体资源
- 您的网站使用 gtag.js 库发送电子商务事件
若要了解每个选项的权衡因素,请查看适用于电子商务实现的升级选项。确认您想要按照本指南中的说明操作,同时采用两种分析实现方式:一种用于 Universal Analytics 媒体资源,另一种用于 Google Analytics(分析)4 媒体资源。
权衡和考虑因素
查看并考虑以下信息,以全面了解使用两种电子商务实现方式(一种适用于 Universal Analytics 媒体资源,另一种适用于 Google Analytics [分析] 4 媒体资源)的影响。
优点 | 缺点 |
---|---|
|
|
实施步骤
1. 创建和配置新的 GA4 媒体资源
如需创建和配置新的 Google Analytics(分析)4 媒体资源,请完成以下步骤:
- 创建新的 Google Analytics(分析)4 媒体资源。
- 使用 GA4 设置助理自动创建新的 GA4 媒体资源,并从您的 Universal Analytics 媒体资源中复制以下设置:“媒体资源名称”“网站网址”“时区”和“币种设置”。不过,请取消选中“使用现有代码实现数据收集”选项,以停用“已关联的网站代码”功能。或者,如果您不想从 Universal Analytics 媒体资源中复制任何设置,则可以在不使用 GA4 设置助理的情况下创建 Google Analytics(分析)4 媒体资源。
- 查找 Google Analytics(分析)4 媒体资源的代码 ID。您将在下一步中使用此 ID 配置 GA4 媒体资源。
- 添加 GA4 媒体资源
- 为确保 Universal Analytics 事件仅发送到 UA 媒体资源且 Google Analytics(分析)4 事件仅发送到 GA4 媒体资源,请使用 gtag.js 提供的以路由方式发送数据功能。
- 将 Google Analytics(分析)4 媒体资源添加到您的现有 gtag.js 代码段。将
config
命令和groups
参数与代码 ID 搭配使用,以便独立于 Universal Analytics 媒体资源,将事件以路由方式发送到 GA4 媒体资源。
以下示例展示了一个 gtag.js 代码段,其中已配置 Universal Analytics 媒体资源和 Google Analytics(分析)4 媒体资源,且后一种媒体资源已分配到 GA4 群组。GA4
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-XXXXX-Y"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'UA-XXXXX-Y'); // Universal Analytics property
gtag('config', 'TAG_ID', { 'groups': 'GA4' }); // Google Analytics 4 property
</script>
2. 实现 GA4 电子商务事件并以路由方式将其发送到您的 GA4 媒体资源
创建和配置新的 Google Analytics(分析)4 媒体资源后,您就可以实现 GA4 电子商务事件了。为了让您的 GA4 实现方式类似于 Universal Analytics 实现方式,请使用以下资源:
- Google Analytics(分析)4 电子商务指南,用于了解如何发送 GA4 电子商务事件。
- UA 事件与 GA4 事件之间的兼容性表格以及 UA 和 GA4 的类似参数表格。这些信息有助于您将 Universal Analytics 电子商务事件名称和参数映射到等效的 Google Analytics(分析)4 事件和参数。
- 电子商务迁移助手工具,用于验证您添加的 GA4 电子商务事件是否正确无误以及是否与您的 Universal Analytics 实现方式类似。
以下示例展示了如何使用适用于 GA4 事件的 send_to
参数分别将 Universal Analytics 和 Google Analytics(分析)4 电子商务 purchase
事件发送到其各自的媒体资源:
// Universal Analytics.
// The original UA implementation remains unchanged.
gtag('event', 'purchase', {
"transaction_id": "24.031608523954162",
"affiliation": "Google online store",
"currency": "USD",
"shipping": 7.50,
"tax": 1.80,
"value": 33.30,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_name": "Search Results",
"list_position": 1,
"quantity": 2,
"price": 12.00
}
]
});
// The new Google Analytics 4 ecommerce implementation.
// Uses `send_to` to route data to the GA4 group defined in the tag config.
gtag('event', 'purchase', {
"send_to": "GA4",
"transaction_id": "24.031608523954162",
"affiliation": "Google online store",
"currency": "USD",
"shipping": 7.50,
"tax": 1.80,
"value": 33.30,
"items": [
{
"item_id": "P12345",
"item_name": "Android Warhol T-Shirt",
"item_brand": "Google",
"item_category": "Apparel/T-Shirts",
"item_variant": "Black",
"quantity": 2,
"price": 12.00
}
],
});