文档目录

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 要全部不命中。缺失的流量源参数按空值处理,所以「不属于」可能命中一次根本没带这个参数的点击。值列表里的空字符串会被忽略。

命中的路径如何变成跳转,见概念。