针对 gtag.js 正确安装 Google 代码

重要提示：Google 跟踪代码管理器 (gtm.js) 代码段即将更新，届时将不再识别或等待任何 gtag('config') 命令。如果您的网页使用 GTM 代码段，但依靠 gtag('config') 来传递参数或配置代码，则您必须更新网站代码，以使用正确的 Google 代码 (gtag.js) 代码段。

代码段的初始化方法即将标准化，旨在为所有使用 Google 衡量和广告产品的网站提供一致、可靠且高效的代码植入体验。

本页内容

• 支持和不支持的植入方式
  • 比较植入方式
• 如何更新网站
• 验证更新后的安装

---

支持和不支持的植入方式

目前，部分网站使用 Google 跟踪代码管理器代码段路径 (gtm.js) 部署了前缀并非 Google 跟踪代码管理器的 Google 代码 ID，例如以 G-、AW- 或 DC 开头的代码 ID。这是一种不受支持的植入方式，采用此类植入方式的网站可能会出现代码行为发生意外变化的情况。

比较植入方式

对于采用不受支持植入方式的容器，相关用户已收到邮件通知。请查看以下示例，了解正确植入方式的代码格式。

示例

错误植入方式（不受支持）：请勿将 Google 跟踪代码管理器 (GTM) 代码段容器与针对非 GTM ID 的 gtag('config') 命令搭配使用，例如：

<!-- GTM Snippet with config -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-XXXXXX');</script>
<script>
  gtag('config', 'TAG_ID');
</script>

正确植入方式（受支持）：如果您想使用 gtag('config') 命令部署 Google Ads 或 Google Analytics，请使用标准 Google 代码 (gtag.js) 代码段，例如：

<!-- Google tag (gtag.js) -->

<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>

<script>

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

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

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

  gtag('config', 'TAG_ID');

</script>

注意：将 TAG_ID 替换为您的实际 Google 代码 ID（例如 G-XXXXXX、AW-XXXXXX 或 DC-XXXXX）

---

如何更新网站

若要保留代码配置并确保一致的衡量，请按照以下步骤更新代码部署，以使用 Google 代码 (gtag.js) 代码段：

1. 打开您使用的 Google 产品（例如 Google Ads 或 Google Analytics），然后复制您的 Google 代码 ID。
   • 在 Google Ads 中：
     1. 在 Google Ads 中打开 Google 代码设置。
     2. 登录您的 Google 账号。了解如何创建 Google 账号。
     3. 前往工具菜单中的数据管理器。
     4. 在“Google 代码”下找到相应 Google 代码，然后点击管理。
     5. 在“您的 Google 代码”下，点击图表左侧的 Google 代码。
     6. 在“代码详情”下，复制 Google 代码 ID。
   • 在 Google Analytics 中：
     1. 前往 https://analytics.google.com/analytics/web/。
     2. 登录您的 Google 账号。了解如何创建 Google 账号。
     3. 在管理中，选择“数据收集和修改”下的数据流
     4. 选择要修改的数据流。
     5. 在“Google 代码”下，点击配置代码设置。
     6. 在“您的 Google 代码”下，点击图表左侧的 Google 代码。
     7. 在“代码详情”下，复制 Google 代码 ID。
2. 使用上面“正确植入方式”部分中提供的模板，将 TAG_ID 替换为您复制的 ID。
3. 在网站页面中找到并移除 Google 跟踪代码管理器 (gtm.js) 代码段，以及与其关联的任何独立 gtag('config') 命令。
4. 将正确的 Google 代码 (gtag.js) 代码段粘贴到您网站的每个页面中，紧跟在起始 <head> 标记之后。

如果您使用 Google 跟踪代码管理器来管理其他第三方代码或自定义配置，则应将主 Google 跟踪代码管理器代码段保留在网站上，并在 gtm.js 代码段中，将现有的 G-、AW- 或 DC- ID 替换为您的 GTM-XXXXXX ID。确保您的 Google 代码已在 Google 跟踪代码管理器中部署，并在 GTM 界面中应用所有必要的配置。

---

验证更新后的安装

更新网站代码后，请验证新的 Google 代码是否在正确发送数据：

使用 Tag Assistant 进行验证

1. 前往 Google Tag Assistant。
2. 点击添加域名。
3. 输入您的网站网址，然后点击连接。
4. 检查找到的 Google 代码标题，确认是否显示了正确的代码 ID，且该 ID 带有绿色或蓝色状态图标。

使用 Chrome 开发者工具进行验证

1. 在 Google Chrome 中打开您的网站。
2. 依次选择查看 > 开发者 > 开发者工具，打开 Chrome 开发者工具。
3. 打开网络标签页，然后刷新页面。
4. 检查请求是否发送到 googletagmanager.com/gtag/js，而不是 /gtm.js。对于 Google Ads，请验证请求是否发送到 googleadservices.com；对于 Google Analytics，请验证请求是否发送到 analytics.google.com。

---

相关链接

• 在各个 Google 账号中设置 Google 代码
• 使用 gtag.js 设置 Google 代码（开发者指南）
• 使用 Tag Assistant 排查 Google 代码问题