Audiences
An audience is a segment of visitors you want to target with an experience. Create an audience by defining a rule, comprising an attribute, operator, and value:
Core Attributes
The following attributes are available for targeting as part of the Core plan:
UTM Parameter
Target based on search parameters in the url when the visitor lands on your site.
Use cases include: email or ad campaigns, custom links for Account Based Marketing, and more.
| Attribute | Persists for |
|---|---|
utm_by_session.<field> | Current session |
utm_by_user.<field> | 30 days |
| Field | Search parameter | Meaning |
|---|---|---|
.campaign | ?utm_campaign | Specific promotion or strategic campaign |
.source | ?utm_source | Source of traffic (e.g. "google") |
.medium | ?utm_medium | Medium the link was used on (e.g. "email") |
.term | ?utm_term | Paid search keywords |
.content | ?utm_content | Used to differentiate similar content, or links in the same ad. |
Display content related to your Spring Sale for users following the link: https://yoursite.com/?utm_campaign=spring_sale
Rule: utm_by_session.campaign is spring_sale
Referrer
Segment visitors by the external URL they came from. Links from sites that share the same top-level domain as your site (including subdomains) will be excluded.
| Attribute | Persists for |
|---|---|
external_referrer_by_session | Current session |
external_referrer_by_user | 30 days |
Target visitors who first arrived at your site from Instagram:
Rule: external_referrer_by_user contains instagram.com
Landing Page
Target visitors who entered on a specified landing page.
| Attribute | Persists for |
|---|---|
landing_page_by_session | Current session |
landing_page_by_user | 30 days |
Provide a consist experience across your site
for a visitor who arrived at https://yoursite.com/landing-page-a
Rule: landing_page_by_session is https://yoursite.com/landing-page-a
Visited a Page
Target visitors who viewed specific pages, such as /pricing or /docs, at any point prior to this moment.
| Attribute | Persists for |
|---|---|
visited_pages_by_session | Current session |
visited_pages_by_user | 30 days |
Highlight more technical content for users who navigated to your developer resources at some point.
Rule: visited_pages_by_user contains https://yoursite.com/developers
Session Count
Customize the experience for First time or Returning visitors.
| Attribute | Persists for |
|---|---|
session_count | Current session |
Target first-time visitors:
Rule: session_count is 1
Device Language
Target users that speak a particular language.
| Attribute | Persists for |
|---|---|
device_language | Current session |
Target Spanish-speaking visitors:
Rule: device_language contains es-
Geo IP
Target visitors by location using their IP address.
| Attribute | Meaning |
|---|---|
geo_ip.country | Country (e.g. "US") |
geo_ip.region | State or province (e.g. "Texas") |
geo_ip.city | City (e.g. "Mountain View") |
geo_ip.zip | Zip code (e.g. "90210") |
Show different content to users outside the US:
Rule: geo_ip.country is not US
Advanced Attributes
The following attributes require an upgrade to the Advanced Targeting plan.
Goal Achieved
Retarget visitors who converted for a selected goal.
Variant Assignment
Retarget visitors who were assigned a specified variant in an Experiment.
Predictive Model
Target visitors by role, interest, industry, and intent using a machine learning model deployed as PMML.
List-Based Segments
Upload user list as a CSV or sync from your data warehouse.
Custom Attributes
The Sumatra support team will work with you to create custom attributes in your workspace for anything you don't see here.
To request a custom attribute, email: support@sumatra.ai or reach out on Slack.