电子商务事件兼容性和转换参考（跟踪代码管理器）

本文档介绍了 Universal Analytics (UA) 与 Google Analytics（分析）4 (GA4) 之间的电子商务事件兼容性和转换。

背景

GA4 电子商务事件在发送到 UA 媒体资源时会自动转换为等效的 UA 事件。在将 UA 电子商务事件发送到 GA4 媒体资源时，也会发生这种转换。本文档介绍了转换的运作方式、事件的兼容性，以及您在使用自动转换时可能需要做出的任何权衡取舍。

目的

UA 电子商务事件与 GA4 电子商务事件之间的转换可为您提供以下几个方面的帮助：

• 易于实现：只需使用现有的 UA 实现方式并对配置稍作更新，即可采用 GA4 电子商务。
• 无需进行双重代码植入：您可以向 UA 媒体资源和 GA4 媒体资源发送相同的电子商务事件。这提供了一个选项，让您可以在转换为 GA4 的同时保留 UA 电子商务实现方式，无需维护双重代码植入配置。

权衡因素

兼容性可让您灵活地选择最合适的 GA4 迁移路径，从而满足您在保留 UA 实现方式方面的短期和长期要求。

大多数 GA4 电子商务事件/参数都与 UA 兼容，反之亦然。在存在不兼容的少数情况下，UA 或 GA4 电子商务报告中填充的数据可能并不完整，具体取决于您做出的迁移选择。

如需详细了解兼容性和所需配置，请务必查看各个迁移选项。

转换的运作方式

GA4 事件代码

• 建议使用 gtag 发送 GA4 电子商务事件。不过，GA4 事件代码可以读取推送到数据层的电子商务数据。
• 直接在 GA4 事件代码中配置的 GA4 事件参数的优先级将高于 gtag/数据层或自定义变量提供的任何数据。
• GA4 事件代码可向后兼容用于 Universal Analytics 的电子商务事件数据。优先行为如下所示：
  • 使用 GA4 电子商务事件。
  • 如果找不到 GA4 电子商务事件，则查找并使用 UA 电子商务事件。
• 如果将 UA 电子商务事件与 GA4 事件代码搭配使用，该事件将先转换为等效的 GA4 电子商务事件，然后再发送到 GA4 媒体资源。无论是使用 gtag、数据层还是自定义事件，这一点都适用。

Universal Analytics 代码

• Universal Analytics 代码支持读取 GA4 电子商务事件（包括使用 gtag 发送的数据）。
• 如果在代码中启用了读取 GA4 电子商务事件，则优先行为如下所示：
  • 使用 GA4 电子商务事件。
  • 如果找不到 GA4 电子商务事件，则查找并使用 UA 电子商务事件。
• 如果将 GA4 电子商务事件与 Universal Analytics 代码搭配使用，该事件将先转换为等效的 UA 电子商务事件，然后再发送到 UA 媒体资源。无论是使用 gtag、数据层还是自定义对象，这一点都适用。

UA 和 GA4 的类似参数

下表显示了 Universal Analytics 和 Google Analytics（分析）4 的类似电子商务参数。

类别参数转换

在将 GA4 事件发送到 UA 或将 UA 事件发送到 GA4 时，类别参数的转换将作为特殊情况进行处理。

对于 Universal Analytics，在设置 items[].category 参数时，您可以使用 / 作为分隔符来指定最多五个层级。在 Google Analytics（分析）4 中，您可以使用枚举的类别参数指定最多五个层级：items[].item_category、items[].item_category2、items[].item_category3、items[].item_category4 和 items[].item_category5。

类别转换行为如下所示：

• 对于转换为 UA 事件的 GA4 事件，枚举类别将合并到一个 category 参数，每个类别用 / 分隔。
• 对于转换为 GA4 事件的 UA 事件，系统会对类别参数的值进行拆分，以填充相应的 GA4 枚举类别。
• 如果您打算将 GA4 事件发送到 UA，建议您不要在类别值中使用 / 字符，因为在转换为 UA 事件时，该字符会被解释为类别分隔符。
• 无论定义了多少个类别层级，系统都将仅使用前 5 个类别层级。

类别转换示例

以下示例展示了转换为 GA4 类别参数的 UA 类别参数。在将 GA4 事件转换为 UA 事件时，这一原则同样适用。

具有定义了 5 个层级的类别的 UA 事件：

gtag("event", "add_to_cart", {
  items: [{
    ...
    category: "Apparel/Adult/Shirts/Crew/Short sleeve",
    ...
  }]
});

已转换为 GA4 事件的 UA 事件（具有枚举类别）：

gtag("event", "add_to_cart", {
  items: [{
    ...
    item_category: "Apparel",
    item_category2: "Adult",
    item_category3: "Shirts",
    item_category4: "Crew",
    item_category5: "Short sleeve",
    ...
  }]
});

UA 事件与 GA4 事件之间的兼容性

下表显示了 Universal Analytics 和 Google Analytics（分析）4 的类似电子商务事件以及将 UA 事件发送到 GA4 和将 GA4 事件发送到 UA 时的转换行为。

对于表格中的每一行，每一列都会提供以下信息：

• UA 事件和 GA4 事件列根据要衡量的指标显示类似事件。
• 参数列列出了在相应的 UA 事件和 GA4 事件之间没有等效项的参数。“仅限 GA4”列出了仅用于 GA4 事件的参数，“仅限 UA”列出了仅用于 UA 事件的参数。
• 转换行为（将 UA 事件发送到 GA4）列描述了在将 UA 事件发送到 GA4 媒体资源时的转换行为。备注详细说明了发送的数据、与 GA4 事件的差异以及对 GA4 报告造成的任何显著影响。
• 转换行为（将 GA4 事件发送到 UA）列描述了在将 UA 事件发送到 GA4 媒体资源时的转换行为。备注详细说明了发送的数据、与 UA 事件的差异以及对 UA 报告造成的任何显著影响。