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

本文介绍了向服务器端容器发送事件的不同方法。如果您需要更多背景信息，请参阅服务器端代码植入的工作原理。

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

  • 将数据从网站发送到服务器端容器
  • 将其他数据发送到服务器容器
  • 在服务器端容器中接收数据
  • 从网站以外的来源发送数据

准备工作

本指南假定您已完成以下操作：

1. 将数据从网站发送到服务器端容器

您可以使用跟踪代码管理器或 Google 代码 (gtag.js)，通过服务器端实现来转送数据。请选择您的实现方式。

请选择您的实现方式。

可选：随每个事件发送其他参数

您可以发送另外两种类型的参数：配置级参数和事件级参数。配置参数会影响您的 Google 代码的行为方式，并且只能在 Google 代码级别进行设置。

事件参数可指定有关事件的其他信息，并且可为所有事件、选定事件或 page_view 事件设置。

请选择您的实现方式。

2. 在服务器端容器中接收数据

当您向服务器容器发送 HTTP 请求时，客户端必须认领该请求。

若要查看可用客户端的列表，请执行以下操作：

  1. 打开 Google 跟踪代码管理器

  2. 打开您的服务器容器。

  3. 在左侧导航栏中，点击客户端。默认情况下，GA4 客户端会预安装在服务器端容器上。如果您需要使用 Universal Analytics，请设置 Google Analytics（分析）：Universal Analytics 客户端。

  4. 点击客户端名称即可查看或修改详细信息。

可选的客户端设置

在大多数情况下，无需对客户端进行任何修改。但是，您的用例可能会有所不同，因此您可能需要修改以下某项设置：

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

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

    • 默认 Universal Analytics 路径（适用于 UA 客户端）：如果请求路径包括 /collect、/r/collect 以及将数据发送到 Google Analytics（分析）的 JavaScript 文件所用的其他类似路径，客户端将会激活。此设置默认处于启用状态。

    • 特定 ID 的默认 gtag.js 路径：使用此设置即可通过您的服务器容器网址启用 gtag.js JavaScript 内容服务。启用之后，此客户端将会激活，以响应针对默认 gtag.js 请求路径（如 /gtag/js?id=TAG_ID）的请求。点击添加衡量 ID 即可添加一个或多个目标账号 ID。

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

如果您要发送其他参数，则需要在服务器容器中设置 Google Analytics（分析）4 客户端，以解析其他参数并从中创建事件数据。

若要在服务器代码中使用其他参数，请执行以下操作：

  1. 在服务器容器中，点击左侧导航栏中的变量。
  2. 新建一个由用户定义的变量。
  3. 在变量配置中，选择变量类型事件数据。
  4. 在键路径中，输入参数的名称。
  5. 为变量命名并保存。

现在，您可以在您的服务器容器内使用任何其他代码中的事件参数了。

3. 可选：从网站以外的来源发送数据

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=TAG_ID&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=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home

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

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

后续步骤

若要在真实的第一方环境中发送数据，您需要从自己的服务器中传送 Google 脚本，例如 Google Analytics（分析）库。

通过我的服务器加载 Google 脚本