转化 API
从我们的服务器而非浏览器，向 Meta、LinkedIn、TikTok 和 Google Ads 报告目标达成情况，仅通过广告网络自身设置的点击标识符进行匹配。
1. 为什么采用服务器端？
浏览器像素要成功报告一次转化，必须越过三道障碍：广告拦截器、跟踪防护设置，以及访客在像素触发前关闭标签页。服务器端调用能避开这三者，因为它根本不在浏览器中发生。
MousePlayer 已经知道您的目标何时达成，这正是目标的用途。转化 API 只是从我们的服务器将这一事实转发给广告网络。
这不能替代像素。 请保留像素。每个广告网络都会对两者去重，我们会发送去重所需的标识符。
2. 发送什么，绝不发送什么
在这些调用中，唯一用于识别访客的是 广告网络自身设置的 Cookie 或点击标识符。与个人有关的其他信息均不会离开我们的服务器。
| 广告网络 | 使用的标识符 | 来源 |
|---|---|---|
| Meta | _fbp、 _fbc | Meta 像素设置的第一方 Cookie |
li_fat_id | LinkedIn Insight Tag 设置的第一方 Cookie | |
| TikTok | _ttp、 ttclid | _ttp 是 Cookie， ttclid 来自广告点击 URL |
| Google Ads | gclid、 wbraid、 gbraid | 来自广告点击 URL，或之后的 _gcl_aw Cookie |
| Microsoft Advertising | msclkid | 来自广告点击 URL，或 UET 标签写入的 _uetmsclkid Cookie |
绝不发送： 电子邮箱地址、电话号码、姓名或 IP 地址，即使经过哈希处理也不发送。如果访客没有点击标识符，完全不发送任何内容。无法归属的转化对您而言，不如准确计数有价值。
仅在同意后
每次调用都受与录制本身相同的同意关卡控制。没有同意的会话不会产生转化报告，无论项目设置中的开关如何。
3. Google Ads 有三个标识符，而非一个
这一点常令人意外，值得明确说明。Google 使用 gclid 表示单次广告点击。当 Apple 跟踪防护使单次点击无法归因时，Google 改为发送 wbraid 或 gbraid ，它们代表一组点击。
三者互斥：携带其中两个标识符的转化会被 Google 拒绝。我们只发送一个；当多个标识符同时存在时， gclid 优先，因为它最精确。
它们只在 URL 中出现一次
标识符仅出现在广告点击后的 第一个 页面地址中。随后 Google 标签将其存入 _gcl_aw Cookie。我们会读取 Cookie 作为后备，否则访问到第三个页面时发生的转化，将完全找不到标识符。
4. 配置
Meta、LinkedIn 和 TikTok
各需两个字段：像素或转化规则 ID，以及在广告网络自身界面创建的访问令牌。两者均以 AES-256-GCM 加密存储，保存后不再显示。
Google Ads 需要六个字段
Google 是例外，开始前值得了解原因：与其他三者不同，Google 不提供简单的访问令牌。访问通过带刷新令牌的 OAuth 进行，Ads API 还要求 开发者令牌。
| 字段 | 获取位置 |
|---|---|
| 客户 ID | Google Ads 右上角。仅保留数字，不含短横线。 |
| 转化操作 ID | 前往目标与转化，选择要记入的操作。 |
| 开发者令牌 | Google Ads 经理账户的 API 中心。 |
| OAuth 客户端 ID 与密钥 | Google Cloud 控制台，凭据，类型为“桌面应用”的 OAuth 客户端。 |
| 刷新令牌 | 自行针对以下范围生成一次： adwords。 |
LinkedIn 有两条路径，请选择较短的那条
在 Campaign Manager 中： 数据、信号管理器、Direct API、生成访问令牌。这是广告主发送自身数据的路径，无需开发者应用，也无需审核。令牌不会过期，Campaign Manager 不会再次显示，请立即复制。
另一条路径是通过 LinkedIn Developer Portal 申请开发者应用，用于代表多个广告主发送数据的平台。它需要公司主页验证和获批的使用场景，此处均不需要。
Microsoft Advertising 最简单
配置完 Google Ads 后，可能以为这里也同样繁重：OAuth、开发者令牌、审批步骤。实际正相反：只需两个字段。一个是浏览器中已使用的 UET 标签 ID，另一个是从 Microsoft Advertising 的 UET 标签下“使用转化 API”“复制令牌”处复制的令牌。无需申请。
请使用与浏览器标签 相同的 标签 ID。这使 Microsoft 能将服务器端事件与浏览器事件识别为一次转化，而非两次。
开发者令牌需要 Google 批准 （“基本访问权限”），通常需要几天。这是唯一无法在一分钟内完成的步骤，因此应优先开始。我们永远看不到 Google 密码，只接触刷新令牌，您可随时撤销它。
5. 何时报告转化
每个目标、每次会话恰好一次。MousePlayer 在调用发出前去重，载荷还携带 ID，使广告网络可在其端再次去重。访客向购物篮添加五件商品，产生的是一次转化，而非五次。
广告账户中会看到什么
转化携带目标名称、发生时间，以及设置后相应的价值与货币。正常运行时会在一分钟内到达。
未收到转化时
- 没有点击标识符。 访客并非经该广告网络的广告到达，或到达时像素尚未设置 Cookie。不会发送任何内容，这是预期行为，不是错误。
- 没有同意。 同意关卡优先。
- 广告网络接受了调用，但拒绝了转化。 Google、TikTok 等多家提供商会返回 HTTP 200，却在响应正文内附带错误。我们读取正文，而非只看状态；原因会显示在投递日志中。
此处提及的所有商标均属于各自所有者。MousePlayer 与这些提供商不存在商业关系。