Audiences give you control over which users are included in a rollout and have access to your feature.
You'll describe which users to include based on custom attributes like their location, device type, or subscription plan. After you create an audience, you can add it to your feature.
3-minute video explaining high-level how Audience targeting works in Optimizely
A single audience is defined based on user attributes. These attributes are properties of a user that you pass in when calling APIs like
Is Feature Enabled. When you pass attribute values, Optimizely uses them to determine whether the user qualifies for rollout.
After you've created a few attributes, you can start building audiences. Audiences help you target your feature to certain groups of users. You can reuse audiences that you've created across multiple features.
Rollouts supports several match types that you can use in audience conditions:
has any value
String contains substring
Boolean is false
Boolean is true
Number is less than
Number is greater than
The Edit Audience window lets you define audience conditions by either dragging and dropping attributes from the right side pane or defining complex JSON objects using the Code Mode window.
To drag and drop attributes:
- Navigate to Audiences > Saved.
- Click Create New Audience.
- Drag and drop the desired attributes into the Audience Conditions field.
For example, to create an audience of visitors who are located in the US, based on specific location values, add the "LOCATION" attribute.
- Define the attributes. See Define attributes.
Add other attributes to help create your audience. They can be can be added as "and" or "or" conditions. When you choose any match type option other than String equals for exact matching, a message displays that the option requires using an SDK version of 3.0, at minimum.
- Click Save Audience.
After creating an audience, you can set the target audience or audiences for a feature test, or feature rollout.
Using the Optimizely opp, you can easily use "and", "or" operators (i.e., 'any' or 'all') to create an audience combination composed of other audiences:
You can assign multiple audiences, including audience combinations, to feature tests and feature rollouts.
Multiple audiences, including an audience combination
Here are some tips and tricks for using audiences:
- To QA an experiment, base an audience on a test cookie. Use the cookie to manually force a variation. See Use a QA audience.
- To schedule turning on a feature flag, base an audience on an epoch time attribute. First, compute the time in your application, then pass the time in as an attribute. In this scenario, your audience attribute condition would look something like
time number is greater than 12312412and
time number is less than 12355555.
You can easily use audiences to include or "whitelist" users, but not to exclude them.
For example, you can't exclude all Brazilian users by simply dialing back to 0% traffic for that audience. That's because if you turn off audience evaluation for Brazilian users, they end up in the "Everyone" audience.
To actually exclude or blacklist audiences, you need to define audience combinations using JSON. For more information, see Create advanced audience combinations.
Brazilians end up in "Everyone" unless you define an advanced audience combination
If you want to use more sophisticated nested logical operators (
not), you can do so in JSON in Code Mode. Each audience is a rule like "User likes salads", and an audience combination is a Boolean combination of these rules, like "User likes pizza NOT (User likes sandwiches AND User likes soup)."
For more information, see Configure a custom audience combination
Updated 13 days ago