文档
追踪、优化、不再为退款赔钱——你需要的全在这。
快速上手
Converge 追踪点击与转化，并通过服务端 CAPI 双发到 Meta 和 TikTok——找回浏览器像素漏掉的 15-30% 转化。
- 注册(免费,无需卡)→拿到工作台
- 创建活动并添加 offer
- 接入流量源，获取追踪链接
- 填入 Meta/TikTok CAPI token(见下)
- 投放流量——转化自动回传 CAPI
CAPI 和退款回写免费套餐就有，无附加费。
追踪配置
把流量源指向 Converge 点击 URL。Converge 跳转到你的 offer 并记录点击。
https://your-domain/click.php?campaign={campaign_id}&source={source}&sub1={sub1}转化时，你的联盟网络回传 postback 到：
https://your-domain/postback.php?click_id={click_id}&payout={payout}&txid={txid}Meta CAPI -- 15参数
不同于 RedTrack(5参)或 BeMob(3参)，Converge 回传全部 15 个 Meta 高级匹配参数——SHA-256 哈希保护隐私：
em, ph, fn, ln, db, ge, ct, st, zp, country,
external_id, client_ip_address, client_user_agent, fbc, fbp配置
- Meta 事件管理器 → 设置 → 生成 Conversions API token
- Converge → 活动 → Meta CAPI → 填 Pixel ID + token
- event_id 与浏览器 Pixel 共享，24h 去重
更高 EMQ = 更低 CPA。全 15 参通常比 5 参追踪器提升 EMQ 2-4 分。
TikTok CAPI
同样的双发模型。服务端事件回传 TikTok Events API，event_id 与浏览器 Pixel 去重。
- TikTok 事件管理器 → 生成 Access Token
- Converge → 活动 → TikTok CAPI → 填 Pixel Code + token
退款回写
客户退款时，回传负值事件冲抵原转化。广告算法停止向退款人群优化。没有其他主流追踪器自动做这个。
POST /api-refund-conversion.php
{
"conversion_id": 12345,
"amount": 49.00,
"reason": "customer_refund",
"type": "refund"
}这会生成退款调整记录，并自动把负值事件回写到 Meta/TikTok CAPI。
Postback / S2S
入站：联盟网络 → Converge。出站：Converge → 流量源 + CAPI。
# 来自网络的入站转化
GET /postback.php?click_id={ldelim}click_id{rdelim}&payout={ldelim}payout{rdelim}&txid={ldelim}txid{rdelim}流量源 postback 始终发送(核心追踪)。CAPI 在免费档受套餐限额约束。
API 参考
会话认证的 JSON 端点。响应使用信封格式 {ok, data, error}.
| 方法 | Endpoint | 说明 | 参数 |
|---|---|---|---|
| GET | /api/live-stats.php |
仪表盘实时统计 | — |
| GET | /api/attention/roi-alerts.php |
亏损广告告警 | — |
| POST | /api/bot-mode.php |
Bot检测模式切换 | mode=shadow|block|off |
支付 webhook(/api-billing-webhook.php)经签名验证(Stripe HMAC-SHA256 / Cryptomus md5)——仅入站，不供手动调用。
自托管
Converge 运行于 PHP 8.2+ / MySQL 8。部署到自己的服务器实现完全数据自有——无按事件收费，无限量。
git clone <repo> && cd converge
composer install
# 配置 config/config.php (DB + APP_KEY)
# web 根指向 /public详见 saas-deployment.md 了解生产部署(Nginx + PHP-FPM + MySQL)。
有疑问？ hello@converge.io · ← 返回首页