接入文档

1. 快速开始

1. 注册账号，注册即送 100 免费安装量。
2. 在客户后台「App 管理」中添加你的 App（包网 URL 或上传 zip 包）。
3. 在「像素配置」中添加 Facebook / TikTok 的 Pixel Code 与 Access Token。
4. 在「域名配置」中绑定你的推广域名（CNAME 至我们提供的目标）。
5. 在「推广链接」中创建带 link_id 的短链，即可开始投放。

2. 事件上报 API

前端 SDK 会自动上报访问和安装事件。也支持通过 HTTP 手动上报：

POST /api/report/event
Content-Type: application/json

{
  "link_id": "abc12345",
  "event_name": "install",     // visit | install | purchase
  "extra": { "device_id": "..." }
}

Response:
{ "success": true }

3. 链接信息查询

GET /api/link/info?link_id=abc12345

Response:
{
  "link": { "link_id": "abc12345", "channel": "facebook", ... },
  "app":  { "name": "MyApp", "url": "https://...", ... },
  "pixel": { "channel": "facebook", "pixel_code": "...", ... }
}

4. 归因回传原理

当用户点击广告 → 落地页时携带 link_id， 系统记录 visit 事件；用户安装 App 并完成注册/购买时，SDK 上报 install / purchase 事件， 系统自动区分渠道并回传给 Facebook CAPI、TikTok Events API。

5. 流量去重规则

• 同一设备指纹 24 小时内重复访问只计一次
• 相同 IP + UserAgent 组合 1 小时内重复访问归为一次会话
• 已安装用户识别后直接跳转 App，不再消耗新安装额度