文档目录
活动、流量源、Offer 和 Flow
更新于 2026年11月17日
活动把流量源、域名和 Flow 绑在一起。公开链接是 /click/<活动 id>。Flow 先选路径,再选落地页或 Offer,点击 ID 会跟着访客直到联盟回传。
这些对象
流量源是点击的来源。它保存参数模板(平台、点击 ID 参数名、可选的成本和版位参数,以及其他参数)以及转化入账后使用的回传 URL 模板。状态是 active、paused 或 draft。
联盟是付款给你的一方。它有名称、回传 URL 模板、联盟密钥、货币和状态。创建时密钥留空会自动生成。手填的密钥必须是 32–128 位,只含字母、数字、_ 和 -。在联盟页或用 MCP 工具 rotate_network_key 轮换。旧回传地址会立刻失效。
Offer 属于一个联盟。URL 模板必须是 http 或 https,并且包含 {click_id}。付款类型是 fixed、percent 或 from_postback。可以设置每日上限。状态是 active、paused 或 draft。
落地页是 hosted(本机文件)或 external(http 或 https 地址)。见落地页。
Flow 是一组路径和规则。路径里是带权重的落地页和 Offer。规则把访客送到某条路径或一个安全页 URL。见分流规则。
活动把一个流量源、一个域名和一个 Flow 连在一起。它有成本模型(cpc、cpm、cpa、manual 或 auto)、时区和跳转类型(302、meta、double_meta 或 js)。bind_visitor 给智能轮换用来避免重复同一个落地页或 Offer。只有状态为 active 的活动在点击快照里。暂停或草稿活动返回 404 campaign not found。
域名是你登记的主机名,带 SSL 状态和证书模式。其中一个可以是默认域名。
一次点击做什么
后台拼出的追踪链接是 https://<域名>/click/<活动 uuid>,再加上流量源模板里的查询参数。处理函数是 GET /click/{campaignID}。
服务器生成 UUIDv7 点击 ID,设置 vt_vid(访客,365 天)和 vt_cid(这次点击,24 小时),并保存流量源的外部点击 ID、版位、token1–token10,以及出现时的 fbclid、gclid、ttclid、msclkid。然后执行 Flow 判定。托管落地页跳到 /lp/<落地页 id>/。外部落地页或直达 Offer 跳到展开后的 URL。Offer URL 里的 {click_id} 就是这次点击。
落地页到 Offer 的链接是 GET /go,使用 cid、click_id 或 vt_cid cookie。活动的跳转类型同时用于点击和 /go。
快照还没加载时,点击返回 503。Flow 缺失或已暂停时返回 404。所选路径上的落地页和 Offer 全部暂停时返回 404,没有备用路径。Offer 每日上限会跳过已满的 Offer;路径上全部满额时,点击同样是 404。
暂停的流量源本身不会单独删掉活动,但暂停的流量源不在点击用来读取流量源字段的活动快照里。转化是另一次请求:联盟调用你的回传地址。