Journeys is a visual campaign builder that lets you create omnichannel messaging experiences for your users.

Overview

Journeys are ideal for engaging users across the lifecycle of your app.

To list a few sample use cases:

  • Build User Onboarding Journeys that engage users over several days or weeks and on different channels as you educate them about your service.
  • Build Promotional Journeys to entice your users to transact at different points of time.
  • Long-running re-engagement campaigns to pull users back into your service if they begin to slip away.

You can access Journeys under the “Engage” section of your CleverTap Dashboard. Click on the “Journeys” link in the left nav bar in your CleverTap Dashboard. Once on the page, you can click on the “create” icon to create your first journey.

Journeys are only available to customers who are on the Essentials plan.

Journey Components

A Journey is a combination of Segment nodes and Engagement nodes. You can connect Segment nodes and engagement nodes to each other to create powerful automation.

Types of Segment nodes

Segment Node
What it does
Description

Action

As soon as the user performs an action, the user enters this node.

Qualification to this node occurs as soon as the user performs the said event.

Inaction

Segment users who did the 1st event, but did not do the 2nd event within a specified time interval.

E.g. Qualify users who added to cart, but did not purchase within 5 mins.

Past Behavior

Segment users who performed and did not perform a set of events in the past n days.

E.g. Users who did Video Watched AND did not do Subscription Paid in the Last 30 days.

Date Time

Segment users based on a date time property value like flight time, etc.

E.g. Users who have their flight after 2 hours.

Journey Trigger

You can use this node in the entry criteria only.
A user is qualified on this node when the same user is qualified for the corresponding node in another Journey, from where the current Journey is triggered.

E.g. Journey 1 has a Push message node. You want to move all users who were sent the push into another Journey. Journey trigger allows you to do this.

Page Visit

Segment users as soon as they visit a specific page.

Web based segment.

Referrer Entry

Segment users based on a referring website or campaign.

Web based segment.

Page Count

Segment users based on the number of pages visited by them.

Web based segment.

Custom list

You can use this node in the entry criteria only. You can upload custom lists of users for engage in the Journey.

Custom segment. For example, users from your Retail Point of Sale (POS).

Building Your First Journey

Step 1: Define the Entry Criteria

When you start building your Journey, you need to define your “entry criteria”, this is the condition, which when met, users will enter and be a part of the Journey. The entry criteria of a Journey is essentially the segment of users you want to target.

The various types of segments you can use are:

  • Live User segments: These segments qualify people as soon as they meet your specified criteria
  • Past Behavior segments: In this type of Entry Criteria, users who match your specified entry criteria will qualify once every twenty-four hours.

Live user segments are further bifurcated as follows:

  • Action: In this type of Entry Criteria, users will enter your Journey, as soon as they perform an event. Example: Enter people into your Journey, as soon as they install your application.
  • Inaction: Users enter your Journey, as soon as they don’t do something in the future. Example: If someone adds an item to their cart, but don’t transact within 15 mins.
  • Property Date-time segments: Qualify a user relative to a specific date and time in a property.
  • Page visit: Users will qualify as soon as they reach a web page that matches your specifications.
  • Refer entry: When users come to your website from a certain referrer, example: Facebook, or Twitter, they will be qualified for your Journey.
  • Page count: As soon as the user sees the specified number of pages, they will be a part of your Journey.

Journey Scheduler

We support One time, Multiple date and recurring Journeys.
E.g. For monthly payment reminders, you can schedule a Journey to start on the 1st of every month

Step 2: Select a Journey Timeout

Journeys are sequences of campaigns. At each stage of a Journey, you can choose to further segment your audience as well as deliver campaigns across multiple channels.

While creating Journeys, you can choose to specify a Journey Timeout, this will be the maximum amount of time a user will spend in a Journey. Once this window is completed for a user, they will be exited from the Journey, no matter which stage they are at.

Once a user has exited the Journey, the user is free to re-qualify, if you have allowed re-entry in your setup.

Allow Users to Re-Enter a Journey
By default, a user will qualify for a Journey only once. However, you can optionally allow users who have exited from a Journey to re-enter it should they meet the entry criteria at a later date.

Once a user is a part of a Journey, the only way they can re-qualify is if they exit the Journey, either by matching one of the specified goals, or by being forced out of the Journey and subsequently meeting the specifications of the entry criteria.

Take the following simple example.

When a user makes a purchase they enter into the Journey. After a 20 minute wait time qualifying users will receive a Push Notification with a discount promotion code.

If the Journey was set-up with the default behavior (users cannot re-enter the Journey) then after they purchase and receive the push notification they exit from the Journey. If a user makes another purchase subsequent to the initial purchase they will not receive another promotional Push Notification since this Journey does not allow for re-entry.

If however, your intent is to allow users to receive a new promotional discount after each subsequent purchase, you’d select the option to allow a user to re-enter as follows.

Step 3: Define the Journey

Connect Segment & Engage Blocks
Once you have defined a segment of users, you can choose to communicate with the segment by dragging and dropping a channel of communication from the palette on the right hand side. This communication could go to users who match the segment criteria specified by you, or to the rest of the users i.e. the users who don’t match your segment criteria.

Connect Engage & Segment Blocks
After a user receives a message, you can add a segment after that to ensure that only users who meet the criteria specified by you are taken further in the Journey.

Example: After users receive a push notification, wait for 1 day, check if users have transacted, for the people that have transacted, send them down path A, and for those who haven’t send them down path B.

Connect Engage & Engage Blocks
After a user receives a message, you can follow it up immediately, or with a delay with another message on a channel of communication of your choosing.

Example: After a user receives a push notification, you can wait for 3 days, and send another push notification.

Connect Segment & Segment Blocks
After a user has been segmented, you can follow it up with with another segment to further refine your Journey.

Example: If someone has not transacted in the last 30 days, send users who qualify for this segment down path A and if one of these users adds and item to their cart, and doesn’t buy within 15 mins, send them down a specific path.

Note

You can apply campaign limits in a Journey. However, global throttling is not supported in Journeys.

User Flow Management

Your users perform one action in a Journey and then move on to the next action. However, there may be instances when they do not move forward in the Journey.

Users waiting at Segment node

There may be users waiting at the Segment node. For example, there may be users who added a product to the cart and did not buy it. They may have changed their decision or maybe they simply forgot about it. These users are waiting in the Journey until they perform the next action. You must be able to nudge them to perform the next action and continue the Journey.

Segment node

Segment node

You can send these users on a different path or exit them from the Journey completely.

To send them on a different path, set the qualifying period and then send them to the following node to continue their Journey.

Step 1 - Set the qualifying window

Click the hexagon on the Segment node to set the qualifying window for the users.

The qualifying window must be set up in combination with the drawing of the Node Timeout connector. The users will not move if the Node Timeout is not connected to another node.

Node timeout

Node timeout

Step 2 - Connect to another node

Connect the Node Timeout connector to another node. After the qualifying window is complete, the user automatically moves on to the next node through this timeout connector. For understanding node timeout evaluation schedule, please refer to advance section below.

Connect Node

Connect Node

Note

The yellow indicator on your segment node is a reminder that you may need to plan for Waiting users on this node in the Journey.

Users waiting at Engage node

There may be another instance where the users have received a message but they may still wait for action. If the users do not click the message, then they are waiting for the next action. It means that when you created the Journey, the node following the Engage node is connected with a 'Viewed' or 'Clicked' connector. However, we have you covered! When you draw a 'Viewed' or 'Clicked' connector, a Phantom node with a node timeout will appear automatically. You can set the qualifying window from this Phantom node.

Phantom Node

Phantom Node

Force exit users

You can use the Force exit operator node to create an exit for users in the Journey. For example, if you want the users to exit and re-enter the current Journey you can set up this node. Drag the Force exit node from the Operator Node pane and connect it to the Segment node.

Force exit

Force exit

Auto Align & Space

An elaborate Journey may contain multiple overlapping nodes and connections. The Auto Align & Space button will help you add clarity to the Journey canvas.
Click the Auto Align & Space button on the upper right corner of the Journey canvas.
The Auto Align & Space button automatically rearranges and spaces your nodes so that all the stats are visible clearly.

The nodes on the Nodes Stats tab are arranged automatically so that all the stats are visible clearly.

Step 4: Add Goals to Your Journey

Goals are behaviors that you want users to perform. On completing a goal, users are exited from the Journey. You can drag and drop any segment from the right hand side palette and add it as a goal for your Journey. A Journey can support up to 3 goals, if a user completes any one of the goals, they will be exited from the Journey.

Common Examples of Goals

  • Action based goals: In this goal, users will exit your Journey as soon as they perform a goal, in real time. Example: Exit people as soon as they perform the “Charged” event, where “item” is “Red Nike Shoes”
  • Past behavior goals: Past behavior goals, like segments, are evaluated once every twenty four hours, at 12:00 am. Once the goal is evaluated, users who meet this goal will not be a part of the Journey from that day onwards. Example: Exit people if they have spent at least $300 in the last week.

Step 5: Save Journey

We have now successfully built a Journey!

Now that we have built a Journey, save it. You can save a Journey in draft mode so that you can make more changes at a later date or time. All edits are possible to the Journey at this stage.

Click the Save button.

Step 6: Publish Journeys

When you are ready to publish your Journey and all the edits are complete, your Journey can go live. Open the Journey and click Publish. You can view the Journey Statistics page to check the status of your Journey.

Editing a Journey

You can edit only the 'What' section in an engagement node after you publish a Journey.

Advanced Topics

Stop/Pause Journeys

You can Stop or Pause a published journey either from within the journey (top right corner) or from the Journey listing page.

  • Pause will temporarily halt the qualification of new users in the Journey. You can use the same button to resume. Users already in journey will continue travelling through the journey or receiving messages. You can bulk pause or bulk resume paused journeys from the Journey listing page.
  • Stop will completely halt the journey. A stopped journey cannot be restarted. It will stop the qualification of new users, any user movement within the journey, and sending out any campaigns. You can bulk stop journeys from the Journey listing page.

Past Behavior Segments & Journey Qualification

  • If your entry criteria is a Past Behavior segment, users will be qualified for your Journey at the start time specified.
  • If you have added a Past Behavior segment along your Journey that segment will be evaluated once a day at 12:00 am (in the timezone of your account).
  • If you have added a Past Behavior segment as a goal that segment will be evaluated once a day at 12:00 am (in the timezone of your account).
  • Node timeout Evaluation - Node timeout evaluation happens every 1 hour at 1 PM, 2 PM, 3 PM and so on, where start time depends on the account. Here is an example -
    • User A reaches a node 4 at 2:30 PM with node time out of 1 hour. Her window will get over at 3:30 PM after which even if the user performs the action, she will not move via ‘Yes’ path as the user is marked for node timeout. At 4 PM, user A will timeout.
    • User B reaches a node 4 at 3:30 PM with node timeout of 1 hour. Her window will get over at 4:30 PM after which even if the user performs the action, she will not move via ‘Yes’ path as user is marked for node timeout. At 4 PM, user B will NOT move out. At 5 PM (i.e. next evaluation run), the user will move via node timeout.
  • If you have added a Past Behaviour segment in middle of the journey and have drawn Node timeout path with qualifying window set less than 24hours value, all users might move via node timeout path as PBS is only evaluated every 24 hours.

Set Do Not Disturb (DND) for Journeys

CleverTap provides an option for setting the “Do Not Disturb” hours for notification delivery while creating a journey. The DND feature manages message delivery via engaging nodes in journeys so that campaigns are only sent after the DND period or discarded. If users send time-specific messages via journeys where they send notifications to registered users who requested a specific active time and a specific inactive time, notifications will only be sent during the active time.

To set DND for Push, SMS, Email & Web Push journeys, perform the following steps:

  1. On the entry node of a journey, you will see the checkbox for DND.
  1. Click the Do Not Disturb (DND) checkbox.
  2. Select the days and input the times you do not want to send campaign notifications. If you want to use the same time inactive period for each day, click the Copy Time To All link.

DND Conflict Hours

If you schedule a message node to send out delivery during the scheduled DND hours, you will receive an error message. This error message appears at the publish of the journey.

Set Campaign Frequency for Journeys

Campaign frequency provides the ability to define when the messages should be delivered. If a user qualifies outside this window, the message is discarded.

To set campaign frequency for In-app, Web pop-up, or Exit intent nodes in journeys, perform the following steps:

  1. Select In-app and click on the node to edit it.
  1. Click the Set frequency checkbox.
  1. Select the days and input the times you do not want to send campaign notifications. If you want to use the same time inactive period for each day, click the Copy Time To All link.
  1. Click Continue.

Updated 19 days ago


Journeys


Suggested Edits are limited on API Reference Pages

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