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

本指南介绍了如何迁移现有的 gtag.js Universal Analytics 电子商务实现方式以使用 Google Analytics（分析）4 电子商务事件。

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

结果

按照本指南中的说明操作后，您将取得以下结果：为新的 GA4 媒体资源实现 Google Analytics（分析）4 电子商务事件，并使用这一新的实现方式填充现有的 Universal Analytics 报告。您的现有 Universal Analytics 实现方式将更改为接收 GA4 电子商务数据。

准备工作

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

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

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

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

权衡和考虑因素

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

优点 缺点
  • 让您在 GA4 报告和 Universal Analytics 报告中都能查看电子商务数据。
  • 使用 GA4 事件和参数可确保 GA4 电子商务报告全面完整。
  • 您需要更改现有的电子商务事件。
  • 并非所有的 GA4 事件和参数在 Universal Analytics 中都有等效项。shipping_tier、discount、currency、location_id、promotion_name 和 promotion_id 参数没有等效的 Universal Analytics 参数，因此将不会显示在 Universal Analytics 报告中。

实施步骤

1. 更新您的电子商务实现方式

更新您的现有电子商务实现方式，从使用 Universal Analytics 电子商务事件改为使用 Google Analytics（分析）4 事件。完成此步骤后，您的 Universal Analytics 媒体资源将会接收 GA4 电子商务事件。如需了解此次更新的影响，请参阅权衡和考虑因素。

为了协助您进行更新，我们提供了以下资源供您使用：

2. 创建和配置新的 GA4 媒体资源

在更新了电子商务实现方式以发送 GA4 电子商务事件后，请完成以下任一选项，以开始将数据发送到新的 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>