集成
Google Tag Manager (server-side)
将点击和转化作为 GA4 Measurement Protocol 命中发送到你的服务端 GTM 容器。
Google Tag Manager 集成会将每次记录的 Letlink 点击和每个已批准的转化，作为 GA4 Measurement Protocol 命中发送到你自己的服务端 GTM 容器。事件进入你的 Tagging Server 后，容器中的任何代码都可以处理它——GA4、Google Ads、Meta、数据仓库——因此你只需在 GTM 中配置一次目标，而不必为每个工具分别配置。适用于 Growth 和 Ultimate。
你的需求
- 一个正在运行、拥有独立 HTTPS 地址的服务端容器，例如
https://gtm.example.com。 - 该容器中需要一个 Measurement Protocol 客户端。GTM 默认不会添加。
- 容器转发到的 GA4 网站数据流的衡量 ID（
G-…）。
准备容器
- 在你的服务端容器中打开 Clients → New，选择 Measurement Protocol 客户端类型。
- 将 Activation Path 设为
/mp/collect（或任何你喜欢的路径——你需要在 Letlink 中填写相同路径）并保存。 - 添加或复用一个由该客户端触发的 Google Analytics: GA4 代码，以及其他你希望接收事件的代码，然后 Submit 该容器。
连接到 Letlink
- 打开 集成 → Google Tag Manager（服务端）。仅限所有者和管理员。
- 输入 Tagging Server URL（不含路径）、衡量 ID，以及（如已修改）客户端路径。
- API 密钥为可选项。如果你的 GA4 代码使用 GA4 Measurement Protocol 密钥将命中转发到 Google，请粘贴该密钥。
- 保存并点击 发送测试事件，然后在容器的 预览 模式中查看请求到达。
我们发送的内容
向 <tagging server><path>?measurement_id=G-… 发送 POST 请求，请求体为标准的 GA4 Measurement Protocol 格式。client_id 与控制台使用的设备指纹相同，已知时访问者的国家会放入 user_location。
| Letlink 事件 | GA4 事件 | 额外参数 |
|---|---|---|
| 点击 | link_click |
short_code、link_type、variation、destination_url、UTM 值、click_id |
| 销售 | purchase |
transaction_id（你的订单 ID）、value、currency |
| 潜在客户 | generate_lead |
value、currency（如有发送） |
| 注册 | sign_up |
method = short_link |
| 自定义 | 你的事件名称，按 GA4 规则清理 | value、currency（如有发送） |
每个转化还带有 conversion_id（conv-<id>）及其来源点击的 click_id，便于在 BigQuery 中关联或在代码中去重。
什么都没收到——应该检查什么？
- Tagging Server URL 必须是 HTTPS 且可从互联网访问。
404通常表示没有客户端认领该路径：请检查 Measurement Protocol 客户端的激活路径。 - 预览模式只在打开时显示请求。请先打开预览模式再发送测试事件。
- 转化始终会发送到此集成，即使工作区未将转化转发到广告平台。