Audiences
Audiences allow you to setup simple or complex filtering rules to match certain users and show a paywall to them. For a user to see a paywall, they must be matched to an audience. An audience can show one or more paywalls based on a percentage you set (i.e. show paywall A to 70% of users, and paywall B to 30%).
Another way to think of them is this: If you’re wanting to create conditions, filters or certain rules or flows that must happen to show a paywall — then you create an audience for it.
If creating filters to show a paywall under certain conditions doesn’t apply to you, then you can simply leave the default audience on — it’ll match everyone who hits a placement.
In the audience view, you can see setup filtering rules, check results of experiments and recent transactions resulting from them. All of your current audiences will show in the left-hand side of the campaign details screen:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaigns-audiences.png)
The audience section lets you edit the order in which audiences are evaluated. Superwall evaluates audiences top-to-bottom. For example, consider you had three audiences for a caffeine tracking app:
- An audience for users who tried to set a custom app icon.
- An audience for users who’ve logged caffeine late at night.
- And, everyone else.
If a user logged caffeine in the morning, Superwall would first check if they matched the custom app icon audience, and then the audience for logging caffeine late at night. Since neither of those match (since they are logging caffeine in the morning, and not setting a custom icon), they’d land in the “everyone else” audience bucket.
Adding a new audience
To create a new audience, click the + button in the audiences section, located at the left-hand side of the campaign details view:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaigns-add-audience.png)
Superwall will create a new audience, and place it at the bottom of your current audiences by default.
Renaming Audiences
To rename an audience, click the pencil icon, located at the top of a selected audience:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaigns-audiences-set-name.png)
Configuring an audience
To use an audience to filter for a particular set of events, rules or any other condition — you use filters along with an optional limit.
Creating filters
You can add filters (i.e. rules or conditions to match against) by clicking on an audience, and then clicking the + Add Filter button:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaigns-audience-add-filter.png)
From there, select any of the events to create a filter with. For example, if you want to use a placement you’ve made to match against:
- Click ”+ Add Filter”.
- Type in “event_name”.
- For the evaluation operator, choose “is”.
- And then, type in the placement’s name.
For example, if we wanted to show a certain paywall for users who tried to set a custom icon, it might look like this:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaigns-audience-filter-by-event.png)
When you have a condition setup, click the Save button towards the bottom to apply it:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaign-audience-filter-save.png)
If you don’t want to save any filter you’re working on, click the Discard button by the save button.
You can combine rules together, too. In the following example, if we only wanted the paywall to show on iOS, and not Android, you can simply click “+Add Filter” once more, and add the condition:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaigns-audience-combo-condition.png)
For a hands on tutorial of creating multiple filters to show different paywalls, check out this video:
Assignments Are “Sticky”. Once a user is assigned a paywall or a holdout within an audience, they will continue to see that assignment unless you reset them (by clicking the reset icon next to Assigned) or remove the paywall from the rule via the X button. Remember: Changing a paywall’s percentage only affects new users. It doesn’t affect assignments for users who already saw that paywall.
Setting a limit
To set a limit for an audience, click the + Add Limit button — located below the filter section:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaigns-audiences-set-limit.png)
This is useful if you want to limit how many times a user can match with the audience. You can choose how many times the limit should be placed, along with a time duration and time span. For example: 1 (times) every 60 (time duration) minutes (time span):
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaign-audience-config-limit.png)
Once you’ve setup a limit, click the Save button at the bottom:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaign-audience-limit-save.png)
User seeds
One particularly useful property to filter by are user seeds, which are automatically assigned by Superwall to a user from 0-99. You can add them as a filter by entering user.seed
. User seeds are primarily used to control entirely different user experiences across different campaigns.
For example, imagine testing whether showing a paywall early in onboarding or at the end of it works better for conversion:
Campaign A: Placement early in onboarding
For your audience filter, you could use user seeds 0-49.
Here’s what that would look like when setting up the filter:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaigns-audience-user-seed.png)
Campaign B: Placement late in onboarding
And here, you’d filter by user seeds 50-99.
Even though these are filters that were setup across two entirely different campaigns, you can still define certain user audiences without creating custom placements for each of them. Using user seeds, you can easily compare the campaign results, too.
Audience details
When you select an audience, you can toggle between four main sections:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaign-audience-components.png)
Filters
This is where you can configure filters and limits. If there isn’t one set, this will say “Everyone”, indicating the audience will match all users.
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaign-audience-everyone.png)
Paywalls
This section displays the paywalls which will present for the audience.
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaign-audience-paywalls.png)
You can add new paywalls for the audience to use, or set a percentage to show across multiple paywalls when the audience is matched. To add a new paywall, click on + Add Paywall to associate one to the current campaign.
Results
Here, you can see how paywalls are performing for the given audience.
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaign-audience-results.png)
Superwall will show top-level metrics here, but if you want to see more details, click the Charts button at the top-right hand side of the metrics.
Users
Finally, the users section shows recent matches in the audience from filters setup for it, and transactions that have resulted from them.
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaign-audience-users.png)
When viewing either one, Superwall will show which placement resulted in the paywall being presented (recent matches), and which placement led to a conversion (transactions).
Reordering audiences
To change the order that Superwall evaluates audiences, simply drag and drop them in the left-hand sidebar of any opened campaign:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaigns-reorder-audience.png)
Remember, Superwall will check the audience at the top of the list here, and then go down one-by-one until it hits a match. These checks occur when a user hits a code path where you’ve registered a placement or if an automatically tracked placement is triggered (i.e. something like survey_response
).
Changing audience status
You can duplicate, delete, pause or archive an audience using the buttons at the top of open audience:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/campaign-audience-status.png)
Archived audiences can be restored at any point. Paused campaigns are not evaluated by Superwall.