Skip to main content
This guide walks you through creating an audience from scratch using the Trackly SMS audience builder.

​
Accessing the Audience Builder

  1. Navigate to Audiences in the sidebar
  2. Click New Audience in the top right
  3. The audience builder opens

​
Basic Structure

Every audience has:
  • Name: A descriptive name (e.g., “Active Clickers - CA”)
  • Lists: Which sending lists to query
  • Conditions: Filter rules that define who’s included

​
Step 1: Name Your Audience

Choose a descriptive name that explains who’s in this audience:
  • “High-Value Clickers - Last 30 Days”
  • “California Subscribers - No Clicks”
  • “Black Friday 2024 Signups”
  • “Revenue > $100 - Re-engagement”

​
Step 2: Select Lists

Choose which sending lists to include:
  • Single list: Only contacts on that list
  • Multiple lists: Contacts on ANY of the selected lists
Selecting multiple lists creates a UNION. A contact matching your conditions on List A OR List B will be included.

​
Step 3: Add Conditions

Click Add Condition to add your first filter.

​
Condition Structure

Each condition has three parts:
PartDescriptionExample
FieldWhat to filter onlast_clicked_at
OperatorHow to comparewithin
ValueThe threshold7 days

​
Available Fields

FieldDescription
last_sent_atWhen they last received a message
last_clicked_atWhen they last clicked a link
signup_dateWhen they joined the list
FieldDescription
send_countTotal messages received
click_countTotal links clicked
conversion_count is not exposed as a direct audience condition. Conversion-based targeting is available through the revenue condition type.
FieldDescription
has_revenueHas made any purchase (boolean)
revenue_totalLifetime revenue
avg_revenueAverage order value
conversion_countTotal number of conversions
last_revenue_atTimestamp of most recent conversion
FieldDescription
on_dncBoolean — whether the contact is on the Do Not Call list. Use eq operator with true or false
FieldDescription
carrierMobile carrier name (e.g., “T-Mobile”, “Verizon”). Operators: eq, in, exists, not_exists
timezoneIANA timezone (e.g., “America/New_York”). Operators: eq, in
Carrier and timezone conditions require a cross-collection lookup and are slower than ListContact-only conditions.
FieldDescription
signup_methodHow the contact was added (api, web_form, import). Operators: eq, ne, in, not_in
Can be combined with optional time-based filtering on signup date.
Any field you’ve defined on contacts. These query custom_fields.{key} on ListContact:
  • state (queries custom_fields.state)
  • city (queries custom_fields.city)
  • plan_type (queries custom_fields.plan_type)
  • signup_source (queries custom_fields.signup_source)
  • etc.

​
Available Operators

OperatorUse WithExample
eqText, numberState eq “CA”
neText, numberStatus ne “churned”
inText, numberState in [“CA”, “TX”, “FL”] (is one of)
not_inText, numberState not_in [“AK”, “HI”] (is not one of)
containsTextEmail contains “@gmail”
gtNumberRevenue gt 100
ltNumberSend count lt 5
gteNumberClick count gte 3
lteNumberSend count lte 10
withinDateClicked within 7 days
not_withinDateNot clicked within 30 days
beforeDateSigned up before Jan 1
existsAnyHas phone number
not_existsAnyMissing email

​
Step 4: Combine with Logic

​
AND Logic (Default)

All conditions must match: 
Condition 1: last_clicked_at within 7 days
AND
Condition 2: custom_fields.state eq "California"
Both must be true for a contact to be included.

​
OR Logic

Click the condition group header to switch to OR: 
Condition 1: custom_fields.state eq "California"
OR
Condition 2: custom_fields.state eq "Texas"
Either condition can be true.

​
Nested Groups

Click Add Group to create a nested set of conditions: 
Group 1 (AND):
  - last_clicked_at within 7 days
  - revenue_total gt 50

OR

Group 2 (AND):
  - signup_date within 30 days
  - click_count gt 0
This matches:
  • Recent clickers with revenue, OR
  • New signups who have clicked

​
Step 5: Preview and Save

​
Preview

Click Preview to see:
  • Estimated audience size
  • Sample contacts that match
  • Any issues with your conditions

​
Save

Click Create Audience to save. The audience appears in your list and can now be used in campaigns.

​
Example: High-Value Recent Clickers

Let’s build an audience of valuable contacts who are engaged:
1

Name it

“High-Value Clickers - 30 Days”
2

Select lists

Choose your main marketing list
3

Add time condition

Field: last_clicked_at Operator: within Value: 30 days
4

Add revenue condition

Field: revenue_total Operator: gt Value: 50
5

Preview and save

Check the preview, then save

​
Editing Audiences

To edit an existing audience:
  1. Go to Audiences
  2. Click the audience name
  3. Make your changes
  4. Click Save
Editing an audience affects all campaigns using it. The new definition applies to future sends.

​
Next Steps

Segmentation Logic

Advanced AND/OR patterns

Use in Campaigns

Target your audience