文档目录
Velotrak 的转化和回传
更新于 2026年11月17日
联盟调用 /postback/<联盟密钥> 并带上点击 ID。入账状态是 approved、pending、rejected、refunded 和 trash。一次点击只能由它被送到的那个 Offer 所属的联盟入账。
给联盟的地址
每个联盟有一把密钥。没有自定义模板时,后台默认的回传地址是:
https://<默认域名>/postback/<联盟密钥>?cid={click_id}&payout={payout}&txn_id={transaction_id}&status={status}
处理函数接受 GET 和 POST。点击 ID 可以叫 click_id、cid、clickid 或 subid。金额可以叫 payout、amount 或 revenue。交易号可以叫 txn_id、transaction_id 或 order_id。也可以传 goal。省略 goal 时用 Offer 的默认目标,或 sale。
可选签名是请求头 X-Velotrak-Signature:用联盟密钥做 HMAC-SHA256,原文是排序后的 key=value。错误或未知的联盟密钥返回 401。
状态
保存的状态是 approved、pending、rejected、refunded 和 trash。常见别名:sale 变成 approved,lead 变成 pending,reject 和 declined 变成 rejected,chargeback 和 refund 变成 refunded。未知状态按 pending 入账,并标成状态异常。
缺少或非法的点击 ID 不会入账。回传的联盟不是这次点击所用 Offer 的联盟时,返回 403,原因是 network_mismatch,不入账。这包括你为同一家公司建的第二条联盟记录,也包括你改了 Offer 所属联盟之前发生的点击。账本不允许的状态变更返回 200,正文是 ignored。
报表把已批准的金额当作收入,pending 当作待定收入,trash 当作垃圾收入。金额、货币和超额异常可以把一次 approved 回传降为 pending。
浏览器像素
GET 或 POST /track 是 /velotrak.js 使用的地址。它读取 click_id 或 vt_cid cookie。默认 goal 是 lead。像素只插入转化,不修改已有状态。一次点击最多接受 10 次像素转化。
回给流量源
转化入账后,出站队列会调用流量源的回传 URL 模板。投递重试出现在出站日志里,和 CAPI 记录在一起。CAPI 只对没有异常的 approved 转化发送。Meta、TikTok 和 Google 的设置在 CAPI 页。