Journey elements

Journey elements are points of communication and controls needed to create a journey:

To add an element to a journey, drag-and-drop it from the left pane to the canvas, or pull it out of the circle on the previous element.

Adding elements

To delete an element, click it once and press the Delete button on the top.

Deleting elements

To edit an element, click it twice and fill in the fields of the pop-up window appeared.

Editing elements

Start Event

Start Event is a specific action user performs starting the journey.

To add the Start Event, drag-and-drop it from the left pane to the canvas. To specify the Event, double-click the Start Event element, select the app, and choose the Event from the drop-down menu on the pop-up appeared. Then, press Apply to save changes.

Important!

Make sure to include HWID (hardware ID) into your /postEvent API request for the Start Event of the journey. Otherwise, users won't enter the journey.

UserID is not applicable for identifying users in Customer Journey.

Adding Start Event

Events should be created in advance. Click here to learn how to create Events in your own app.

If needed, you can specify attributes of the Start Event so that it'll start the journey only if the event is triggered with those specific attributes. To do so, press the Add condition button when editing the element. Select an attribute from the drop-down and set its operator and values in the corresponding fields.

Start Event with attributes

You can add multiple Start Events — in that case, any of them will start the journey. Each Start Event could start their own journey but all of them should end at the same Exit point.

Several Start Events starting a single journey

Start Segment

Start Segment is a pre-built segment of a particular app's users who will enter into your journey.

Start Segment should be built by Filters in your Pushwoosh account. A segment consists of users who comply with Filter’s conditions. Learn more about Filters from the guide.

To add a Start Segment, drag-and-drop it to the canvas and double-click. In the pop-up window opened, choose an app and a Filter to apply.

Adding Start Segment

Once the journey is activated, all subscribers of the chosen app who comply with Filter conditions (i.e., having corresponding Tag values assigned to their device or user ID) will enter the journey. After that, no more users enter this active journey even if the Start Segment is extended with some new users later. To apply the same Start Segment again, clone the journey and activate it.

No timezone-sensitivity

Please be aware that users' timezones won't be taken into account when sending messages to the Start Segment. All users will receive your messages simultaneously with no regard for the timezone set up on their devices.

Users from the Start Segment enter the journey only once. That means if a user complying with the Start Segment conditions enters the journey and goes through it, that user won’t fall under this journey’s entry conditions again.

Combining entry elements

You can add multiple entry elements — in that case, any of them will start the journey. Each entry element could start their own journey but all of them should end at the same Exit point.

If you use both Start Segment and Start Event simultaneously, conditions of both will apply but not intersect. That means the journey will include users who comply with the Start Segment conditions and those who trigger the Start Event. These sets of users may or may not intersect; not intersection enters the journey, but the whole sets in a union. After entering, all users will have the same flow through the journey.

Send Push / Send Email

Send Push or Send Email element indicates a point to communicate with a customer with a push or email message.

To send a message at some moment of the customer journey, add the Send Push or Send Email element to the canvas following the event you consider to be the appropriate basis for communication. Choose the app and the Preset you'd like to use.

Adding Send Push element

Please be aware that if any segmentation rules are saved in a Push Preset you choose for a Journey, they won't be applied to the Journey.

Send In-App

Requirements

For Android, the OS versions 6.0 and later are supported.

To show the In-App to users within the journey, add the Send In-App to the canvas next to any element. Choose an app and a Rich Media page to be shown.

Adding Send In-App element
  • If your app is opened at the moment the Send In-App element is triggered, the In-App will be displayed immediately.

  • If the app is closed, the In-App will be displayed the next time the user opens the app.

Important!

In-Apps are displayed to only those users who have subscribed to push notifications.

To target all users, even those who opted-out from receiving push notifications, consider using the In-Apps outside the journey in your Pushwoosh projects.

Wait until

The Wain until element delays the next journey element for the specified period or until the specified time. To set up, add the Wait until element to the canvas and double-click it.

To set the exact time the user will continue the journey, check the Wait until checkbox and set the time in 24h format. Users will go to the next journey element once the specified time passes in their timezone. If the time has already passed in the user’s timezone, that user waits till the next day.

Adding Wait until element

To set the time to wait after the previous element triggered, check the Delay for checkbox and set days, hours, and minutes to wait before triggering the next journey element.

The possible delay period is limited to 90 days.

Setting a delay

True/False Splitter

True/False Splitter uses Filters created in your Pushwoosh account. To learn more about Filters, please refer to the guide.

Splitter divides the journey into two separate branches based on segmentation. Choose a Filter from your Pushwoosh account to constitute the first segment. Customers who do not fall under Filter's conditions will go through the second branch of the journey. Each branch can include any elements following the True/False Splitter and end with its own Exit.

You can add as many Splitters as you need, even flowing out of each other.

Using a True/False Splitter

Wait for event

Events should be created in advance. Click here to learn how to create Events in your own app.

Wait for event element lets you set different communication scenarios based on whether a user triggers a particular event within specified time period or not. For example, to recover the abandoned shopping cart, set up the Wait for event element as follows:

Adding Wait for event element

Users who add some products to their cart and purchase within five minutes will exit the journey right after the CheckoutSuccess event is triggered and won't receive any messages. To those users who don't purchase in five minutes after the entry event, you can send a message reminding of items in their carts.

The waiting period is limited by 90 days.

You can add several events in a single Wait for event element, and specify attributes for each of them. User who triggered any of the events specified will follow the [Triggered] branch of the journey.

Set tags

To assign tag values to users within the journey:

  • Add the Set tag element wherever you'd like on the canvas.

  • Choose an app which tags you're going to set.

  • Press Add tag and select a tag from the drop-down list containing all the tags created in your Pushwoosh account.

  • Specify values for the tag selected depending on its type.

You can set up to 10 tags at once.

For user-specific tags, values are assigned to all user's devices with the same user ID. For tags that are not user-specific, values are assigned to a particular device a user's traveling the journey with.

As for use cases, there are plenty of. For example, tagging users who reach a particular journey stage comes in handy when building further communications. Setting tag values according to events users trigger or their attributes, you can communicate to that users more personally and send them personalized offers.

Exit

Exit is a point where the journey ends. Once you specified all communications in a single journey, add the Exit element to complete it.

Setting Exit from the journey