Adding a Variable

Use Variables to parameterize your mobile app and easily run A/B tests on the parameters.
Variables can be defined in the VWO interface, and then used in your app. Once you define a variable, you can run an unlimited number of A/B tests on that variable, without any code changes or deploy.

Variables can be of type integer, float, string or boolean.
To create a variable, click on APPS section in Mobile App A/B.

18861886

Use Create Variable button

25082508

Enter the name of the variable, data type and a default value.
The default value is the original value for that variable. Default value gets used if there are no tests running.

Default value helps your write consistent code, without introducing checks for nil.
In the example above, we have defined speed integer variable with 5 default value.
The corresponding code for Java, Objective-C and Swift is also generated.
Now instead of using int speed = 5; use the below code.

Integer Variable API

int speed = VWO.getIntegerForKey("speed", 5);
val speed = VWO.getIntegerForKey("speed", 5)

Boolean Variable API

bool isFeatureEnabled = VWO.getBooleanForKey("feature_name", true);
val isFeatureEnabled = VWO.getBooleanForKey("feature_name", true)

String Variable API

string buttonColor = VWO.getBooleanForKey("button_color", "red");
val buttonColor = VWO.getStringForKey("button_color", "red")

Double Variable API

double price = VWO.getDoubleForKey("price", 210.50);
val price = VWO.getDoubleForKey("price", 210.50)

📘

Return Value

The above functions will return a variable's value for the given variable-key. This function will search for the variable key in all the currently running campaigns. If the key exists in multiple campaigns, it will return the value for the key for the latest campaign.

Variable value for a Campaign

There's an option of providing the test-key of the campaign. This will return the variable value for that particular campaign only. A visitor will also become part of the provided campaign only.

🚧

NOTE

Support for passing the test key is only applicable from SDK version 2.10.0 onwards.

Integer Variable API

int speed = VWO.getIntegerForKey("test_key", "speed", 5);
val speed = VWO.getIntegerForKey("test_key", "speed", 5)

Boolean Variable API

bool isFeatureEnabled = VWO.getBooleanForKey("test_key", "feature_name", true);
val isFeatureEnabled = VWO.getBooleanForKey("test_key", "feature_name", true)

String Variable API

string buttonColor = VWO.getStringForKey("test_key", "button_color", "red");
val buttonColor = VWO.getStringForKey("test_key", "button_color", "red")

Double Variable API

double price = VWO.getDoubleForKey("test_key", "price", 210.50);
val price = VWO.getDoubleForKey("test_key", "price", 210.50)

📘

Return Value

The above functions will return a variable's value for the given variable-key and test-key. This function will search for the variable key in all the currently running campaigns and return the variable value where the input test-key matches with the running campaigns' test-key.