文档目录
Flow 规则和条件字段
更新于 2026年11月17日
Flow 按优先级判断已启用的规则,把点击送到一条路径或一个安全页。内置字段是 15 个访客属性加上 token1–token10。流量源参数是额外字段。没有条件的已启用规则不会命中。
路径
每条路径有名称、weight 或 smart 轮换,以及落地页和 Offer 列表。每一项是 id 和大于 0 的权重。恰好一条路径是默认路径。如果一条都没标,第一条成为默认。没有规则命中时,点击走默认路径。
权重轮换按权重选落地页和 Offer。智能轮换加上活动的 bind_visitor,会优先选这个访客还没看过的落地页或 Offer。Offer 上限按排序跳过已满的 Offer。Offer 上存有 cap_fallback,编辑器只提供 next_offer。路由并不读取 cap_fallback;路径上没有可用 Offer 时以 404 结束。
规则指向一条路径,或一个必须为 http 或 https 的安全页。规则按优先级从小到大检查。同一个 Flow 里优先级不能重复。整个 Flow 以一份文档保存(GET 或 PUT /api/flows/{id}/doc)。模拟器跑的是已保存的文档。
条件字段
条件是模式 and(默认)或 or,以及一组 { field, op, values }。下面是已启用规则允许的运算符。官网说的「25 个字段」是下面 15 个名字加上 token1 到 token10。
| 字段 | 已启用规则可用的运算符 |
|---|---|
| country, device, language | in, not_in, eq |
| os, browser | in, not_in, eq, contains, not_contains, regex |
| region, city, isp | in, not_in, eq, contains, not_contains, regex |
| ip | in, not_in, eq, contains, not_contains, regex |
| referrer, user_agent | contains, not_contains, regex, in, not_in, eq |
| hour | between, in, not_in, gt, lt, eq |
| weekday | in, not_in, between, eq, gt, lt |
| is_bot, is_unique | is, eq, in |
| token1–token10,以及流量源上声明的参数 | in, not_in, contains, not_contains, eq, regex, gt, lt |
zone 始终可以作为流量源参数。其他参数名遵循编辑器的格式:一个字母,后面最多 39 个字母、数字或下划线。
取值
国家是两位字母。语言是两位或三位字母。设备是 mobile、tablet、desktop、bot 或 unknown(空的 User-Agent)。小时是 0–23;运算符为 between 时用 HH:MM。星期是 0–6。between 恰好两个值。regex 恰好一个能编译的表达式。is 要一个 JSON 布尔值,不是字符串 "true"。
已启用的规则至少要有一个条件。运行时,没有条件的规则不命中。整个 Flow 里已启用规则的 regex 条件最多 3 个;超出预算的正则不命中。停用的规则可以先存着不写完,也不会被执行。
in / eq / contains / regex 写了多个值时,任意一个命中即算命中。not_in / not_contains 要全部不命中。缺失的流量源参数按空值处理,所以「不属于」可能命中一次根本没带这个参数的点击。值列表里的空字符串会被忽略。
命中的路径如何变成跳转,见概念。