跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

目标定位规则

最后更新 查看 MarkdownAgent 设置

目标定位规则让您可以根据用户属性为不同用户提供不同的标志值。每个标志可以有零个或多个规则。

规则从上到下按顺序进行评估。系统将使用条件匹配的第一条规则,并返回其配置的变体。如果没有规则匹配,Flagship 会返回该标志的默认变体。

当标志被禁用时,无论规则如何,始终返回默认变体。

请将更具体的规则放在更宽泛的规则之前。宽泛的包罗万象规则 (catch-all rule) 可以阻止后续规则的运行。

规则如何工作

规则包含:

  • Conditions(条件) — 必须满足的一个或多个属性比较。例如,country equals "US" 或 plan in ["enterprise", "business"]。
  • Serve variant(提供变体) — 规则匹配时要返回的变体。
  • Rollout(部署)(可选)— 基于百分比的逐步发布。只有指定百分比的匹配用户接收规则的变体。其余用户继续进入下一条规则。

条件结构

每个条件都使用运算符将评估上下文中的属性与一个值进行比较:

  • Attribute(属性) — 要评估的上下文键(例如,userId、country、plan)。
  • 运算符 — 要执行的比较。Flagship 支持13 种运算符。
  • Value(值) — 用于比较的值。根据运算符的不同,它可以是字符串、数字或数组。

如果评估上下文不包含条件引用的属性,则该条件不匹配。

以下规则会匹配带有 beta 标签的企业配置文件:

{
    "conditions": [
        {
            "attribute": "profile.plan",
            "operator": "equals",
            "value": "enterprise"
        },
        { "attribute": "tags", "operator": "has", "value": "beta" }
    ],
    "serve_variation": "on"
}

以点分隔的属性会遍历嵌套上下文对象。路径最多可包含五个片段。

顶层的字面键优先于路径遍历。例如,如果两种形式都存在,"profile.plan" 会使用该顶层键。

逻辑分组

规则内的条件可以使用 AND/OR 运算符进行分组,最多可以嵌套五层。

条件分组深度与上下文值嵌套深度相互独立,也与五段式属性路径限制相互独立。

例如,要定位美国或加拿大的企业用户:

  • AND:
    • plan equals "enterprise"
    • OR:
      • country equals "US"
      • country equals "CA"

使用最少的必要上下文属性集来表达规则。这使得规则行为更容易推理,并避免在评估上下文中发送不必要的用户数据。

了解更多

这篇文档对您有帮助吗?