Skip to main content

Audience Targeting

Told's audience system lets you control who sees your surveys by creating reusable audience segments with filters.

How audiences work​

An Audience is a named set of filters attached to a source. Each audience can be linked to one or more surveys or product tours. When a survey has audiences assigned, it only appears to users who match the filter criteria.

Audience structure​

FieldDescription
nameAudience name (e.g., "English-speaking Pro users")
conditionTypeHow filters combine: and (all must match) or or (any can match)
filtersList of filter conditions
sourceThe source this audience belongs to
defaultWhether this is the source's default audience

Each source can have a default audience and multiple custom audiences.

Filter types​

Audiences contain filters that check user properties, events, and survey interactions. Filters are combined using the audience's conditionType (AND or OR).

Available filter categories:

Personal information​

Filter by SourceAuthor properties:

  • Name, email, username
  • Device type (desktop, tablet, phone)
  • Language
  • Operating system, app version
  • Custom traits (any key in customData)

Group / Company information​

Filter by the user's associated company traits:

  • Company name, industry, plan
  • Number of employees
  • Custom company traits

Survey responses​

Target users based on their interaction with surveys:

  • Users who completed a specific survey
  • Users who skipped a survey
  • Users who gave a specific answer

Events​

Filter by events the user has triggered:

  • Automatic events (page views, clicks, scrolls)
  • Custom events (sent via SDK, Segment, or dataLayer)

Date filters​

Filter by time-based criteria — when used with other filters, applies to the action timestamp. When used alone, applies to user creation date.

Session count​

Filter by how many sessions (nbSessions) the user has had.

Creating an audience​

  1. Go to your source's Audience section in the sidebar
  2. Click Create to make a new audience
  3. Name it and set the condition type (AND / OR)
  4. Add filters with their conditions
  5. Save the audience

The audience page shows a table of matching users with pagination, so you can verify who would be targeted.

Assigning audiences to surveys​

  1. Open your survey
  2. Go to the Publish section → Audience
  3. Select one or more audiences
  4. Additionally, set the audience percentage (triggerConfig.audiencePercent) to roll out to a percentage of matching users (0–100%, default: 100%)

Basic audience filter (Who)​

Separately from the audience system, each survey also has a basic "Who" filter that controls:

  • Devices: phone, tablet, desktop
  • Browser languages
  • Countries
  • Browsers: chrome, safari, firefox, explorer, opera
  • App versions (mobile)
  • OS: IOS, ANDROID
  • Rollout percentage (publicPercent)

This basic filter is configured in the trigger settings and applies in addition to any assigned audiences.

Viewing audiences​

The Audience section of your source shows:

  • Audiences tab — List of audience segments with user counts
  • Companies tab — List of companies/groups with their users
  • User drawer — Click on a user to see their full profile, events, and answers
  • Import — Bulk import users or companies