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

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

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

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

网站配置

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

跟踪代码管理器

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

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

Google Analytics（分析）4

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

注意：如果您之前在要设置的字段中配置了 transport_url 字段，请清除 transport_url 字段。

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_url 和 first_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 文件中将此域名更改为您的服务器容器对应的域名：

注意：如果您使用跟踪代码管理器网站容器中的 Universal Analytics 或 GA4 代码向服务器容器发送数据，且从服务器容器提供该跟踪代码管理器网站容器，则 Universal Analytics 或 GA4 的专用 JavaScript（如 analytics.js）也将从服务器容器加载。

从服务器容器加载跟踪代码管理器网站容器之前，请按照上述说明，在您的“Google Analytics（分析）：GA4”或“Google Analytics（分析）：Universal Analytics”客户端中启用特定 ID 的默认 gtag.js 路径。 这可确保产品的专用脚本能从您的服务器容器正确加载。

客户端配置

为了让服务器容器响应请求以加载 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. 配置触发器并保存代码。

注意：如果您仅想针对 page_view 事件发送某些参数，请取消选中 Google Analytics（分析）4 配置代码中的“在此配置加载时发送网页浏览事件”选项，然后使用 page_view 事件名称创建 Google Analytics（分析）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 命令中添加值为 false 的 send_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. 保存客户端配置并发布容器。