Skip to main content

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 a task list or by clicking a custom trigger element in your application that calls DAP('startFlow', flowId).

Trigger Type Summary​

TriggerFires whenKey config
URL_MATCHURL matches a patternpattern, matchType
MANUALTriggered 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. 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 a task list.