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

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

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

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

准备工作

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

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 脚本