Prepare your project
Follow this guide to get your project ready before creating your first journey
Last updated
Follow this guide to get your project ready before creating your first journey
Last updated
Before creating your first campaign with Pushwoosh Customer Journey Builder:
Create a project and configure platforms in your Pushwoosh account.
Integrate the Pushwoosh SDK into your app or website.
Make sure users can subscribe to your notifications.
Prepare segmentation, content, and anything else you may need to launch journeys.
Below you will find detailed instructions for each of these steps.
Skip this step if you have already configured the project where you want to create a journey.
Create a project in your Pushwoosh account using this instruction. You can configure several platforms within one project. For example, if you select Mobile push for start configuration, you can also set up Web and Email platforms at any time.
Configure the platforms to which you want to send notifications:
To configure mobile platforms, follow the iOS configuration and Android configuration guides.
To configure web platforms, refer to the Chrome / Firefox configuration and the Safari configuration guides.
If you want to send emails, verify your email address and domain by following the Email configuration guide.
More about configuring platforms
Make sure you have integrated the appropriate SDK into your app or website:
Users should be able to subscribe to your app's or site's notifications — otherwise, you won't be able to send them pushes and emails.
To send mobile and web pushes, encourage users to opt in by showing them the in-app message. Then, use the registerDevice
API method to register new subscribers for your pushes.
To send emails, first collect users' emails and use the registerEmail
API method to register new email subscribers for Pushwoosh.
Depending on the elements you are going to use in your journey, you may also need to prepare Events, Tags, Segments, Push content, Email content, and Rich Media in your project.
Events are actions users perform in the app or on the website. They are recorded by the Pushwoosh SDK and can trigger various behavior-based communications. Each configured Event can be used in the following elements of a journey:
Tags contain data that you associate with a particular user or device: username, ID, city, preferences, etc. Using Tags, you can create Segments and update user profiles in a journey.
Segments (previously called Filters) are groups of subscribers complying with the conditions you specify. You can build Segments based on Tag values, triggered Events, or both. You can also use automatic RFM Segmentation. Segments will help you target specific users with specific messages increasing communication relevance and thus boosting open rates.
Segments can be used in the following elements of a journey:
Pushwoosh empowers you to create reusable push content. You can craft the text and configure settings using our push content editor and then either send the push notification immediately or save it for future campaigns. Learn more about creating push content
You can craft your email content using the editor that best fits your needs:
The Drag & drop email editor, perfect for marketers with no coding skills. Learn how to create content with the Drag & drop editor.
The HTML code editor, offering the ability to generate emails using code and granting greater control over email customization. Learn how to create content with the HTML code editor.
Rich Media are rich content pages deeply customizable to the needs of your business and the 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 it is 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 createMessage
API 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, send an email to a selected list of addresses:
Prepare email content using Drag & drop email editor or HTML code editor.
Go to Campaigns → Create campaign → Email → One-time campaign.
Create a Segment with a list of addresses you want to send a test email to.
Select email content you want to send and set up your email.
Click Launch campaign.
Now you are all set to create your first customer journey! Go to the Customer Journey Builder section and click Create Campaign:
Check out this step-by-step guide on creating a test journey using our demo app.