Flow Targeting

Flow targeting controls when, where, and to whom a flow is displayed. Configure trigger types and audience rules to deliver flows to the right users at the right time.

Trigger Types

A flow can be assigned a single trigger that determines how it activates. BreakGround supports two flow-level trigger types:

URL_MATCH

Activates the flow when the user navigates to a URL that matches a specified pattern. Supports four match modes:

• exact -- The URL must match the pattern exactly.
• contains -- The URL must contain the pattern string.
• startsWith -- The URL must start with the pattern.
• regex -- The URL must match a regular expression.

URL triggers poll for changes every 500ms to detect SPA navigation, and also listen for browser popstate events.

MANUAL

The flow does not activate automatically. Users launch it on demand from the self-help widget, a task list, or by clicking a custom trigger element in your application that calls DAP('startFlow', flowId).

Trigger Type Summary

Trigger	Fires when	Key config
URL_MATCH	URL matches a pattern	pattern, matchType
MANUAL	Triggered programmatically	—

Looking for richer triggers? Per-content triggers like exit_intent, scroll_depth, time_on_page, and side_button are configured on individual content items (tooltips, beacons, surveys, announcements) via triggerConfig, not at the flow level. See Creating Announcements and the Content API. For event- or state-driven entry, use a journey with a TRIGGER node.

Audience Targeting

Audience targeting restricts which users see a flow based on their attributes and behavior. Assign a predefined audience segment to a flow, or define inline rules using:

• User attributes -- Role, department, signup date, plan type, or any custom property passed via the SDK.
• Behavioral criteria -- Pages visited, flows completed, or features used.
• Segments -- Reusable audience definitions created in the Audiences section.

See the Audiences documentation for details on creating and managing audience segments.

Priority and Conflicts

When multiple flows match the same page and audience conditions, BreakGround evaluates them by priority. Higher-priority flows display first. If two flows have equal priority, the most recently updated flow takes precedence.

Only one auto-triggered flow displays at a time. Users can still launch additional flows manually from the self-help widget or task list.

Frequency Capping

Control how often a flow appears to the same user:

• Once -- Show the flow only the first time conditions are met.
• Every session -- Show the flow once per browser session.
• Every time -- Show the flow each time conditions are met.
• Custom -- Set a specific interval (e.g., once per week).