gtag.js 开发者指南

全局网站代码 (gtag.js) 是一种标记框架兼 API,通过它,您可以将事件数据发送至 AdWords、Google Analytics(分析)和 DoubleClick。如果您使用 gtag.js,将可以在最新的跟踪功能和集成服务推出时更轻松地从中获益,且无需管理适用于不同产品的多个代码。

借助 gtag.js,您可以通过将代码添加到自己的网站,轻松向多种 Google 产品发送数据,无需创建其他帐号或在单独的界面中管理配置。

Google 跟踪代码管理器是一款功能强大且齐全的跟踪代码管理系统,支持所有 Google 代码和第三方代码。您可以通过跟踪代码管理器界面添加和修改代码,而无需在您的网站上调整代码。如需了解详情,请参阅跟踪代码管理器开发者指南

如果您使用的是 Google 跟踪代码管理器,则应继续使用它,而不是向您的网站添加 gtag.js 代码。不过,gtag.js 和 Google 跟踪代码管理器可以共存,且在部署到同一网页后均可以正常工作。

关于本指南

本指南会帮助您开始在适用于 AdWords、DoubleClick 和 Google Analytics(分析)的常见用例中使用 gtag.js。具体而言,本指南阐述了以下内容:

  • 适用于 AdWords、DoubleClick 和 Google Analytics(分析)的基本配置
  • 如何发送事件数据

不过,如何使用 gtag.js 在很大程度上将取决于您所使用的产品以及需要收集的具体数据。要了解专门针对具体产品的文档和用例,请参阅:

使用 gtag.js 的大致步骤

无论您要将数据发送至 AdWords、DoubleClick 还是 Google Analytics(分析),使用 gtag.js 的基本模式均如下所示:

  1. 将全局代码段添加到您网站上的每个网页,并对其进行配置,使其可以与 Google Analytics(分析)、AdWords 和/或 DoubleClick 配合使用。请阅读下文中的添加全局代码段
  2. 使用 gtag() 命令捕获事件,并将数据发送至一种或多种产品(例如 Google Analytics(分析)、AdWords 和 DoubleClick)。请阅读下文中的使用 gtag() 命令配置和发送数据

添加全局代码段

全局代码段必须显示在您网站上每个网页的顶部。只有当全局代码段显示在网页顶部、gtag() 命令之前时,gtag() 命令才会发送数据。

如果您只需向一种产品发送数据,请遵循相应产品(Google Analytics(分析)AdWordsDoubleClick)的指南。 要创建您自己的代码段,请从下方选择相应标签,复制代码段,并将其粘贴到您的网站的每个网页上,紧跟在 <head> 标记之后。每个网页只需要一个全局代码段。

如果您要向多种产品发送数据,请阅读下文中的向全局代码段中添加其他产品或帐号

Google Analytics(分析)

<!-- Global site tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GA_TRACKING_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments)};
  gtag('js', new Date());

  gtag('config', 'GA_TRACKING_ID');
</script>

要查找您的 GA_TRACKING_ID,请执行以下操作:

  1. 在您的 Google Analytics(分析)帐号中,点击管理
  2. 从“帐号”列的菜单中选择一个帐号。
  3. 从“媒体资源”列的菜单中选择一个媒体资源。
  4. 在“媒体资源”下,点击跟踪信息 > 跟踪代码

您的跟踪 ID 和媒体资源编号显示在页面顶部。

AdWords

<!-- Global site tag (gtag.js) - AdWords -->
<script async src="https://www.googletagmanager.com/gtag/js?id=AW-GOOGLE_CONVERSION_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments)};
  gtag('js', new Date());

  gtag('config', 'AW-GOOGLE_CONVERSION_ID');
</script>

要查找您的 AW-GOOGLE_CONVERSION_ID,请执行以下操作:

  1. 在您的 AdWords 帐号中,转到工具 > 转化 > 转化操作
  2. 名称列选择您要用于 gtag.js 的转化操作的名称。
  3. 在代码框中,找到变量 google_conversion_id 的值。

向全局代码段中添加其他产品或帐号

为某一产品安装 gtag.js 代码段之后,您只需向其中添加额外的 config 命令,即可将它配置为可与其他产品配合使用。

以下是底部添加了 AdWords 帐号的 Google Analytics(分析)全局代码段的示例:

<script async src="https://www.googletagmanager.com/gtag/js?id=UA-12345-6">
</script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments)};
  gtag('js', new Date());

  gtag('config', 'UA-12345-6');
  gtag('config', 'AW-123456789');
</script>

请注意,gtag.js 代码段的第一行包含一个属性为 src 的网址:

<script async src="https://www.googletagmanager.com/gtag/js?id=UA-12345-6">

此行代码会加载 gtag.js 库,并会附加一个跟踪 ID,用作您的全局网站代码的标识符,以便将相应代码与其来源产品相关联。

有关如何向全局代码段添加多个产品和帐号的示例,请参阅 gtag.js 路由指南

使用 gtag() 命令配置和发送数据

您可以在网页上全局代码段之后的任何位置调用 gtag() 命令。 您可以使用的命令有三个:configsetevent

config

使用 config 命令可初始化和配置特定产品帐号的设置。config 命令采用以下格式:

gtag('config', '<target_ID>', {<additional_config_info>});

适用于 Google Analytics(分析)的全局代码段中的类似行会完成以下两项任务:

其中 <target_ID> 是您要向其发送数据的产品-帐号的 ID,而 <additional_config_info> 是用于指定其他配置选项的可选对象。

config 命令的行为可能会因 target_ID 对应的产品而异。例如,使用 AdWords 转化 ID 调用 config 命令时,该命令会发出再营销请求并将点击 ID 复制到第一方 Cookie 中。使用 Google Analytics(分析)媒体资源 ID 调用 config 命令时,该命令会启动 Google Analytics(分析)跟踪器(网页上的后续 event 命令将使用该跟踪器),并自动向指定的 Google Analytics(分析)媒体资源发送网页浏览匹配数据。

您可以通过在可选的 <additional_config_info> 对象中指定参数来调整和扩展 config 行为。例如,添加以下参数可以阻止该命令自动发送 Google Analytics(分析)网页浏览数据:

gtag('config', 'UA-12345-6', {'send_page_view': false});

set

借助 set 命令,您可以设置一个会自动与网页上的每个后续事件相关联的值。例如,如果您网站上的所有交易均使用同一币种,您可以使用 set 命令在您的全局代码段之后指定币种字段。

gtag('set', {'currency': 'USD'});

您可以使用一个 set 命令来设置多个属性:

gtag('set', {
  'country': 'US',
  'currency': 'USD'
});

event

您可以使用 event 命令指定发送事件数据的方式。例如,要发送带有“value”和“currency”参数的“转化”事件,可采用如下命令:

gtag('event', 'conversion', {
  'value': 1.0,
  'currency': 'USD'
});

我们提供了一组推荐事件推荐参数,它们在特定情况下非常有用。例如,“page_view”事件可以将网页浏览匹配数据发送至 Google Analytics(分析)。要了解推荐事件和推荐参数,请参阅事件参考

此外,您也可以使用不同于推荐事件的名称对您自己的事件进行命名。这类事件称为自定义事件。