Rejoiner

Rejoiner Documentation

Explore our guides and examples to power your email channel with Rejoiner.

Get Started    Guides

Building Segments

To build a segment, navigate to “Segments” in the main navigation bar. Then click on the “Add New Segment” button at the top right corner of your screen.

The next step is to name your segment on the next screen:

Once you have entered a name, you will be taken to the Segment Builder.

In the Segment Builder, you can start adding filters to your segment. Think of filters as conditions. These conditions will help you find what a customer has or has not done. Filters can also help you find people based on a number of contexts outlined below:

Contexts

Filter Contexts

Segment filters are divided into the following contexts:

Context NameDescription
Customer PropertiesFilter by properties like demographics, customer tags, or lifetime spend.
Device & Location DataFilter by device type, postal code, region/state or country.
Session ActivityFilter by metadata like fulfillment or delivery dates.
List Subscriptions & List DataFilter based on the list membership and list metadata.
Purchase ActivityFilter based on purchase history.
Abandon ActivityFilter by abandoned cart activity.
Browse ActivityFilter based on pages or products that have or have not been viewed.
Email ActivityFilter based on email engagement.
Journey ActivityFilter based on journey history.
Test ActivityFilter based on test history.
Customer InsightsFilter based on recency, frequency, and monetary rankings for purchase and email engagement.

Filters

Customer Properties

🚧

Many of these properties rely on values being passed to us explicitly. For example, we can’t infer the customer’s age without it being passed to us.

FilterDetails
Customer email addressFind customers based on the composition of their email address.
Customer ageFind customers based on their age.
Customer genderFind customers based on their gender.
Customer languageFind customers based on their language.
Customer opt-in statusFind customers based on whether or not they have explicitly opted-in.
Customer Rejoiner subscription statusFind customers based on whether they have unsubscribed or not.
Customer email validation statusFind customers based on whether or not the email address is valid. Note: Must be using automated email validation.
Customer email delivery statusFind customers based on whether or not their email address is deliverable or has hard bounced in the past.
Customer tagsFind customers based on which tags have been applied to their profile.
Customer metadataFind customers based on custom metadata.
Customer created (since)Find customers based on when they were first identified.
Customer was part of segmentFind customers who belonged to a segment at any point in the past.
Customer was not part of a segmentFind customers who were never part of a segment.
Customer is currently part of segmentFind customers who are currently in a segment.
Customer is not currently part of segmentFind customers who are not part of a segment right now.
Customer order countFind customers based on how many times they’ve purchased.
Customer total revenueFind customers based on how much they’ve spent.
Customer’s average order valueFind customers based on the average order value of their purchases.
Customer tagsFind customers based on which tags have been applied to their profile.
Customer’s first purchase wasFind customers by the date of their first purchase.
Customer’s last purchase wasFind customers by the date of their last purchase.

Device & Location Data

🚧

These values are inferred from the customer’s browsing data.

FilterDetails
Last visited site at country locationFind customers based on the country they last browsed from.
Last visited site at region locationFind customers based on the state or province they last browsed from.
Last visited site at postal codeFind customers based on their zip or postal code.
Last visited site with browserFind customers based on the browser they use.
Last visited site using deviceFind customers based on the device they last visited with.

Session Activity

🚧

These filters are helpful for date-based triggering use cases. For example, it enables you to send an email X days before or after a specified date. These filters correspond to some common dates that are pushed into our system via our REST API, but theoretically, you can use these API endpoints to push any dates you’d like to trigger on.

FilterDetails
Session payment dateFind customers based on their date of payment.
Session fulfillment dateFind customers based on when their order was fulfilled.
Session delivery dateFind customers based on when their order was delivered,
Session start dateFind customers based on their most recent session was created.
Session abandon dateFind customers based on when their most recent session was abandoned.
Session conversion dateFind customers based on when their most recent session was converted.

List Subscriptions & List Data

FilterDetails
Subscribed to ListFind customers who are members of a specific list.
Not subscribed to ListFind customers who are not members of a specific list.
Customer has custom parameter in ListFind customers who have values associated with a custom field in a list.
Customer does not have custom parameter in List Find customers who don’t have values associated with a custom field in a list.

Purchase Activity

FilterDetails
Purchase total valueFind customers based on the value of their last purchase.
Purchase order numberFind customers based on the order number of their last purchase.
Purchase total item countFind customers based on how many items they purchased.
Purchased an item whose nameFind customers who have purchased a specific item.
Did not purchase an item whose nameFind customers have not purchased a specific item.
Purchased an item whose product IDFind customers who have purchased an item with a specific product ID.
Did not purchase an item whose product IDFind customers who have not purchased an item with a specific product ID.
Purchased an item whose categoriesFind customers who have purchased an item in a specific category or categories.
Did not purchase an item whose categoriesFind customers who haven’t purchased an item in a specific category or categories.
Purchased an item whose descriptionFind customers based on the description of an item they purchased.
Did not purchase an item whose priceFind customers who didn’t purchase an item based on the description.
Purchased an item whose priceFind customers based on the price of an item they purchased.
Did not purchase an item whose priceFind customers based on the price of an item they didn’t purchase.
Purchased an item whose quantityFind customers based on the quantity of an item they purchased.
Did not purchase an item whose quantityFind customers based on the quantity of an item they didn’t purchase.
Purchased an item whose expiration dateFind customers based on the expiration date of the cart item they purchased.
Purchase included promo codeFind customers who used a specific promo code.
Purchase did not include promo codeFind customers who have not used a specific promo code.
Purchase session included cart metadataFind customers based on cart metadata from their last purchase.
Purchase session included item metadataFind customers based on cart item metadata from their last purchase.

Abandon Activity

FilterDetails
Abandoned cart total valueFind customers based on the value of their last abandoned cart.
Abandoned cart total item countFind customers based on the total number of items from their last abandoned cart.
Abandoned an item whose nameFind customers who abandoned an item with a specific name
Did not abandon an item whose nameFind customers who have purchased a specific item.
Did not purchase an item whose nameFind customers who did not abandon an item with a specific name.
Abandoned an item whose product IDFind customers who abandoned an item with a specific product ID.
Did not abandon an item whose product IDFind customers who did not abandon an item with a specific product ID.
Abandoned an item whose descriptionFind customers based on the description of an item they abandoned.
Did not abandon an item whose descriptionFind customers who did not abandon an item based on its description.
Abandoned an item whose priceFind customers who abandoned an item based on its price.
Did not abandon an item whose priceFind customers who did not abandon an item based on its price.
Abandoned an item whose quantityFind customers who abandoned a specific quantity of items.
Did not abandon an item whose quantityFind customers who did not abandon a specific quantity of items.
Abandoned an item whose expiration dateFind customers who abandoned a cart item with a specific expiration date.
Abandoned an item whose categoriesFind customers who abandoned a cart item from a specific category or categories.
Did not abandon an item whose categoriesFind customers who did not abandon a cart item from a specific category or categories.
Abandoned cart included promo codeFind customers who abandoned a cart and used a specific promo code.
Abandoned cart did not include promo codeFind customers who abandoned a cart and didn’t use a specific promo code.
Abandoned session whose cart metadataFind customers who abandoned a cart based on metadata
Abandoned session whose item metadataFind customers who abandoned a cart item based on metadata.

Browse Activity

FilterDetails
Viewed an item whose product IDProduct ID properties of an item in a browse abandoned session.
Did not view an item whose product IDProduct ID properties of an item that was not part of a browse abandoned session.
Viewed an item whose categoriesCategory properties of an item in a browse abandoned session.
Did not view an item whose categoriesCategory properties of an item that was not part of a browse abandoned session.
Viewed a page whose URLURL properties of a page viewed in a browse abandoned session.
Did not view a page whose URLURL properties of a page that was not viewed in a browse abandoned session.
Did not abandon an item whose product IDFind customers who did not abandon an item with a specific product ID.
Viewed a page whose query stringsQuery string properties of a page viewed in a browse abandoned session.
Did not a page whose query stringsQuery string properties of a page that was not viewed in a browse abandoned session.

Email Activity

🚧

“Creative” refers to the email template. A piece of creative can be used in a journey or a broadcast and can be sent multiple times.

FilterDetails
Has received email creativeFind customers who have received email creative.
Has not received email creativeFind customers who haven’t received email creative.
Has opened email creativeFind customers who have opened email creative.
Has not opened email creativeFind customers who have not opened email creative
Has clicked email whose creativeFind customers who have clicked email creative
Has not clicked email whose creativeFind customers who have not clicked email creative
Has clicked on link with IDFind customers who have clicked a link ID
Has not clicked on link with IDFind customers who have not clicked on a link ID
Has clicked on link with URLFind customers who clicked on a specific URL
Has not clicked on link with URLFind customers who have never clicked a specific URL

Journey Activity

FilterDetails
Started JourneyFind customers who have started a journey.
Has not started JourneyFind customers who haven’t started a journey.
Is currently in JourneyFind customers who are currently in a journey.
Is not currently in JourneyFind customers who aren’t currently in a journey.
Has completed journeyFind customers who have completed a journey.
Has not completed journeyFind customers who haven’t completed a journey.

Test Activity

FilterDetails
Participated in a testFind customers who participated in the control or variant of a test.
Did not participate in a testFind customers who did not participate in a test.

Customer Insights

FilterDetails
Customer’s purchase recencyFind customers based on the recency of their last purchase compared to other customers
Customer’s purchase frequencyFind customers based on the frequency of their purchases compared to other customers
Customer’s purchase total spentFind customers based on their lifetime value compared to other customers
Customer’s email open recencyFind customers based on the recency of their last email open compared to other customers
Customer’s email open frequencyFind customers based on how times they’ve opened compared to other customers
Customer’s click recencyFind customers based on how recently they’ve clicked compared to other customers
Customer’s click frequencyFind customers based on how frequently they’ve clicked compared to other customers

Combining Filters in a Segment Block

Segment blocks are a set of conditions that Rejoiner will use to find a specific set of customers. Each block contains filters from one context only. You can add as many blocks as needed in order to form a query.

To start building, you must first select your context:

Then select the filter from that context you want to use.

Some filters have additional arguments like timeframe and count.

Using the Timeframe Argument

This argument will help you determine the timeframe to look at for your query. By default, the app will default to the “at any point” option if nothing is selected for this argument.

The following options are available for the timeframe argument:

OptionDescription
At any pointUse this option for when you want a customer to qualify regardless of when something happened.
Less than # days agoUse this option for when you want a customer to qualify based on the recency of the event.
More than # days agoUse this option for when you want a customer to qualify based on the recency of the event.
Between specific datesUse this option for when you want a customer to qualify based on specific dates.
As first instanceUse this option for when you want a customer to qualify if the filter matches their oldest session.
As last instanceUse this option for when you want a customer to qualify if the filter matches their most recent session.

Using the Event Count Argument

This argument is attached to all filters dealing with purchases & email activity. It will help you determine the count of a behavior. This argument is used along the timeframe argument and your query’s main filter.

By default, the platform will default to the “at least one” option if nothing is selected for this argument.

The following options are available for the event count argument:

OptionDescription
At least onceUse this option to check whether an event has occurred at least one time.
Exactly # of timesUse this option to check whether an event has happened a specific number of times.
More than # of timesUse this option to check whether an event has happened more than a specified number of times.
Less than # of timesUse this option to check whether an event has happened less than a specified number of times.
OnlyUse this option to check whether an item was the only item ever purchased / abandoned / viewed. We recommend only using this option with positive filters. Example: “Purchased an item whose name…”
NeverUse this option to check whether an item has never been purchased / abandoned / viewed. We recommend only using this option with negative filters. Example: “Did not purchase an item whose name…”

Once you have built your segment, go ahead and click on the “Save Changes” button at the top right of the builder. Alternatively, you can also select the “Cancel Changes” if you are not ready to push a query out.

Segment Completion

Once you have saved your query, the platform will begin working on your query.

You will receive an email—similar to the example below—as soon as the query is completed and your segment has been updated.

Queries can take a long time or very little time depending on the total number of contacts in your account. The segment may take longer to build if it uses a complex set of filters. We’re improving performance and build time rapidly.

Segments update every 24 hours from the time of creation. We may look to increase the update frequency in the future.

Updated about a month ago


Building Segments


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.