Universal Analytics 的 gtag.js 与 Google Analytics(分析)4 之间的对应关系

这是一份高级实现指南,面向使用 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 实现的 Universal Analytics 媒体资源(格式为“UA-XXXXXXXX”)中,使用“事件类别”、“事件操作”、“事件标签”维度和“事件值”指标将事件实现为单独的命中类型。系统收集这些事件后,它们会显示在您的报告中,且不同事件、维度和指标值的数量没有限制。

在 Google Analytics(分析)4 媒体资源中,每个“命中”都是一个“事件”,这意味着命中类型之间不再有区别。

Google Analytics(分析)4 媒体资源中的事件类型

Google Analytics(分析)4 中的事件分为四类:自动收集的事件、增强型衡量事件、推荐事件和自定义事件。

  1. 自动收集的事件:指通过基本数据收集自动收集的事件。
  2. 增强型衡量事件:指您可以在 Google Analytics(分析)4 媒体资源中的“管理”界面来启用或停用的事件。对于增强型衡量事件,无需在网站上或应用中添加/修改代码。
    • 请注意,如果事件是作为个别事件实现的,并且也通过增强型衡量功能收集,这些事件将被记录两次。如果您要向 Universal Analytics 媒体资源和 Google Analytics(分析)4 媒体资源发送某个事件,解决方案是在此事件中添加“send_to”参数来指定相关 Universal Analytics 媒体资源 ID。这样,此事件只会流向 Universal Analytics 媒体资源,而不会流向 Google Analytics(分析)4 媒体资源。
    • 技术说明:增强型衡量功能并非依托 HTML ID 或类,这与通过 Google 跟踪代码管理器将 HTML ID 和类用作事件(例如点击链接或下载)的触发器或变量有所不同。

  1. 推荐事件:指您手动实现但采用 Google 预定义名称和参数的事件。推荐事件可解锁现有和未来的报告功能,而这些功能无法在自定义事件(您自行命名的事件)中使用。推荐事件适用于:
  1. 自定义事件:指您自行命名并实现的事件。

实现事件的最佳做法

  1. 尽可能使用自动收集的事件和增强型衡量事件,而不是自行实现事件。
  2. 如果所需事件不是自动收集的事件,也没有作为增强型衡量事件的一部分提供,请查找推荐事件进行实现。
  3. 只有在 (1) 和 (2) 都无法满足您的需求时,才实现自定义事件。

针对您的 Universal Analytics 媒体资源中使用的所有事件创建一份清单,看看针对 Google Analytics(分析)4 媒体资源使用自动收集的事件和增强型衡量事件能否满足您的需求。请先重点关注这两种事件,因为它们无需手动编写代码即可进行迁移。

手动实现的事件(即推荐事件和自定义事件)

Google Analytics(分析)4 媒体资源和 Universal Analytics 媒体资源中事件的数据结构有所不同。

  • 在 Universal Analytics 媒体资源中,事件具有“事件类别”、“事件操作”、“事件标签”和“事件值”字段,可以添加自定义维度。
  • 在 Google Analytics(分析)4 媒体资源中,手动实现的事件包含“事件名称”、自动收集的参数和手动指定的参数。这些手动指定的参数会替换 Universal Analytics 媒体资源中的事件字段,并且还能用于指定事件的其他信息。

如果您的 Universal Analytics 媒体资源是通过 gtag.js(格式为“UA-XXXXXXXX”)实现的,并且没有指定具体的“send_to”命令,只要“config”指令中引用了衡量 ID,或者使用了已关联的网站代码,事件就会自动转换为 Google Analytics(分析)4 媒体资源(格式为“G-XXXXXXXX”)中的事件。

转换的工作原理如下:

  • “事件操作”转换为 Google Analytics(分析)4 媒体资源中的事件名称
  • “事件类别”、“事件标签”和“事件值”转换为 Google Analytics(分析)4 媒体资源中的参数。下面详细介绍了参数限制。

例如,通过 gtag.js 实现的 Universal Analytics 媒体资源中的以下事件:

1:gtag('event', <操作>, {

2:'event_category': <类别>,

3:'event_label': <标签>,

4:'value': <值>

5:});

使用以下通用事件签名转换为 Google Analytics(分析)4 媒体资源中的事件:

1:gtag('event', <事件_名称>, {

2:<参数_1>: <参数_1_值>,

3:<parameter_2>: <parameter_2_value>,

4:<parameter_3>: <parameter_3_value>,

5:...

6:});

因此,Universal Analytics 媒体资源中的 <操作> 对应 Google Analytics(分析)4 媒体资源中的 <事件_名称>。“event_category”、“event_label”、“value”及各自的值对应相应参数及各自的值。

手动实现事件的命名惯例

如果您使用的“事件名称”值既不属于自动收集的事件名称,也不属于增强型衡量事件名称,该事件就会被计为手动收集的事件。

您最多可以使用 500 个不同的“事件名称”。 请尽量使用建议的事件名称,以充分利用 Google Analytics(分析)4 媒体资源中的报告功能和未来推出的功能。

事件参数

除了通过自动收集的参数发送的内容以外,如果您还想随事件发送其他信息,可以使用参数。您收集的所有参数都可用于受众群体定义,也可在 BigQuery 中使用。

参数行为

一个参数可以包含任意数量的唯一值。不过,在设置 Google Analytics(分析)4 媒体资源并同时保留 Universal Analytics 媒体资源时,您需要考虑以下重要限制和行为

  • 每个事件最多可发送 25 个自定义参数,每个参数值可以有 100 个字符。
  • 每个媒体资源的总限额为 50 个自定义文字参数和 50 个数字参数。

示例

您要衡量网站上视频下载链接获得的点击次数。Universal Analytics 媒体资源中的代码结构可能如下所示:

  • 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”参数。

如果您的事件结构与上例类似

  1. 开始收集数据。在 BigQuery 中查看事件数据。
  2. 查看自动收集的事件和增强型衡量事件已经涵盖了哪些现有事件。添加一个“send_to”命令,以便将这些事件发送到 Universal Analytics 媒体资源实现,而不发送到 Google Analytics(分析)4 媒体资源实现。
  3. 尽量实现推荐事件。

自定义维度和指标

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

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

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

 

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