本文属于从 Universal AnalyticsGoogle Analytics(分析)4 迁移指南的一部分。请参阅迁移指南目录

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

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

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”行即可指定 Google Analytics(分析)4 媒体资源的衡量 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 媒体资源,当包含 Google Analytics(分析)4 媒体资源衡量 ID 的“config”指令在页面上加载时,系统会收集 page_view 事件(作为自动收集的事件)。

媒体资源标识符

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

Google Analytics(分析)4 媒体资源网站数据流使用衡量 ID,格式为“G-XXXXXXXX”。

在一些代码示例和文档中,您可能会看到媒体资源 ID 和衡量 ID 都被称为“GA_Measurement_ID”。

基本数据收集

为 Google Analytics(分析)4 媒体资源启用基本数据收集后,即可收集以下事件:

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

  • 选项 1:添加包含相关 Google Analytics(分析)4 媒体资源衡量 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

});

事件

请参阅事件迁移指南

自定义维度和指标

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

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

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

 

该内容对您有帮助吗?
您有什么改进建议?
搜索
清除搜索查询
关闭搜索框
Google 应用
主菜单
搜索支持中心
true
69256
false