Carillon docsDashboard
Manage audiences
Build filters, preview the reachable count, and save an audience.
Create an audience
- Open Audiences in your app.
- Add filters. A device must match every filter.
- Check the reachable count: matching devices that are opted in and not invalidated.
- Save with a name unique within the app.
The count reflects current device state. See audience filters for fields and matching rules.
Comparisons
Each filter on locale, timezone_id, app_version, app_build, os_version or a tag
offers a comparison:
| Comparison | Matches | API equivalent |
|---|---|---|
| Is | The exact value | value |
| Is one of | Any value in the list, one per line, up to 50 | in |
| Is none of | Any other value, and devices without the field or tag at all | not_in |
| Is set (tags only) | Devices that carry the tag, whatever its value | exists: true |
| Is not set (tags only) | Devices without the tag | exists: false |
To exclude values without also matching devices that never set the tag, add a second filter on
the same tag with Is set. "Every country except France and Belgium" is therefore two filters:
country Is none of FR, BE, and country Is set.
Send to an audience
Select the saved audience in the message composer, or use its ID as audience.audience_id
in a send request.
Edit or delete
A campaign copies its audience filters when accepted. Editing or deleting the saved audience does not change campaigns already created from it.