Customer Journeys can be linked to any of the apps you have in your Pushwoosh Control Panel. Communications may be performed across all apps or within a single app. For example, a user triggers an Event in one app, and then you send them a push notification from another app to encourage their interaction with that other app. Or, in other cases, you can follow up the Event triggered in an app with some message from the same app to strengthen in-app engagement.
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:
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; here, press Add new.
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.
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.
To configure an email project, verify your email address and domain by following the Email configuration guide.
Make sure you've integrated the appropriate SDK into your app or website:
Provide users can subscribe to your app's or site's notifications — otherwise, you won't be able to send them pushes and emails.
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.
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
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
2. Assign the User ID to 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.
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.
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.
Filters are used to split journeys into branches as well as to start journey with a segment of users. Filters are compilations of tags and their values which form user segments. Using Filters, 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.
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: https://docs.pushwoosh.com/platform-docs/manage-projects/test-devices
Target your device by HWID, push token, or userID using the API
createMessage request: https://docs.pushwoosh.com/platform-docs/api-reference/messages#createmessage
Assign a unique Tag value to your device, create a Filter using this Tag value, and use it in your test messaging: https://docs.pushwoosh.com/platform-docs/segmentation/tags-and-filters
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.