Optimizely Classic Mobile apps: Create Audiences in iOS and Android

Table of Contents

Create a mobile audience in iOS or Android
Target multiple Audiences
Custom tags

This topic describes how to:

Create new mobile audiences in Optimizely or add existing audiences to your experiments
Target your experiment to certain types of visitors, based on a customizable list of attributes.
Build Audience conditions using the Editor

Mobile audiences let you target your experiment or new experience to certain types of visitors, based on a customizable list of attributes. For example, you may want only visitors who are currently browsing on a iPhone in California to see your experiment, or you may want to exclude visitors who are browsing on a tablet and also visitors who are using an outdated version of your app. Visitors who match those conditions will be included or excluded from your experiment.

You can create Mobile Audiences based on the follow conditions:

iOS

Android

Custom Tags. Functions identically to custom tags in Web experiments. For more information on how to add custom tags to your code, see our developer resources (Android, iOS).
Has Universal User ID. You can identify and target users across different devices and platforms based on an ID you provide us.
Language. The language that the device is using within its System Preferences.
Optimizely iOS SDK. The version of Optimizely's SDK.
iOS App version. The version of your app, as defined by you.
iOS Device Model
iOS OS Version
Attributes. The value a user has for attributes you have set up in your project.

Android App version. The version of your app, as defined by you.
Android Device DPI
Android Device Model
Android Device Screen Size (DP)
Android Device Screen Size (inches)
Android OS Version Code
Custom Tags. Functions identically to custom tags in Web experiments. For more information on how to add custom tags to your code, see our developer resources (Android, iOS).
Has Universal User ID. You can identify and target users across different devices and platforms based on an ID you provide us.
Language. The language that the device is using within its Device Settings.
Optimizely Android SDK. The version of Optimizely's SDK.
Attributes. The value a user has for attributes you have set up in your project.

Create a mobile audience in iOS or Android

There are two ways to create audiences: from the Audiences tab or from the Experiment Details bar.

From the Audiences tab

Select your mobile project, then select the Audiences tab.
Click New Audience to create a new audience. This opens the Create New Audience view.
Drag and drop your audience conditions to determine which visitors qualify for your Experiment.

From the Experiment Details sidebar

Select your mobile project, then select an Experiment. The sidebar labeled Experiment Details auto-populates with information about your experiment.
To edit your audiences or create a new one, click Edit next to the Audiences field. The Experiment Audiences view appears.

Or, click Editor to open the Editor.
Click Audiences to access the Experiment Audiences dialog.
You can add an existing audience by clicking Add a Saved Audience. You can create a new audience by clicking Create a New Audience.

Target multiple Audiences

Optimizely lets you add multiple audiences to a single Experiment. A visitor who qualifies for any of the audiences you add is eligible to see the Experiment.

If you only want visitors who qualify for all the audiences to see the experiment, create a new audience. Define this new audience with all of the conditions from your multiple audiences. A visitor only sees this experiment if all of these conditions are met.

Custom tags

One of the most powerful features of audiences is custom tags. Custom tags allow you to target users based on attributes beyond the standard conditions defined in Optimizely.

For example, you can target users who:

Spend over $100 in one purchase
Use your app between 1pm and 2pm
View a certain page

Custom Tags are implemented in your own codebase using JavaScript. To learn more about out how to implement Custom Tags, please check out the following articles or show them to your developer:

Custom Tags on Android
Custom Tags on iOS

Custom Tags and Activation Modes

Optimizely Experiments are activated automatically or manually. By default, Experiments are set to automatic activation mode.

With automatic activation, the Experiment is activated when the Optimizely SDK is activated. You should make a call to startOptimizelyWithAPIToken when your app starts.
With manual activation, the Experiment is activated independent of the SDK. You choose when you want to activate your experiment by calling activateManualExperiment in your codebase.

In automatic activation mode, you can use any Custom Tags that were created prior to the current user session. In other words, custom conditions for an audience must be defined before the app starts; Custom Tags set during a session do not affect visitors in that same session.

To set and use a Custom Tag in a single session, use the manual activation model. This lets you specify a certain point in the app when you want to activate the Experiment. Any Custom Tags set before you activate the Experiment also apply.

Articles in Section