Contact Targeting

Target messages based on who your users are - their plan, role, signup date, and custom attributes.

Available Fields

Standard Fields

Field
Type
Example Values

Name

Text

"Jane Smith"

Plan

Text

"free", "pro", "enterprise"

Role

Text

"admin", "member", "viewer"

Phone

Text

"+1-555-123-4567"

Signed Up At

Date

Last 7 days, Before 30 days

Last Seen At

Date

Within 1 day, Before 7 days

Custom Attributes

Any custom attributes you've defined:

  • Text attributes (company, industry)

  • Number attributes (teamSize, revenue)

  • Boolean attributes (isTrialing, emailVerified)

Common Patterns

By Subscription Plan

Free users (upgrade prompt):

Paid users (premium features):

Non-enterprise (mid-tier upsell):

By User Role

Admins only:

Non-admins:

Multiple roles:

By Signup Date

New users (first week):

Established users:

Specific window (users from 7-30 days ago):

By Activity

Active users:

Inactive users (re-engagement):

By Custom Attributes

Enterprise companies:

Trial users:

Specific industry:

Operators

Text Operators

Operator
Use Case

Equals

Exact match: Plan equals "pro"

Not Equals

Exclude: Role not equals "viewer"

Contains

Partial match: Email contains "company.com"

Starts With

Domain prefix: Email starts with "admin"

Ends With

Domain suffix: Email ends with "@acme.com"

Is Set

Has value: Phone is set

Is Not Set

Missing: Name is not set

Number Operators

Operator
Use Case

Equals

Exact: teamSize equals 10

Greater Than

Above threshold: teamSize greater than 50

Less Than

Below threshold: monthlyRevenue less than 1000

Between

Range: teamSize between 10 and 100

Boolean Operators

Operator
Use Case

Equals

True/false: isTrialing equals true

Is Set

Has value: emailVerified is set

Date Operators

Operator
Use Case

Is Within

Recent: Signed Up At is within 7 days

Is Before

Past: Signed Up At is before 30 days

Is Set

Has date: Signed Up At is set

Complex Examples

Engaged Free Users

Target free users who've been around but haven't converted:

Enterprise Prospects

Target larger teams on pro plan:

Incomplete Profiles

Prompt users to complete their profile:

Trial Ending Soon

Alert users whose trial is ending:

Domain-Specific

Target users from a specific company:

Best Practices

Data Quality

  • Ensure you're sending accurate contact data

  • Update properties when they change

  • Use consistent values (always "pro", not "Pro")

Segmentation Strategy

  • Start with broad segments (plan, role)

  • Refine with engagement data

  • Use custom attributes for specifics

Testing

  • Target yourself first: Email equals "[email protected]"

  • Verify data matches expectations

  • Check edge cases

Performance

  • Avoid overly complex rules

  • Test with real user data

  • Monitor which rules match

Last updated