Get Feature Variable

This method is used to evaluate and return a feature variable. Multiple versions of this method are available and are named according to the data type they return:

• Boolean
• Double
• Integer
• String
• JSON

This method takes into account the user attributes passed in, to determine if the user is part of the audience that qualifies for the experiment.

Boolean

Returns the value of the specified Boolean variable.

public bool? GetFeatureVariableBoolean(string featureKey, string variableKey, string userId, UserAttributes userAttributes = null)

Double

Returns the value of the specified double variable.

public double? GetFeatureVariableDouble(string featureKey, string variableKey, string userId, UserAttributes userAttributes = null)

Integer

Returns the value of the specified integer variable.

public int? GetFeatureVariableInteger(string featureKey, string variableKey, string userId, UserAttributes userAttributes = null)

String

Returns the value of the specified string variable.

public string GetFeatureVariableString(string featureKey, string variableKey, string userId, UserAttributes userAttributes = null)

JSON

Returns the value of the specified JSON variable.

public OptimizelyJson GetFeatureVariableJSON(string featureKey,
                                         string variableKey,
                                         string userId,
                                         UserAttributes userAttributes)

Version

SDK v3.0 and higher

Description

Each of the Get Feature Variable methods follows the same logic as Is Feature Enabled:

1. Evaluate any feature tests running for a user.
2. Check the default configuration on a rollout.

The default value is returned if neither of these are applicable for the specified user, or if the user is in a variation where the feature is disabled.

🚧

Important

Unlike Is Feature Enabled, the Get Feature Variable methods do not trigger an impression event. This means that if you are running a feature test, events will not be counted until you call Is Feature Enabled. If you do not call Is Feature Enabled, you will not see any visitors on your results page.

Parameters

Required and optional parameters in C# are listed below.

Returns

Feature variable value or null

Example

using OptimizelySDK.Entity;

var attributes = new UserAttributes {
  { "device", "iPhone" },
  { "lifetime", 24738388 },
  { "is_logged_in", true },
};

var featureVariableValue = optimizelyClient.GetFeatureVariableDouble("my_feature_key", "double_variable_key", "user_123", attributes);

Side effects

In SDKs v3.1 and later: Invokes the DECISION notification listener if this listener is enabled.

Source files

The language/platform source files containing the implementation for C# is Optimizely.cs.