How to Create an Audience using the Audience Builder Private Beta

Build targeted customer segments from your warehouse using the Audience Builder and sync them to downstream destinations.
Available Plans
  • growth
  • enterprise

Video walkthrough

Prerequisites

Ask your data team to set up a Data Graph before starting — you won’t be able to select a data source until this is done.

1. Add a new audience

Navigate to Audiences and click Add audience.

Add audience

2. Select the data source

  1. Select a data source for the audience.
warning
You cannot change the data source after the audience is created. If you need a different data source, you will need to create a new audience. Only root models will be shown in the data source dropdown.
  1. Provide a name and description.
  2. Confirm and create the audience.
Set base definitions for the audience

3. Add the audience conditions

Click Add Condition to start defining conditions for the audience.

Add condition

The following condition types are available:

Condition
Description
PropertiesFilter on columns of the data source
EventsFilter on timestamped event tables
RelationsFilter by existence or aggregate of related records
AudiencesReference existing saved audiences for inclusion or exclusion
info
Each group of conditions uses either AND or OR — not both. Click the AND or OR label between conditions to switch the entire block. To combine both, create separate condition groups.

Properties

Define conditions on columns of the data source. Use AND/OR to combine multiple conditions. Add a Where condition to narrow further.

Add property-based conditions

Events

Select an event model and define a condition. See Audience Builder Reference for time-window modes and filtering details.

Add event-based conditions

Relations

info
Relations connect two entity models via a one-to-many relationship, while Events connect entity models to event models.

Define a condition on related records. Optionally, add a Where condition to narrow further. See Audience Builder Reference for relationship paths, quantifiers, and aggregates.

Add relation-based conditions

Audiences

Select an existing audience and specify whether customers should be a part of or should not be a part of that audience. See Audience Builder Reference for nesting and exclusion details.

Add audience-based conditions

4. Verify and sync

  1. Click Calculate size to see how many customers match the final conditions.
  2. Tweak conditions and recalculate as needed.
  3. Save the audience.
  4. To sync to a destination, see Syncs.

FAQ

Why is my Save button disabled?

Look for a blue dot on a condition — this means it’s missing a required value. Complete or remove it to enable Save.

Incomplete condition

How do I use AND and OR?

Each group is all-AND or all-OR. Click the AND/OR label between conditions to switch. To combine both, create separate condition groups.

Where do I set up a data graph?

Your Data team sets up the data graph. Reach out to them to get started.


Questions? We're here to help.

Join the RudderStack Slack community or email us for support