如 Google Analytics（分析）4 中的事件与 Universal Analytics 中的事件一文中所述，在从 Universal Analytics 迁移到 Google Analytics（分析）4 时，一项基本任务就是将您当前的衡量方法（包括网页浏览、事件、自定义维度，有时还包括自定义指标）转换为 Google Analytics（分析）4 架构。
改用不同的衡量范式让您有机会重新评估整体衡量方法、重新与利益相关方进行协调以及制定新的要求和 KPI，而下列文章重点介绍了如何在 Google Analytics（分析）4 中复制 Universal Analytics 衡量里必不可少的各方面。
本文包含的主题：映射事件
自动收集的事件和推荐事件的范式与 Universal Analytics 无关，但确实构成了 Google Analytics（分析）4 实现的核心。
将 Universal Analytics 媒体资源中的事件映射到 Google Analytics（分析）4 媒体资源时：
- 首先，查找匹配的增强型衡量事件。
- 如果找到匹配事件，则不应重新创建新事件。
- 添加
'send_to'参数，以便将事件只发送到 Universal Analytics 媒体资源实现，而不发送到 Google Analytics（分析）4 媒体资源实现。详细了解事件路由。 - 如果不存在匹配的增强型衡量事件，请继续执行第 2 步。
- 查找匹配的自动收集的事件。
- 如果找到匹配事件，则不应重新创建新事件。
- 添加
'send_to'参数，以便将事件只发送到 Universal Analytics 媒体资源实现，而不发送到 Google Analytics（分析）4 媒体资源实现。详细了解事件路由。 - 如果不存在匹配的自动收集的事件，请继续执行第 3 步。
- 查找匹配的推荐事件。实现您的代码以触发推荐的事件。
- 最后，如果您无法找到合适的等效事件，请创建自己的自定义事件。
下表提供的示例说明了 Universal Analytics 中实现的事件，以及如何在 Google Analytics（分析）4 中复制这些事件。
| UA 事件定义 | GA4 事件类型 | GA4 事件配置 |
|---|---|---|
|
事件类别：download 事件操作：pdf 事件标签：catalog.pdf |
自动收集的事件 | 在网站数据流中进行增强型衡量时，系统默认记录 file_download 事件及 file_name 等关联参数，它们在 UA 和 GA4 中具有相同的用途。您无需在 Google Analytics（分析）4 中手动重新创建此事件。 |
|
事件类别：engagement 事件操作：login 事件标签：google-sso |
推荐事件 | 使用推荐的 login 事件，并将推荐的 method 参数设置为 google-sso。 |
|
事件类别：navigation-click 事件操作：top 事件标签：company-about-us |
自定义事件 | 由于 Google Analytics（分析）4 中没有等效的自动收集的事件或推荐事件，因此您可以根据自己的命名方式为自定义事件和参数命名。例如，navigation_click 作为事件名称，click_location=top 和 click_text=company-about-us 作为自定义参数。 |
推荐事件与自定义事件
Google Analytics（分析）4 中的推荐事件与自定义事件类似，这是因为系统不会自动跟踪这些事件，您必须手动将其添加到您的衡量代码中并指定事件名称和其他参数值。
推荐事件的重要性体现在，目前（或是将来进行产品更新时）在报告界面中处理这些事件的方式有所不同。例如，Google Analytics（分析）4 会专门查找推荐的在线销售事件和参数，以填充内置的创收报告。如果您使用不同的值来记录网站或移动应用电子商务操作，则需要创建您自己的自定义报告来读取您已记录的数据，您的数据将不会填充内置创收报告。
目前，并非所有的推荐事件都会填充特定的内置报告，不过实现推荐事件后，它们可在日后有可用的新报告时自动进行填充。
使应用事件与网站事件保持一致
Google Analytics（分析）4 媒体资源结合了应用和网站衡量功能；相比之下，Universal Analytics 媒体资源则侧重于网站。如果您的 Google Analytics（分析）4 媒体资源中有应用数据流，并且您正在寻找跨平台数据分析结果，则应确保应用和网站事件数据收集的一致性。
例如，您应注意以下几点：
- 相同的事件应使用相同的命名方式（例如，如果应用中有名为
access_purchase的事件，则应避免将网站上与之对应的事件命名为accessory_purchase） -
相同的事件应具有相同的关联参数（例如，如果在应用中为
accessory_purchase事件传递了 country_code，则应避免在网站上为对应的accessory_purchase事件传递 country），并且确保为参数使用相同的命名方式（例如，如果在应用中为accessory_purchase事件传递了 country_code 参数，则应避免在网站上为对应的accessory_purchase事件传递 cc 参数） - 相同的参数应在数据收集期间传递类似的值（例如，如果在应用中为 country_code 参数传递了 USA，则应避免在网站上为对应的 country_code 参数传递 US）
-
在应用和网站中为 User-ID 传递的值应属于相同的类型（例如，如果在应用中传递了整数 555321，则应避免在网站中传递字符串 '555321'）
一致的实现和事件命名可确保您的应用和网站数据具有可比性，并让您能够准确了解最终用户的转化历程。
事件命名和参数方面的注意事项
请尽量使用建议的事件名称，以充分利用 Google Analytics（分析）4 媒体资源中的报告功能和未来推出的功能。
除了通过自动收集的参数（language、page_location、page_referrer、page_title、screen_resolution）发送的内容以外，您还可以使用事件参数随事件发送其他信息。您收集的所有参数都可用于受众群体定义，也可在 BigQuery 中使用。
一个参数可以包含任意数量的唯一值。不过，在设置 Google Analytics（分析）4 媒体资源并同时保留 Universal Analytics 媒体资源时，您需要考虑以下重要限制和行为。
- 每个事件最多可发送 25 个自定义参数，每个参数值可以有 100 个字符。
- 每个媒体资源的总限额为 50 个自定义维度和 50 个自定义指标。
event_category: "Videos"
action: "Download"
event_label: "Toy Story"
如果 Universal Analytics 媒体资源是通过 gtag.js 实现的，此事件将根据以下逻辑转换为 Google Analytics（分析）4 媒体资源中的事件：
- “Download”转换为事件名称
- “event_category”转换为自定义参数
- “event_label”转换为自定义参数
更通用的事件结构可能如下所示：
event_category: [resourceType]
action: [interactionType]
event_label: [resourceName]
在 gtag.js 代码中，“action”转换为事件名称；如果您有 10 种类型的互动，它会转换为 10 个不同的事件名称。
在将 Universal Analytics 媒体资源中的参数转换为 Google Analytics（分析）4 媒体资源中的参数时应遵循类似的格式；您需要向每个新的“action”事件添加“event_category”和“event_label”参数。
映射自定义维度
自定义维度提供了扩展 Google Analytics（分析）数据集的关键功能，以捕获与您最相关的网页、事件和用户的分类。
Google Analytics（分析）4 中的自定义维度与 Universal Analytics 中的等效项在概念上类似，但前者的功能更加广泛。在 Google Analytics（分析）4 中，您可能需要维护在 Universal Analytics 中定义的自定义维度。此外，对于在 Universal Analytics 中作为事件维度进行跟踪的许多值（尤其是事件类别和事件标签），在 Google Analytics（分析）4 中应将其作为自定义维度重新创建。
详细了解如何创建自定义维度和指标。
之前，Google Analytics（分析）4 具有注册自定义事件参数的概念，以便这些参数显示在报告中。但这一概念已不再适用。现在只需创建自定义维度和指标即可实现相同的效果。
下表说明了如何将 Universal Analytics 事件衡量映射到 Google Analytics（分析）4。
| 使用场景 | Universal Analytics | GA4 - 自动收集的事件或自定义事件 | GA4 - 自定义维度或指标 |
|---|---|---|---|
| 衡量视频互动度 | 事件操作 = video_start | 在增强型衡量功能中启用“视频互动度”。 | 如果您想要了解视频进度，则可以根据“video_percent”创建自定义维度 |
| 事件类别 = engagement | |||
| 事件标签 = lesson-1 | 根据“video_title”创建自定义维度 | ||
| 记录与贷款计算工具的互动 | 事件操作 = loan-calculator | 事件名称：loan_calculator（自定义） |
|
| 事件类别 = refinance | 事件参数：loan_type = refinance（自定义） | 根据此事件参数创建自定义维度 | |
| 事件标签 = residential |
事件参数：borrower_type = residential（自定义） |
根据此事件参数创建自定义维度 | |
| 当前借款方（自定义维度）= true |
事件参数：current_borrower = true（自定义） |
根据此事件参数创建自定义维度 | |
| 贷款金额（自定义指标）= 250000 | 事件参数：loan_amount = 250000（自定义） | 根据此事件参数创建自定义指标* | |
| 记录博客页面的作者和类别 | 网页浏览命中 | 事件名称：page_view（自定义）** |
** |
| 作者（自定义维度）= theresa c | 事件参数：author = theresa c（自定义） | 根据此事件参数创建自定义维度 | |
| 博客类别（自定义维度）= privacy-legislation | 事件参数：blog_category = privacy-legislation（自定义） | 根据此事件参数创建自定义维度 | |
| 在用户登录时记录忠诚度 |
事件操作 = login |
事件名称：login（推荐） |
|
|
事件类别 = login *** |
|||
| 忠诚度（自定义维度）= platinum |
事件参数：loyalty_level = platinum（自定义） |
根据此事件参数创建自定义维度（用户级范围） |
为网页浏览传递自定义参数
上表中的一个示例将“author”和“blog_category”标识为您可能需要为 Google Analytics（分析）4 网页浏览添加的自定义参数。由于您无法为增强型衡量功能中启用的自动发送的网页浏览事件添加自定义参数，因此您可以采取以下两种方法之一。
方法 1：停用网页浏览自动跟踪并发送自定义网页浏览事件。
- 如需停用
page_view事件，您可以设置 send_page_view: false [使用 Google 代码 (gtag.js) 时]，或是取消选中“在此配置加载时发送页面浏览事件”复选框来修改 GA4 配置代码（使用跟踪代码管理器时）。 - 手动添加
page_view事件，传入额外的自定义参数。如果您需要为大多数网页浏览添加自定义参数，此方法可能特别适合。
方法 2：专门发送自定义事件以捕获其他参数
您还可以使用自定义事件来捕获其他参数。例如，您可以创建一个名为 record_page_metadata 的自定义事件，仅记录网页上的作者和类别。对于移动应用，您可以为手动跟踪的屏幕浏览添加自定义参数。例如，您可以使用自定义参数“page_topic=education-opportunities”来创建名为 screen_view_duplicate 的自定义事件。
注意：发送重复事件会增加指定时间内捕获的事件总数，这可能会在较短的日期范围内或较小的样本规模下触发采样。
当您要记录一小部分网页浏览或屏幕浏览的自定义参数时，或不希望达到抽样上限时，最好采用此方法。
自动收集和推荐的参数的自定义维度
Google Analytics（分析）4 中自动捕获的一些事件参数会映射到内置报告维度：“page_title”便是其中一个示例。许多其他自动收集的参数和推荐参数（例如上述 file_download 事件示例中的“file_name”）不会自动映射到内置或自定义的维度或指标；您仍需要先将这些参数映射到自定义设置，然后才能在 Google Analytics（分析）4 中将其用于大部分报告用途。