GA4 电子商务 (gtag.js)：发送 Universal Analytics 事件

本指南介绍了如何使用现有的 gtag.js Universal Analytics 电子商务实现方式将电子商务事件发送到 Google Analytics（分析）4 媒体资源。

如需获取其他迁移指南和资源，请访问开发者迁移中心。

结果

按照本指南中的说明操作后，您将取得以下结果：您的现有 Universal Analytics 实现方式将用于填充新的 Google Analytics（分析）4 媒体资源。您的现有 Universal Analytics 实现方式将保持不变，系统将继续向您的 UA 电子商务报告填充数据，并且您的新 Google Analytics（分析）4 媒体资源将开始接收数据。

准备工作

1. 使用电子商务迁移助手工具确认以下描述是否符合您当前的实现情况：

   • 您使用的是 Universal Analytics 媒体资源
   • 您的网站使用 gtag.js 库发送电子商务事件

2. 如要了解每个选项的权衡因素，请查看适用于电子商务实现的迁移选项。确认您确实想要按照本指南中的说明，为 Google Analytics（分析）4 使用现有的 gtag.js Universal Analytics 实现方式。

3. 如要了解 UA 事件在发送到 GA4 媒体资源时如何进行转换，请参阅事件兼容性参考。

权衡和考虑因素

查看并考虑以下信息，以全面了解将现有的 gtag.js (Universal Analytics) 电子商务实现方式用于 Google Analytics（分析）4 媒体资源的影响。

优点	缺点
最简单的实现选项，因为您无需更改现有的电子商务事件代码。 让您在 GA4 报告和 Universal Analytics 报告中都能查看电子商务数据。 Universal Analytics 媒体资源中电子商务数据的收集或报告方式不会发生任何变化。	GA4 无法识别 select_content、checkout_progress、set_checkout_option 和 view_refund 事件，因此这些事件将不会显示在 GA4 电子商务报告中。 上述事件及其关联的参数在 GA4 中将被视为自定义事件和自定义参数。但是，不支持将 items 参数视为自定义参数，因此系统不会将数据发送到 Google Analytics（分析）。 “GA4 购物车详情/离开漏斗”报告中的“添加配送信息”步骤将为空。 “GA4 商品/产品/商品列表漏斗”报告中的“列表点击”步骤将为空。 GA4 无法识别用于类别的 / 分隔符。GA4 会将“cat1/cat2/cat3”作为一个类别（而非三个类别，即“cat1”“cat2”和“cat3”）进行报告。

实施步骤

若要使用现有的 gtag.js Universal Analytics 实现方式将电子商务事件发送到 Google Analytics（分析）4 媒体资源，请完成以下任一选项。

选项 1：使用 GA4 设置助理并启用已关联的网站代码

GA4 设置助理将自动创建新的 GA4 媒体资源，并从您的 Universal Analytics 媒体资源中复制以下设置：“媒体资源名称”“网站网址”“时区”和“币种设置”。该工具还可启用已关联的网站代码功能，以重复使用您的现有 Universal Analytics gtag.js 实现方式来加载新的 GA4 媒体资源。

请按照 GA4 设置助理中所述的步骤创建和配置新的 Google Analytics（分析）4 媒体资源。确保选中“使用现有代码实现数据收集”选项，以使用“已关联的网站代码”功能。

选项 2：更新您的 gtag.js 代码段

1. 创建新的 Google Analytics（分析）4 媒体资源。
   • 使用 GA4 设置助理添加 Google Analytics（分析）4 媒体资源。不过，如果设置过程提示取消选中“使用现有代码实现数据收集”选项，请按提示操作。或者，在不使用 GA4 设置助理的情况下创建 Google Analytics（分析）4 媒体资源。使用设置助理的优势在于，它会从 Universal Analytics 媒体资源中复制一些基本设置。
2. 查找 Google Analytics（分析）4 媒体资源的衡量 ID。
3. 使用包含衡量 ID 的 config 命令将 Google Analytics（分析）4 媒体资源添加到您的现有 gtag.js 代码段。

以下示例展示了已配置 Universal Analytics 媒体资源和 Google Analytics（分析）4 媒体资源的 gtag.js 代码段。

<!-- 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');  // Google Analytics 4 property.
  
</script>