接入文档

1. 快速开始

1. 注册账号，注册即送 100 免费安装量。
2. 在客户后台「App 管理」中选择包网或打包接入，并填写你的应用配置。
3. 在「像素配置」中按平台要求添加 Meta、TikTok、KWAI、MgskyAds 或 PropellerAds 的配置。
4. 在「域名配置」中添加投放或启动域名；DNS 配置由你在域名服务商处完成，再运行健康检查确认 HTTPS 可用。
5. 在「推广链接」中关联 App、域名与像素，创建专用测试链接。

2. 事件上报 API

落地页访问会记录到链接数据。安装和业务事件需要由你的 App Shell 或服务端通过 HTTP 上报：

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

{
  "link_id": "abc12345",
  "event_name": "install",     // install | register | purchase | 自定义事件
  "event_id": "optional-idempotency-key",
  "value": 12.5,
  "currency": "USD",
  "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. 归因回传原理

当用户从推广链接进入落地页时，系统记录访问数据；你的应用或后端在安装、注册或购买完成后上报事件。 系统依据链接关联的像素配置及其触发事件，尝试向对应平台进行服务端回传。实际是否被广告平台接收，取决于该平台账号、凭据和事件规则。

5. 流量去重规则

• 安装额度只在有效且未重复的 install 事件处理成功时扣减
• 系统结合 client_id 与 IP、User-Agent 等信息识别重复安装
• 是否判为已安装以落地页与 App 上报链路的实际数据为准，测试时请使用真实设备验证