Getting started

Customer Journeys can be linked to any of the apps you have in your Pushwoosh Control Panel.
You can use any of the apps configured in your Pushwoosh Control Panel with Pushwoosh SDK integrated. If you don't have apps yet or need a new one to link to a journey, create an app in your Pushwoosh account.
Here are the steps to follow before you start creating journeys:

1. Create an app (if necessary)

To create a new app, press the Applications link on the left side menu of the Customer Journey dashboard. You'll be redirected to your Pushwoosh account's Applications section; follow the guide to create an app.

2. Select project type

Choose an appropriate project type — Mobile Push project, Web Push project, or Email project. Each of these project types has its own purposes and capabilities; each project is configured with platform-specific credentials and is used for communications through a particular channel:
  • Mobile Push — for iOS and Android apps,
  • Web Push — for Chrome, Firefox, and Safari,
  • Email — for email messaging.
Project types
Be aware that a project of a particular type is configured for mobile, web, or email only. If you'd like to perform cross-platform communications within a single app, press Create a multi-platform project.

3. Configure project

4. Integrate SDK

Make sure you've integrated the appropriate SDK into your app or website:

5. Subscribe users

Provide users can subscribe to your app's or site's notifications — otherwise, you won't be able to send them pushes and emails.

Push subscribers

To register users for pushes, use the registerDevice API method.
To let users opt-in for push notifications, use the Subscription Prompt — a handy tool to manage subscriptions and encourage users to subscribe.
Subscription Prompt default widget
To migrate the existing mobile user base to a newly created or any other app, please apply to our Customer Support team as described in the article.

Email subscribers

To collect users' email addresses, define where and when it's appropriate (for example, on the app login page) and use the registerEmail or registerEmailUser API method.
Please note that the registerEmailUser request does not register an email address in your userbase; it should be used only to assign User IDs to emails already registered by the registerEmail call.
To associate your app users or site visitors with their email addresses, use the User IDs. That allows you to build cross-channel Customer Journeys and send emails based on user's actions in your app or on the website.
1. Get the User ID.
Each device registered for your Pushwoosh project has its User ID; by default, it's equal to the device hardware ID (HWID) and is retrieved by the registerDevice API request.
To set a custom User ID, call the registerUser method.
2. Assign the User ID to an email address.
Use the registerEmail or registerEmailUser API method to associate the User ID with an email address.
3. That’s it!
The same User ID is assigned to a particular device and a specified email address. That means Pushwoosh considers both app user and email addressee the same person so you can reach out to them by pushes and emails within a cross-channel Customer Journey.

6. Prepare your project

Make sure you have all required Events, Presets, Filters, and Email Templates prepared for the app you're going to use in a Customer Journey.
Events generally are some actions users perform in the app or on the website. They are recorded by Pushwoosh SDK and can trigger various behavior-based communications. Each Event you've integrated into your project and configured in Pushwoosh Control Panel can be used in your Customer Journey as an entry point, decision splitter, or journey effectiveness tracker.
Read more on Events.
Events list
Push Presets are fully configured push messages just waiting to be sent. Creating Push Presets, you don't have to enter push content each time you're going to send a message — simply select the preset from the list, and here we go.
Email Presets are the obligatory prerequisites for using emails in Customer Journeys. To create an Email Preset, prepare an Email Template first, then save a Preset configured with a subject line and "From" email address.
Learn more about Presets.
Segments (ex Filters) are used to split journeys into branches as well as to start journey with a segment of users. Segments are groups of users complying with filtering conditions you specify with Tags and their values. Using Segments, you can target specific users with specific messages increasing communication relevance and thus boosting open rates.
Rich Media are rich content pages deeply customizable to the needs of your business and specifics of your app. There are some default Rich Media templates in every Pushwoosh account so you can customize their appearance and content or, if needed, create your own templates.
Rich Media is required to show In-Apps to your app users.

7. Check everything's ok

Once everything's set up, check whether it works as supposed to. There are several options to test sending messages to your app or site subscribers:
  • Register your device as a test one and send push messages to test devices only.
  • Target your device by HWID, push token, or userID using the API createMessage request.
  • Assign a unique Tag value to your device, create a Segment using this Tag value, and use it in your test messaging.
To test email configuration, enter an email address you'd like to send a message to on the Audience tab of the Send Email section in your Control Panel.