Skip to main content

We are currently experiencing an issue that is preventing customers from submitting support tickets. Please contact us at (866) 819-4486 if you need immediate assistance.

x
Optimizely Knowledge Base

Create Mobile Audiences in iOS and Android

This article will help you:
  • 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 allow you to 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. Read more here.
  • 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. Read more here.
  • 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 the New Audience button to create a new audience.

This will open the Create New Audience modal. 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 will auto-populate with information about your experiment.

To edit your audiences or create a new one, click the Edit button next to the Audiences field. This will bring up the Experiment Audiences dialog.

Or, click the Editor button to open the Editor.

Then, click the audiences icon to access the Experiment Audiences dialog.

Once you’ve opened the Experiment Audiences dialog, you can add an existing audience by clicking the Add a Saved Audience button. Create an audience from scratch by clicking the Create a New Audience button.

Target multiple Audiences

Optimizely allows you to add multiple audiences to a single Experiment. A visitor who qualifies for any of the audiences you add will be 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. Now, a visitor will only see this experiment if she meets all of these conditions.

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 and Activation Modes

Optimizely Experiments are activated in two ways: automatically and manually. By default, Experiments are set to automatic activation mode.

  • With automatic activation, the Experiment is activated when the Optimizely SDK is activated. We recommend you do this with 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 will not affect visitors in that same session.

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

You can read more about manual activation our developer documentation.