Targets and Versions


Under allocation, choose the percentage of users – selected randomly – that you want to launch your feature to. This can be any number from 0 to 100%.

Note: If you want to launch only to a specific set of known users IDs, leave allocation at 0% and move on to Pilot Users.



In addition to selecting the percentage of users to see this feature flag, you can also specifically target users with certain attributes:

  • Country: The user’s country according to their device settings, not which country they are in according to GPS.
  • Device Model: The user’s device model (e.g. “iPad4,1” (iPad Mini Air), “iPhone4,1” (iPhone 4S)).
  • Language: The user’s language according to their device settings.
  • Screen Height: The height of the user’s device screen in pixels.
  • Screen Width: The width of the user’s device screen in pixels.
  • Screen Scale: The device’s screen scale or density.
  • OS Version: The iOS or Android version the user’s device is running (e.g. 7.1.0 (iOS), 4.4.2 (Android)).
  • User is New: Only new users who first run the app after the feature flag is turned on.
  • Version Number: The app version as shown in the store (e.g. 2.5.2).

You can select more than one targeting filter. Note that multiple filters will have an AND relationship. As in, if you create the filter “Device Model is in iPhone 6″ and “Language is in English,” the only users who will see the feature flag are users whose devices are iPhone 6′s that are also in English. You can also select more than one criteria for each filter. For example, you can target the feature flag to users who are on iPhone 5, 5c, or 5s by entering all three phones into one targeting filter.

Custom Attributes

Apptimize also allows you to programmatically set attributes on which you can target. Custom Attributes enable you to target based on any user characteristic that you can obtain programmatically. All you have to do is select Custom Attribute and enter the name of the targeting criteria like this:


You will also need to insert the following code snippet into your app where the information is being gathered so that the criterion can be passed to Apptimize.

[Apptimize setUserAttributeString:THE_ATTRIBUTES_VALUE forKey:@"Gender"];
[Apptimize setUserAttributeDouble:THE_ATTRIBUTES_VALUE forKey:@"Gender"];
[Apptimize setUserAttributeInteger:THE_ATTRIBUTES_VALUE forKey:@"Gender"];
Apptimize.setUserAttribute("Gender", THE_ATTRIBUTES_VALUE);

Note that once you have created and integrated an attribute, you can use it again for later projects (Feature Flags or A/B Experiments) without having to re-integrate into your app. Once the code snippets are placed in your app, they are not tied to a specific project and can be used in as many projects as you’d like.


In the versions section, specify which app version you want this feature to launch on. Any users (with the exception of pilot users) that are on an earlier version of the app will not see the feature. Users on the specified or later version of your app will be eligible to see the feature. If you do not specify a version, users on all versions of your app can see the feature (assuming the feature flag code is included in their app version).

Once you’ve specified a launch version, you may further exclude additional versions. This is only necessary for versions greater than or equal to the launch version. In the example below, users in versions 2.0 and greater may see the feature, with the exception of users on version 2.2.

If you want to enable this feature on only one specific version of your app (e.g. version 2.0 only), uncheck the box next to “enable feature in all future application versions.”