Announcement Targeting
Announcement targeting controls which users see an announcement, when it appears, and how often it is displayed.
Audience Targeting
Assign an audience segment to restrict the announcement to specific user groups. You can target by:
- User attributes -- Role, department, plan type, signup date, or custom properties passed via the SDK.
- Behavioral criteria -- Pages visited, flows completed, or features used.
- Predefined segments -- Reusable audience definitions created in the Audiences section.
- Combined conditions -- Use AND/OR operators to build compound rules (e.g., role is "admin" AND plan is "enterprise").
If no audience is assigned, the announcement is shown to all users.
Trigger Types
Choose the trigger that determines when the announcement appears within its scheduled window. See Trigger Types in the Creating Announcements guide for the full table of options and configuration fields.
Trigger rules combine with audience rules — both must match for the announcement to display.
Scheduling
Control when the announcement is active:
| Field | Description |
|---|---|
scheduledAt | The date and time when the announcement becomes active. Leave empty to publish immediately. |
expiresAt | The date and time when the announcement is automatically deactivated. Leave empty for no expiry. |
Announcements with a scheduledAt date in the future enter a SCHEDULED status and activate automatically when the time arrives. Once expiresAt passes, the announcement is deactivated without requiring manual action.
Page URL Targeting
Restrict announcements to specific pages using URL matching rules:
- Exact match -- Show only on pages with an exact URL match.
- Contains -- Show on any page whose URL contains the specified string.
- Starts with -- Show on pages whose URL begins with the specified prefix.
- Regex -- Show on pages whose URL matches a regular expression.
If no page rules are defined, the announcement appears on all pages.
Display Frequency
Control how often the announcement is shown to the same user:
| Frequency | Behavior |
|---|---|
| Once | The announcement appears once. After the user sees or dismisses it, it does not appear again. |
| Every session | The announcement appears once per browser session. |
| Every page load | The announcement appears each time the user loads a matching page. |
| Custom | Set a maximum number of impressions or a time-based interval. |
Priority and Conflicts
When multiple announcements match the same page and audience conditions simultaneously, BreakGround uses priority to determine which one appears first. Set priority as a numeric value -- higher values display first.
If two announcements have equal priority, the most recently updated announcement takes precedence. Only one modal or slideout announcement displays at a time; banners and toasts can appear alongside other announcement types.
Dismissal Behavior
Configure what happens when a user dismisses an announcement:
- Permanent -- The announcement is hidden forever for that user.
- Session -- The announcement is hidden for the rest of the current session.
- Timed -- The announcement reappears after a configured interval (e.g., 24 hours).
For announcements requiring acknowledgment, disable the dismiss button to force users to interact with a CTA before closing.