分桶方法decide
分桶方法decide
本主题概述了可用于在云眼灰度发布（特性标帜）AB实验中为用户返回标帜决策的 decide 方法。
使用 Decide 方法返回用户的标帜决策。标帜决策包括标帜启用/禁用状态和标帜变体。
本页介绍以下决策方法：
决定
版本
SDK 3.1 及更高版本
描述
返回用户的标帜键的决策结果。决策结果在 EyeofcloudDecision 对象中返回，并包含传递标帜规则所需的所有数据。
Decide 是 UserContext 对象的一种方法。有关详细信息，请参阅 EyeofcloudUserContext。
有关返回的决策对象的详细信息，请参阅 EyeofcloudDecision 。
参数
下表描述了 Decide 方法的参数：
参数
类型
描述
旗键
字符串
灰度发布（特性标帜）的键
选项（可选）
数组
Array of EyeofcloudDecideOption enums.请参阅下表。
云眼分桶结果 EyeofcloudDecision选项
下面的示例演示如何在任何 Decide 方法上单独设置选项，或在实例化 Eyeofcloud 客户端时将其设置为全局默认值。
C#
using EyeofcloudSDK; using EyeofcloudSDK.EyeofcloudDecisions; using System; namespace ConsoleApp { class Program { static void Main() { var eyeofcloudClient = EyeofcloudFactory.NewDefaultInstance(sdkKey: "<YOUR_SDK_KEY>"); var user = eyeofcloudClient.CreateUserContext("user123"); // set additional options in a decide call var decisionResultsMap = user.DecideAll(new EyeofcloudDecideOption[] { EyeofcloudDecideOption.ENABLED_FLAGS_ONLY, EyeofcloudDecideOption.IGNORE_USER_PROFILE_SERVICE, EyeofcloudDecideOption.DISABLE_DECISION_EVENT }); Console.ReadKey(); } } }
下表显示了云眼客户端的详细信息。请参见初始化软件开发工具包。
可以在“决定方法”上设置的选项。
云眼分桶结果 EyeofcloudDecision选项枚举
如果设置：
EyeofcloudDecideOption.DISABLE_DECISION_EVENT
防止访问者在仍收到变体的同时触发展示，从而禁止在“结果”页面上显示 Decide 方法的结果。
此设置可能是为什么决策事件调度枚举在返回的 falseEyeofcloudDecision 对象或 DECIDE 通知侦听器有效负载。
EyeofcloudDecideOption.ENABLED_FLAGS_ONLY
仅返回已启用标帜的决策。此选项仅适用于确定多个标帜的方法，如 Decide All 方法。如果此选项无效，则忽略此选项。如果未设置此选项，SDK 将返回所有决策，无论是否启用该标帜。
EyeofcloudDecideOption.IGNORE_USER_PROFILE_SERVICE
设置后，SDK 会绕过 UPS（查找和保存）进行决策。
如果未设置此选项，UPS 将覆盖受众定位、流量分配和实验互斥组。
EyeofcloudDecideOption.INCLUDE_REASONS
在 EyeofcloudDecision 对象的“原因”字段中返回日志消息。请注意，与信息或调试消息不同，无论此设置如何，始终返回严重错误消息。
EyeofcloudDecideOption.EXCLUDE_VARIABLES
从决策结果中排除标记变量值。使用此选项可通过跳过大型 JSON 变量来最小化返回的决策。
返回
方法返回一个云眼决策对象。有关更多信息，请参阅云眼决策。
如果该方法遇到严重错误（SDK 未就绪、标帜键无效等），则它会返回带有空变体键字段的决策，并使用错误消息填充“原因”字段（无论“包括原因”选项如何）。
示例决策
下面是调用 Decide 方法并访问返回的 EyeofcloudDecision 对象的示例：
C#
// create the user and decide which flag rule & variation they bucket into var attributes = new UserAttributes(); attributes.Add("logged_in", true); var user = eyeofcloud.CreateUserContext("user123", attributes); var decision = user.Decide("product_sort"); // variation. if null, decision fail with a critical error var variationKey = decision.VariationKey; // flag enabled state var enabled = decision.Enabled; // all variable values var variables = decision.Variables; // String variable value string vs = null; try { vs = variables.GetValue<string>("sort_method"); } catch (Exception e) { Console.WriteLine(e.ToString()); } // Boolean variable value var vb = (bool) variables.ToDictionary()["k_boolean"]; // flag decision reasons string flagKey = decision.FlagKey; // user for which the decision was made var userContext = decision.UserContext; // reasons for the decision var reasons = decision.Reasons;
Side Effects
Invokes the notification listener if this listener is enabled.DECISION
Decide All
Returns decisions for all active (unarchived) flags for a user.
See EyeofcloudDecision for details.
Version
SDK v3.7 and higher
Description
Use the Decide All method to return a dictionary of flag decisions for a user.
Parameters
The following table describes parameters for the Decide All method:
Parameter
Type
Description
options (optional)
Array
Array of EyeofcloudDecideOption enums. See Decide Parameters.
Returns
The Decide All method returns a map of EyeofcloudDecisions. For more information, see EyeofcloudDecision.
If the method fails for all flags (for example, the SDK is not ready or the user context is invalid), then it returns an empty map. If the method detects an error for a specific flag, it returns error messages in the Reasons field of the decision for that flag.
Examples
The following is an example of getting flags for the user with the Decide All call:
C#
var options = new EyeofcloudDecideOption[] { EyeofcloudDecideOption.ENABLED_FLAGS_ONLY }; var decisions = user.DecideAll(options); var allKeys = decisions.Keys; var decisionForFlag1 = decisions["flag_1"];
副作用
为每个决策调用通知侦听器（如果启用了此侦听器）。DECISION
决定键
方法返回指定标帜键的标帜决策映射。
变体
SDK v3.7 及更高版本
描述
获取标帜键数组的标帜决策图。
参数
下表描述了“决定键”方法的参数：
参数
类型
描述
键（Key）
数组
字符串标帜键数组。
选项（可选）
数组
Array of EyeofcloudDecideOption enums.请参阅云眼决策选项。
返回
返回云眼决策的映射。有关更多信息，请参阅云眼决策。
如果该方法对所有标帜都失败（例如，SDK 未就绪或用户上下文无效），则返回空映射。如果该方法检测到特定标帜的错误，它将在该标帜的决策的“原因”字段中返回错误消息。
例
以下是获取用户指定标帜的示例：
C#
// make decisions for specific flags var keys = new string[] { "flag-1", "flag-2" }; var decisions = user.DecideForKeys(keys); var decision1 = decisions["flag-1"]; var decision2 = decisions["flag-2"];
副作用
为每个决策调用通知侦听器（如果启用了此侦听器）。DECISION
源文件
包含 C# 实现的语言/平台源文件位于 Eyeofcloud.cs。