[UA→GA4] UA 的 gtag.js 与 GA4 之间对应关系

这是一份高级实现指南，面向使用 gtag.js 库并希望了解 Universal Analytics (UA) 的 gtag.js 与 Google Analytics（分析）4 之间对应关系的网站所有者。本文假定您已经创建了 Google Analytics（分析）4 媒体资源。如果您只需向网站添加基本衡量代码，请参阅这篇文章。

本文包含的主题：

• gtag.js 代码段简介
• 基本数据收集
• gtag.js 的配置设置
• 事件
• 自定义维度和指标

gtag.js 代码段和媒体资源 ID 简介

适用于 Universal Analytics 媒体资源和适用于 Google Analytics（分析）4 媒体资源的 gtag.js 代码段本质上是相同的。两种代码段均具有以下结构：

01：<script async src="https://www.googletagmanager.com/gtag/js?id=<某个媒体资源 ID A>"></script>

02：<script>

03：window.dataLayer = window.dataLayer || [];

04：function gtag(){dataLayer.push(arguments);}

05：gtag('js', new Date());

06：

07：gtag('config', '<某个媒体资源 ID A>');

08：

09：gtag('config', '<某个媒体资源 ID B>');

10：

11：gtag('event', 'sign_up', { 'method': 'email' });

12：

13：gtag('event', 'view_video', { 'send_to': '<某个媒体资源 ID B>' });

14：

15：</script>

第 1 行：如果您已经通过 gtag.js 实现了 Universal Analytics 媒体资源，您的网站上可能已经有这行代码了。您看到的将是“UA-”后跟一组数字，而不是 <某个媒体资源 ID A>。如果您针对 Google Ads 或其他 Google Marketing Platform 产品实现了 gtag.js，您的网站上也可能会有这行代码，但 <某个媒体资源 ID A> 的开头将是“AW-”或“DC-”。

<某个媒体资源 ID A> 所指示的媒体资源 ID（对于 Google Analytics（分析）4 媒体资源，则为代码 ID）“控制”着此 gtag.js 代码段。这行代码至关重要，因为：

1. 如果这行代码已经存在，则无需再次实现。您只需添加“config”行即可指定代码 ID。
2. 这行代码中的媒体资源 ID 是 gtag.js 代码段的“控制器”。如果 Universal Analytics 媒体资源 ID（格式为“UA-XXXXXXXX”）控制着代码，您将可以使用已关联的网站代码向 Google Analytics（分析）4 媒体资源发送衡量数据，而无需向页面添加任何新代码。

第 7 行：可以通过 gtag“config”指令为与 <某个媒体资源 ID A> 相关联的媒体资源启用数据收集。例如，在某项 Google Analytics（分析）4 媒体资源中添加此指令并在其中包含代码 ID 后，系统会将 page_view 事件发送到该媒体资源。

媒体资源 ID 可能表示为不同 Google 产品收集衡量数据，其中包括 Universal Analytics 媒体资源（格式为“UA-XXXXXXXX”）、Google Analytics（分析）4 媒体资源（格式为“G-XXXXXXXX”）、Google Ads（格式为“AW-XXXXXXXX”）或 Floodlight（格式为“DC-XXXXXXXX”）。

第 11 行：gtag“event”指令将发送某个事件。如果代码段中存在针对多个媒体资源的多个“config”指令，系统会将此事件发送到所有媒体资源。

在本例中，“sign_up”参数是事件名称。最后一个参数是一个包含一组事件参数的对象。在本例中，“method”参数的值为“email”。

第 13 行：此处的事件带有“send_to”参数。这是一个特殊的参数，可将相关联的事件发送到特定媒体资源。换句话说，系统只会将此事件发送到 <某个媒体资源 ID B> 所指示的媒体资源。

gtag config 命令可实现基本衡量。

• 对于 Universal Analytics 媒体资源，包含 Universal Analytics 媒体资源 ID 的“config”指令可发送网页浏览命中。
• 对于 Google Analytics（分析）4 媒体资源，当包含代码 ID 的“config”在网页上加载时，系统会收集 page_view 事件（作为自动收集的事件）。

媒体资源标识符

Universal Analytics 媒体资源 ID 的格式为“UA-XXXXXXXX”，有时也称为跟踪 ID。在本指南中，我们将其称为 UA 媒体资源 ID。

Google Analytics（分析）4 媒体资源网站数据流使用的是格式为“G-XXXXXXXX”的代码 ID。

在一些代码示例和文档中，您可能会看到两者都被称为“TAG_ID”。

基本数据收集

为 Google Analytics（分析）4 媒体资源启用基本数据收集后，即可收集以下事件：

• page_view 事件
• 自动收集的事件
• 增强型衡量事件（如果已在界面中启用）

如果您现有的 Universal Analytics 媒体资源使用 gtag.js 代码，则可以通过以下方式为 Google Analytics（分析）4 媒体资源启用基本数据收集：

• 选项 1：添加包含相关代码 ID 的新“config”指令
  或者
• 选项 2：启用已关联的网站代码（如果现有的 gtag.js 代码符合使用条件）

无论您选择哪种方式，现有的 Universal Analytics 媒体资源都不会受到影响，仍会继续收集数据。

选项 1：添加新的“config”指令

如果页面上已有 gtag.js 代码，只需额外添加一个“config”指令，并在其中包含相关 Google Analytics（分析）4 媒体资源的衡量 ID 即可。在下面的示例中，我们向现有 gtag.js 代码添加了第 8 行代码。这行代码中引用了 Google Analytics（分析）4 媒体资源的衡量 ID，这样一来，系统会将 page_view 事件发送到对应的 Google Analytics（分析）4 媒体资源。另外，还可以在此 Google Analytics（分析）4 媒体资源中启用自动收集的事件和增强型衡量事件（如果已启用增强型衡量功能）。

1：<script async src="https://www.googletagmanager.com/gtag/js?id=<某个媒体资源 ID A>"></script>

2：<script>

3：window.dataLayer = window.dataLayer || [];

4：function gtag(){dataLayer.push(arguments);}

5：gtag('js', new Date());

6：

7：gtag('config', '<某个媒体资源 ID A>');

8：gtag('config', 'G-XXXXXXXX');

9：</script>

选项 2：启用已关联的网站代码

如果符合以下条件，您可以使用已关联的网站代码：

• 您想要衡量用户互动情况的页面上的现有 gtag.js 代码段由 Universal Analytics 媒体资源“控制”（也就是说，gtag.js 代码段的这行代码中引用的 ID 以“UA-”开头）：

<script async src="https://www.googletagmanager.com/gtag/js?id=<某个媒体资源 ID A>"></script>

（如果现有 gtag.js 代码段由 Google Analytics（分析）4 媒体资源控制，也可以使用已关联的网站代码。不过，只有在已实现 Google Analytics（分析）4 媒体资源时，才会出现这种情况。）

• 并且您对代码段中的 ID 所引用的 Universal Analytics 媒体资源拥有管理员访问权限。

如果您的网页中同时实现了 gtag.js 代码和 GTM 容器，则 gtag.js 代码必须放置在 GTM 容器上方，才能使已关联的网站代码正常运行。

gtag.js 的配置设置

您可以配置基本的 gtag.js 代码段，以控制 IP 匿名化、Cookie 自定义和 Google 信号等数据收集设置。您可以通过在 gtag.js 中使用“config”或“set”指令来实现这一点。

Universal Analytics 媒体资源（格式为“UA-XXXXXXXX”）和 Google Analytics（分析）4 媒体资源（格式为“G-XXXXXXXX”）都支持通过 gtag.js 实现这些 config 设置。不过，Universal Analytics 媒体资源和 Google Analytics（分析）4 媒体资源之间的配置设置存在一些差异。

• IP 匿名化已设为“true”，不能在 Google Analytics（分析）4 媒体资源中配置。因此，对于发送到 Google Analytics（分析）4 媒体资源（格式为“G-XXXXXXXX”）的标准事件，系统会自动掩盖 IP 地址。

• 如果需要向所有已配置的媒体资源应用全局设置，应使用“set”命令，以便将其应用于所有衡量 ID 和/或媒体资源 ID 所指示的媒体资源，包括通过已关联的网站代码实现的媒体资源。
• 请特别注意“停用广告个性化”功能，这些功能通常是通过“config”代码行实现的。
• 如果使用已关联的网站代码：在 gtag.js 代码中使用“config”指令设置的任何配置仅会应用于与相应代码行中的衡量 ID 相关联的媒体资源；系统不会自动将这些配置发送到关联的 Google Analytics（分析）4 媒体资源。如果您要将配置应用于关联的 Google Analytics（分析）4 媒体资源，请执行以下操作：
  • 创建一个单独的“config”指令，然后通过引用衡量 ID 将其应用于相关的 Google Analytics（分析）4 媒体资源
    或者
  • 使用“set”指令配置设置，在这种情况下，相应配置将应用于所有已配置的媒体资源。

配置示例

启用基本数据收集；配置 User-ID

gtag('config', 'GA_MEASUREMENT_ID', {

'user_id': 'USER_ID'

});

配置 Cookie 设置

gtag('config', 'GA_MEASUREMENT_ID', {

'cookie_prefix': 'MyCookie',

'cookie_domain': 'blog.example.com',

'cookie_expires': 28 * 24 * 60 * 60 // 28 天，以秒为单位

});

屏蔽 page_view 事件

如果在加载 config 代码时不需要发送 page_view 事件（例如已加载 iframe），则可以调整 config 设置来屏蔽 page_view 事件。请设想一个情景：发送 page_view 事件之后用户登录网站。对于登录互动，您可以使用“config”指令来设置 User-ID，但不需要再次发送 page_view 事件。以下代码说明了如何防止发送 page_view 事件。

gtag('config', 'MEASUREMENT_ID', {

'user_id': 'USER_ID',

'send_page_view': false

});

事件

请参阅事件迁移指南。

自定义维度和指标

自定义维度和指标可用于扩展信息，以及从客户关系管理系统等位置导入离线数据。

当使用 Google 代码 (gtag.js) 时，如果使用了已关联的网站代码或 Google Analytics（分析）4 媒体资源（例如“G-XXXXXXXX”），自定义维度和指标衡量会自动转换为参数。

详细了解自定义维度和指标。