Testing new app features

Updating an app to activate new features can be time-consuming and expensive. With Varioqub, you can enable and disable parts of your app's code without updating the app itself. On top of that, Varioqub helps you run experiments on your newly-developed features and apply the most successful variant to the app.

To apply your features, you need to create a flag configuration. Each flag constitutes a key-value pair. For example, you can set up your configuration to disable your new option by default and toggle its visibility to users based on a condition otherwise.

Step 1. Creating configuration flags

  1. Go to AppMetrica.
  2. Go to the Flag configuration page and click Add flag.
  3. Specify the flag and its default value.
  4. Click Save.

If your code's logic contains additional values and conditions, add them as follows:

Note

This option is available for paid AppMetrica plans.

  1. Choose a configuration from the list, then click either the configuration itself or .

  2. Click Add value. These can contain multiple values.

    • Mobile OS: Operating system your app is built for.

    • OS versions: Version of the user's operating system.

      This value must only contain digits separated by dots. To specify a single version, set the same value for the start and end of the range. For Android, specify the API level.

    • Languages: Device language of the users who will see your configuration.

    • Regions: Region set in the device settings of the users.

    • App versions: Version or range of versions of your app that will show the configuration to users.

      The version number must contain up to four digits separated by periods (for example, 1.2.3.4). To specify a single version, set the same value for the start and end of the range. When setting a range of app versions, make sure that your values don't overlap. For example, it would be incorrect to specify a start value of 0.5,1 and an end value of 1.0.1,1.1.1 because 1 encompasses the entire range of the end value.

    • Custom parameters: You can define your own parameters as key-value pairs. For example, param=value.

      To apply multiple conditions in Varioqub, separate them with commas: aparam=avalue,bparam=bvalue (the conditions are joined by a logical AND). Condition blocks are combined by the OR operator.

      Allowed characters for parameters and their values
      • = — Placed between the parameter name and its value. If absent, only the parameter's presence is taken into account. Example: param=value
      • ? — Matches any character between zero or one time. Example: pa?am=va?ue
      • * — Matches any characters between zero or unlimited times. Example: p*m=v*e
      • + — Matches any characters between one or unlimited times. Example: p+m=v+e
      • ! — Means negation of a condition or exclusion of a parameter from influencing the experiment. Example: !param=val

      Warning

      Only use negation ! as the first character in a key.

      • Correct example: !param=value.
      • Incorrect examples: param!=value or param=!value.
      Usage examples

      Usage example

      What's taken into account in the experiment

      param

      Only the presence of the parameter, regardless of its value.

      param=value

      Exact match of the parameter and its exact value.

      !param

      Absence of the parameter with any value.

      *param*=value

      All parameters that contain the param fragment with the value value.

      !*param*=value

      The value of any parameter with the param fragment shouldn't be value.

      !*param*=*value*

      The value of any parameter with the param fragment shouldn't contain value.

      !*param*

      Absence of a parameter containing the param fragment.

Step 2. Applying changes to your app code

When your configuration is ready, you can apply it to the app.

  1. Click Publish config.
  2. Check your changes and click Save. The changes will be applied to the app according to your specified conditions immediately after saving.

After you publish the flag configuration, Varioqub creates a current version with the changes applied. You can go back to the previous version, and the changes saved for the current one will be reverted.

To use a default configuration when the user has no internet connection, download the default configuration and add it to your app. To do this, click , then click Download default config version.

What's next?

To test multiple variants of your features, run an experiment.