强制决策方法
强制决策方法
介绍强制决策方法,可以将其与 Flutter SDK 一起使用,以强制用户进入云眼灰度发布(特性标帜)AB实验中的特定变体。
使用这些方法通过强制用户进入特定变体来测试和调试客户端应用程序的各种流。
Flutter SDK 在做出任何决定之前会检查强制决策。如果找到所请求标帜的匹配项,Flutter SDK 会在做出正常决策之前立即返回强制决策(受众条件并忽略流量分配)。
Flutter SDK 遵循的具体场景如下:
标记到决策
- SDK 在给定标帜的任何决策调用开始时查找。如果为该标帜找到匹配的标帜到决策强制决策,它将返回该决定。
从实验规则到决策
- SDK 在决策开始时查找给定实验规则(标帜键)。如果为标帜找到匹配的实验规则到决策强制决策,它将返回决策。
从交付规则到决策
- SDK 在决策开始时查找给定的传递规则(标帜键)。如果找到匹配的传递规则到决策强制决策,它将返回该决策。
❗️
警告
在调用任何强制决策方法之前,必须将变体关联到标帜规则。
在强制决策时,SDK 会像其他正常决策一样触发展示事件和通知(除非被 disableDecisionEvent 选项禁用)。
📘 注意
这些强制决策不是永久性的,当重新初始化 EyeofcloudUserContext 时,系统会清除它们。
有关每种方法的更多信息,请单击下面的方法名称:
云眼分桶结果 EyeofcloudDecision上下文
Dart
class EyeofcloudDecisionContext { String flagKey; String? ruleKey; EyeofcloudDecisionContext(this.flagKey, [this.ruleKey]); }
云眼强制决策
Dart
class EyeofcloudForcedDecision { String variationKey; EyeofcloudForcedDecision(this.variationKey); }
Set Forced Decision Method - setForcedDecision()
版本
1.0.0-beta 或更高版本
描述
为给定的 设置强制决策 ()。variationKey``EyeofcloudDecisionContext
参数
下表列出了 Flutter SDK 的必需参数和可选参数。
参数
类型
描述
所需的上下文
结构
的实例,其中包含要设置的强制决策的必需和可选。EyeofcloudDecisionContext``flagKey``ruleKey
(必选)决定
结构
的实例,其中包含要设置的强制决策所需的实例。EyeofcloudForcedDecision``variationKey
返回
一个布尔值,指示是否成功完成了强制决策 () 的设置。 variationKey
例
在此处查看完整的 Flutter SDK 示例。
获取强制决策方法 - getForcedDecision()
变体
1.0.0-beta 或更高版本
描述
返回给定 的强制决策 ()。返回实例,如果没有匹配项,则返回 null。variationKey``EyeofcloudDecisionContext``EyeofcloudForcedDecision
参数
下表列出了 Flutter SDK 的必需参数和可选参数。
参数
类型
描述
所需的上下文
结构
的实例,其中包含要获取的强制决策的必需和可选。EyeofcloudDecisionContext``flagKey``ruleKey
返回
上下文的强制决策实例,如果没有匹配项,则为 null。 EyeofcloudForcedDecision
例
在此处查看完整的 Flutter SDK 示例。
删除强制决策方法 - 删除强制决策()
变体
1.0.0-beta 或更高版本
描述
删除给定 的强制决策 ()。variationKey``EyeofcloudDecisionContext
参数
下表列出了 Flutter SDK 的必需参数和可选参数。
参数
类型
描述
所需的上下文
结构
的实例,具有要删除的强制决策的必需和可选。EyeofcloudDecisionContext``flagKey``ruleKey
返回
成功/失败布尔状态(如果强制决策 () 已删除)。 variationKey
例
在此处查看完整的 Flutter SDK 示例。
删除所有强制决策方法 - 删除所有强制决策()
变体
1.0.0-beta 或更高版本
描述
删除用户上下文的所有强制决策 ()。variationKey
参数
下表列出了 Flutter SDK 的必需参数和可选参数。
参数
类型
描述
没有
不适用
不适用
返回
成功/失败布尔状态。
例
在此处查看完整的 Flutter SDK 示例。
完整代码示例
Dart
/* Create the EyeofcloudUserContext, passing in the UserId and Attributes */ var user = await eyeofcloudClient.createUserContext("user-id"); var flagContext = EyeofcloudDecisionContext("flag-1"); var flagAndABTestContext = EyeofcloudDecisionContext("flag-1", "exp-1"); var flagAndDeliveryRuleContext = EyeofcloudDecisionContext("flag-1", "delivery-1"); var variationAForcedDecision = EyeofcloudForcedDecision("variation-a"); var variationBForcedDecision = EyeofcloudForcedDecision("variation-b"); var variationOnForcedDecision = EyeofcloudForcedDecision("on"); // set a forced decision for a flag var success = await user!.setForcedDecision(flagContext, variationAForcedDecision); var decision = await user.decide("flag-1"); // set a forced decision for an ab-test rule success = await user.setForcedDecision(flagAndABTestContext, variationBForcedDecision); decision = await user.decide("flag-1"); // set a forced variation for a delivery rule success = await user.setForcedDecision(flagAndDeliveryRuleContext, variationOnForcedDecision); decision = await user.decide("flag-1"); // get forced variations var forcedDecision = await user.getForcedDecision(flagContext); print("[ForcedDecision] variationKey = ${forcedDecision.variationKey}"); // remove forced variations success = await user.removeForcedDecision(flagAndABTestContext); success = await user.removeAllForcedDecisions();
参见
源文件
包含 Flutter Android 实现的语言/平台源文件位于 Eyeofcloud.java Flutter iOS 位于 EyeofcloudClient.swift。