Audience Groups

Audience Groups are named user segments. You create a group with a set of codes (tags), the SDK on the application side assigns these codes to specific devices, and then when creating a scheduler you use the group in filters — only the targeted users receive the push.

Why You Need Audience Groups

Standard filters by country and language cover basic cases but don't allow targeting by user behavior or status. Audience groups fill this gap:

• Send a push only to paying users (vip_users).
• Exclude from the campaign those who have already completed the target action.
• Send a special offer to the inactive_30d segment (haven't opened the app in 30 days).
• Target beta testers with a separate beta_testers group.

Creating a Group

1. Go to Audience Groups and click "Create".
2. Set a name for the group (internal, for convenience).
3. Enter audience codes — one or more tags separated by commas. These are strings that the SDK will assign to devices.
4. Save the group.

Example: group vip_users with code vip. In the SDK, on each user purchase, call setTags({ segment: "vip" }). After that, in scheduler filters you can select the vip_users group.

Assigning Audience via SDK

After creating the group, configure the SDK side: when the required event occurs in the application, call the setTags method with key-value pairs matching the audience codes.

Web SDK:

NotifyPartners.setTags({ segment: 'vip', tier: 'premium' });

Android SDK:

NotifyPartnersSDK.setTags(mapOf("segment" to "vip", "tier" to "premium"))

iOS SDK:

try NotifyPartnersSDK.shared.setTags(["segment": "vip", "tier": "premium"])

Tags are key-value pairs (Map/Record/Dictionary). The server matches tag values against audience group codes to assign devices to groups.

Using in Scheduler Filters

When creating any scheduler type (instant, scheduled, weekly, auto-push):

1. In the "Filters" section, find the "Audience Groups" field.
2. Select one or more groups.
3. The system sends the push only to devices that belong to the selected groups.

Filters can be combined: country US + group vip_users = only US VIP users.

Event Filters

In addition to audience groups, events can be used in scheduler filters:

• Include — only devices that had the dep event (first deposit).
• Exclude — everyone except devices with the dep3 event (third deposit and above).

This allows building complex segmentation logic without creating separate groups for each condition.

More about events — in the Custom Events section.

API