注意:此开发者网站正在向 developers.google.com/tag-platform 迁移,2021 年 9 月 30 日起将会进行重定向

将数据发送到服务器端 Google 跟踪代码管理器

本文介绍了向服务器端容器发送事件的不同方法。如果您尚未完成初始服务器端代码植入设置,请先执行此操作,然后再开始执行本文中的步骤。

本文将介绍如何执行以下操作:

  • 将数据从网站发送到服务器端容器
  • 在服务器端容器中接收数据
  • 从第一方端点中加载 Google Analytics(分析)脚本
  • 使用 Google Analytics(分析)4 代码向服务器容器发送其他数据
  • 从网站以外的来源发送数据

网站配置

您可以使用跟踪代码管理器或全局网站代码 (gtag.js),通过服务器端实现来以路由方式发送数据。

跟踪代码管理器

通过设置传输网址这一设置,您可以将支持的代码配置为通过服务器端配置以路由方式发送数据。传输网址指定了您的第一方网域端点。

要设置代码以进行服务器端处理,请添加您的传输网址:

Google Analytics(分析)4

  1. 在网站容器中,添加 GA4 配置代码,或修改现有代码。
  2. 选中发送到服务器容器复选框。
  3. 在相应的文本字段中输入服务器容器网址
  4. 保存代码,并将触发器配置为可通过所有网页触发器触发。
  5. 发布容器。

Universal Analytics

  1. 在网站容器中,添加一个具有 Google Analytics(分析)设置变量Universal Analytics 代码,或者使用现有的 Universal Analytics 配置。
  2. 依次转到更多设置 > 高级配置
  3. 选中设置传输网址复选框。
  4. 传输网址字段中添加您的服务器容器网址(例如 https://<DOMAIN_NAME>,其中 DOMAIN_NAME 是您的服务器容器域名)。
  5. 保存代码,并将触发器配置为在所有网页上触发。
  6. 发布容器。

全局网站代码 (gtag.js)

如果您是在网站上使用 gtag.js,请更新 Universal Analytics 或 Google Analytics(分析)4 config 命令,以便将事件发送到服务器容器。

对于 GA4 代码和 UA 代码,请将 transport_urlfirst_party_collection 参数添加到您的现有代码中:

gtag('config', 'G-XXXXXX', {
  transport_url: 'https://analytics.example.com',
  first_party_collection: true
});

G-XXXXXX 替换为您的 Google Analytics(分析)4 或 Universal Analytics ID。将 https://analytics.example.com 替换为您的服务器容器网址。

服务器端客户端配置

设置传输网址后,系统会将数据发送到您的跟踪代码管理器服务器端容器中的客户端。默认情况下,GA4 客户端和 UA 客户端会预安装在服务器端容器上。

在跟踪代码管理器服务器容器中,点击左侧导航栏中的客户端可查看客户端列表。点击客户端名称即可查看或修改详细信息。在大多数情况下,无需对客户端进行任何修改。但在某些情况下,可能需要对某些设置进行修改:

  • 优先级:决定客户端的运行顺序。优先级较高的客户端先运行,与传入请求相匹配的第一个客户端将成为该请求的活跃客户端。

  • 激活条件:激活条件定义客户端何时响应请求:

    • 默认 Universal Analytics 路径:如果请求路径包括 /collect/r/collect 以及将数据发送到 Google Analytics(分析)的 JavaScript 文件所用的其他类似路径,客户端将会启动。此设置默认处于启用状态。

    • 特定 ID 的默认 gtag.js 路径:使用此设置即可通过您的服务器容器网址启用 gtag.js JavaScript 内容服务。启用之后,此客户端将会启动,以响应针对默认 gtag.js 请求路径(如 /gtag/js?id=G-XXXXXX)的请求。点击添加衡量 ID 即可添加一个或多个 Google Analytics(分析)衡量 ID。

加载 Google 脚本

为了充分发挥服务器端代码植入的所有优势,您可以选择通过服务器容器来加载支持的脚本。这样可减少对第三方网域的依赖。

更新 gtag.js 来源网域

植入 gtag.js 时,默认配置会从 www.googletagmanager.com 加载 Google Analytics(分析)库。要通过服务器容器加载 Google Analytics(分析)代码,请将此域名更改为您的服务器容器对应的域名:

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

  gtag('config', '<G-XXXXXX>');
</script>

客户端配置

为了让服务器容器响应请求以加载 Google Analytics(分析)脚本,您需要对客户端稍作修改:

  1. 在服务器端容器中,点击客户端以查看客户端列表。
  2. 点击要修改的客户端的名称。
  3. 选择特定 ID 的默认 gtag.js 路径
  4. 点击添加衡量 ID 并输入您的 ID。
  5. 保存客户端配置并发布容器。

更新 gtm.js 来源网域

在网站上植入 gtm.js 时,默认配置会从 www.googletagmanager.com 加载 Google 跟踪代码管理器库。要通过服务器容器加载 GTM 代码,请在 gtm.js 脚本和 ns.html 文件中将此域名更改为您的服务器容器对应的域名:

用于插入 gtm.js 和 ns.html 的 Google 跟踪代码管理器代码段屏幕截图

客户端配置

为了让服务器容器响应请求以加载 Google 跟踪代码管理器脚本,您需要添加 Google 跟踪代码管理器:网站容器客户端并对配置进行更改:

  1. 在服务器端容器中,点击客户端以查看客户端列表。
  2. 点击客户端部分的新建
  3. 点击客户端配置部分,以选择客户端类型。
  4. 从可用客户端列表中选择 Google 跟踪代码管理器:网站容器
  5. 点击添加容器 ID 并输入您的 GTM 网站容器 ID。此 ID 必须与您在上方所示的 HTML 代码段中使用的 ID 一致。
  6. 保存客户端配置并发布容器。

添加其他代码的其他数据

您可能已经在网页上添加了多个用于向服务器发送类似数据的代码。我们建议您不要使用单独的代码,而应使用 Google Analytics(分析)4 代码通过跟踪代码管理器或 gtag.js,以路由方式将这些数据发送到服务器容器中。您可以在代码中指定其他事件参数,然后使用服务器端容器中的变量来提取参数。这样一来,您就可以减少页面上的 JavaScript 数量,并尽可能地减少 HTTP 请求数量,这两种方式均可提高您网站的性能。

跟踪代码管理器

如有参数需要针对所有事件进行发送,例如唯一标识符,请将其添加到 Google Analytics(分析)4 配置代码中的“要设置的字段”:

  1. 在网站容器中,添加 Google Analytics(分析)4 配置代码,或修改现有的代码。
  2. 依次点击要设置的字段 > 添加行
  3. 将您希望在每个事件中显示的参数添加到参数名称/值表中。
  4. 将触发器配置为在“所有网页”上触发,然后保存代码。

如有参数需要针对某些事件进行发送,请将这些参数添加到 Google Analytics(分析)4 事件代码中的“事件参数”部分。

  1. 在网站容器中,添加 Google Analytics(分析)4 事件代码,或修改现有的代码。
  2. 依次点击事件参数 > 添加行
  3. 将参数添加到参数名称/值表中。
  4. 配置触发器并保存代码。

gtag.js

借助 gtag.js API,您可以指定其他参数,具体做法是将其添加为命令参数。如需了解详情,请参阅 gtag.js API 参考文档

要配置需要针对所有事件发送的参数,请执行以下操作:

gtag('config', '<G-XXXXXX>', {
  'transport_url': 'https://analytics.example.com'
  'custom_parameter': 'value',
});

要配置需要针对某些事件发送的参数,请执行以下操作:

gtag('event', 'event_name', {
  'custom_parameter': 'value',
});

要将参数配置为仅针对 page_view 事件发送,请在 config 命令中添加值为 falsesend_page_view 参数,然后添加单独的 page_view 事件。

gtag('config', 'G-XXXXXX', {
  'transport_url': 'https://analytics.example.com'
  'send_page_view': false,
});
gtag('event', 'page_view', {
  'custom_parameter': 'value',
});

在服务器端 Google 跟踪代码管理器中接收其他数据

在服务器容器中,Google Analytics(分析)4 客户端会解析其他参数,并在事件数据中设置这些参数。要在其他代码中使用这些数据,我们建议您创建一个事件数据变量,并在“键路径”中指定参数名称。现在,您可以在需要此参数的任何代码中使用此变量。

从其他来源发送数据

Google Analytics(分析)Measurement Protocol 可用于从移动应用和“服务器到服务器”应用等来源启用服务器端代码植入支持。

移动应用

为了让您的 Android 或 iOS 应用将数据发送到服务器容器,您需要创建一个自定义图片代码,并将其配置为使用 Measurement Protocol:

  1. 在移动容器(Android 或 iOS)中,依次点击代码 > 新建
  2. 代码配置中,选择自定义图片代码类型。
  3. 图片网址的值设置为服务器容器(位于您之前指定的 Measurement Protocol 客户端中的路径中)上的像素图片。将任何所需的 Measurement Protocol 参数附加到像素网址末尾:
    https://custom.example.com/app?v=1&tid=G-XXXXXX&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
  4. 取消选择启用缓存无效化
  5. 保存代码并发布容器。
  6. 在服务器端容器中,依次点击客户端 > 新建
  7. 客户端配置中,选择 Measurement Protocol 客户端类型。
  8. 激活路径设置为应用收集端点的路径。
  9. 保存客户端配置并发布服务器端容器。

“服务器到服务器”应用

要将 Measurement Protocol 数据发送到您的服务器容器,请将 www.google-analytics.com 主机名替换为您的服务器容器的域名。例如:

POST /batch HTTP/1.1
Host: collection.example.com

v=1&tid=G-XXXXXX&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home

要接收 Measurement Protocol 命中,请通过 Measurement Protocol 客户端配置您的服务器端 Google 跟踪代码管理器安装:

  1. 在服务器端容器中,依次点击客户端 > 新建
  2. 客户端配置中,选择 Measurement Protocol 客户端类型。
  3. 激活路径设置为服务器端点的路径。
  4. 保存客户端配置并发布容器。