gtag.js 开发者指南

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

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

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

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

关于本指南
使用 gtag.js 的大致步骤
添加全局代码段
使用 gtag() 命令配置和发送数据

关于本指南

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

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

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

适用于 Google Analytics（分析）的 gtag.js
适用于 AdWords 转化跟踪和再营销的 gtag.js
AdWords 帮助中心中网站转化跟踪代码的变化和 AdWords 再营销代码的变化

使用 gtag.js 的大致步骤

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

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

添加全局代码段

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

如果您只需向一种产品发送数据，请遵循相应产品（Google Analytics（分析）、AdWords 或 DoubleClick）的指南。要创建您自己的代码段，请从下方选择相应标签，复制代码段，并将其粘贴到您的网站的每个网页上，紧跟在 <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，请执行以下操作：

在您的 Google Analytics（分析）帐号中，点击管理。
从“帐号”列的菜单中选择一个帐号。
从“媒体资源”列的菜单中选择一个媒体资源。
在“媒体资源”下，点击跟踪信息 > 跟踪代码。

您的跟踪 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，请执行以下操作：

在您的 AdWords 帐号中，转到工具 > 转化 > 转化操作。
从名称列选择您要用于 gtag.js 的转化操作的名称。
在代码框中，找到变量 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() 命令。您可以使用的命令有三个：config、set 和 event。

`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（分析）。要了解推荐事件和推荐参数，请参阅事件参考。

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