事件

本文介绍了如何将 Universal Analytics (UA) 事件迁移到 Google Analytics（分析）4 (GA4) 事件。

由于 UA 和 GA4 的衡量模型有所不同，因此建议您根据 GA4 模型重新考虑数据收集，而非将现有 UA 事件结构移植到 GA4 中。

要详细了解 GA4 事件，请参阅事件简介。

UA 事件和 GA4 事件比较

Universal Analytics

Universal Analytics (UA) 通过发送命中数据来进行衡量。大多数类型的命中数据都用于衡量特定的互动（例如 pageview），但 event 类型的命中数据可用于自定义/常规衡量。随 event 命中发送的数据包括类别、操作和标签。

下面是 analytics.js 和 gtag.js 库的 Universal Analytics 事件示例：

analytics.js (UA)

// Send an event using analytics.js.
ga('send', 'event', 'Settings', 'Enable', 'Dark mode');

// Alternatively, you can specify the event fields in the fieldsObject.
// The command above could be rewritten as:
ga('send', {
  hitType: 'event',
  eventCategory: 'Settings',
  eventAction: 'Enable',
  eventLabel: 'Dark mode'
});

gtag.js (UA)

gtag('event', 'Enable', {
  event_category: 'Settings',
  event_label: 'Dark mode'
});

Google Analytics（分析）4

Google Analytics（分析）4 (GA4) 通过发送事件进行衡量。其中包括自动收集的事件、预定义事件、建议您在适当情况下发送的事件，以及可以在自动事件或推荐事件不符合您的使用情形时发送的自定义事件。

以下是 GA4 中的自定义事件示例：

gtag.js (GA4)

gtag('event', 'settings_update', {
  setting: 'mode',
  status : 'dark'
});

将 UA 事件映射到 GA4

要将 UA 事件迁移到 GA4，您需要确定是否存在等效的 GA4 事件。要将 UA 事件映射到 GA4，请使用以下分步方法：

查看自动收集事件列表。如果 GA4 自动收集的事件与 UA 事件高度匹配，则移除 UA 事件并依赖自动收集的事件。
如果您在上一步中未找到匹配项，请查看通过增强型衡量功能收集的事件。如果 GA4 增强型衡量事件与 UA 事件的目的高度匹配，则不要迁移 UA 事件，而是依靠增强型衡量功能发送事件。请务必确认您的 GA4 媒体资源是否正确配置了增强型衡量功能，以收集此事件。
如果您在上一步中未找到匹配项，请查看推荐事件列表。如果 GA4 推荐的事件与 UA 事件的目的高度匹配，则在发送事件时使用推荐的事件，并设置所有适用的事件参数。
如果您在上一步中未找到匹配项，请发送自定义事件。

迁移场景和示例

自动收集的事件

自动收集的事件始终会被发送，且通常无法停用，除非这些事件可以通过增强型衡量功能配置。一般来说，如果 UA 事件有足够等效的自动收集的事件，则不应该迁移该事件。

例如，因为 GA4 中的 file_download 事件是自动收集的，所以为衡量文件下载互动而发送的 UA 事件可能不需要迁移到 GA4。

增强型衡量功能

通常情况下，如果足够等效的 GA4 事件是通过增强型衡量功能收集的，则不需要将 UA 事件迁移到 GA4。例如，因为以下 UA 事件已在 GA4 中通过增强型衡量功能进行了衡量，所以可能不需要迁移到 GA4：

衡量出站点击次数的 UA 事件等同于 GA4 中的 click 事件。
衡量文件下载的 UA 事件等同于 GA4 中的 file_download 事件。

增强型衡量功能替换

如果某个增强型衡量事件在目的上等同于您的 UA 事件，但无法捕获您需要的所有数据，您可以手动发送该事件，并提供额外的自定义参数。为此，您需要为相应事件配置/停用增强型衡量功能，并手动发送该 GA4 事件。

例如，通过增强型衡量功能收集的 file_download 事件与您的 UA 事件高度匹配，但缺少关于文件大小的信息。要替换增强型衡量事件并添加文件大小信息，请执行以下操作：

在增强型衡量功能中停用文件下载。
在适当的情况下，手动发送包含自定义参数的 file_download 事件。
- 由于自动收集的事件是通过增强型衡量功能停用的，因此您需要手动设置通常随该事件一起收集的参数（例如 file_extension、file_name 等）。
创建自定义维度/指标以查看报告中的所有自定义参数值。

以下 gtag.js 示例会发送带有 file_size 自定义参数的 GA4 file_download 事件。

gtag('event', 'file_download', {
  file_extension: '.mp4',
  file_name: 'tutorial.mp4',
  link_url: '/videos/tutorial.mp4',
  link_text: 'Download the tutorial!',

  // Custom parameter.
  file_size: '275 MB'
});

自定义事件

如果您的 UA 事件没有相应的自动收集的事件、增强型衡量事件或推荐事件，请将您的 UA 事件迁移到自定义事件，并根据需要创建自定义维度和指标。

下面的示例演示了衡量对界面屏幕方向选项的更改的 analytics.js UA 事件：

ga('send', 'event', 'orientation', 'layout', 'wide');

没有可用于衡量上述 UA 事件的预定义 GA4 事件。以下 gtag.js 示例演示了如何使用自定义事件衡量 GA4 中的同一互动：

gtag('event', 'orientation_update', {
  ui_element: 'layout',
  configuration: 'wide'
});

要在报告中包含 ui_element 和 configuration，您需要利用这些事件参数创建相应的维度。如需了解详情，请参阅自定义维度和指标。

事件