Carillon docsManage 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.
View and edit an audience
Click an audience name to see its ID, saved filters and current reachable count. Use the copy button beside the ID to use it in an API send request. The detail URL can be bookmarked or shared with another member of your organization. Click Audiences in the breadcrumb to return to the list.
Click Edit to change the filters. The reachable count updates as you make changes. Click Save audience to apply them, or Cancel to keep the saved filters. The audience keeps its ID.
Delete an audience
Open the audience, click Delete, then confirm the deletion.
Audience edits apply to existing campaigns whose recipient resolution has not started. Once resolution starts, the filters stay fixed for the whole campaign, including timezone waves. Deleting an audience preserves existing campaigns and their copied filters.