First steps
User Data
- Responsive Email Editor Review
- Designing your email
- Creating Synchronized Modules
- Setting Up Responsive Email Design
- Setting Up Smart Containers
- Creating a Gmail Promotions Annotation
- Adding The Rollover Effect
- Adding Anchor Links
- Module Library
- Adding a Table to an Email
- Adding Custom Fonts
- Creating CTA Button
- Working with Images
- Creating Timer
- Using AI in the Email Editor
- Messenger Protocol Support in Email Clients and Platforms
Omnichannel
- Setting Up Widgets for Your Site
- Widgets Gamification
- Widget Calling
- Setting Up Locations for the Widget Calling Rules
- Storing data from widgets to contact fields
- Using Annoyance Safeguard
- Actions After Form Submission
- Replacing Double Opt-In System Workflow
- Creating Pop-ups via Google Tag Manager or WordPress
- Sending Yespo Widget Events to Google Analytics
- Using A/B Tests for Widgets
- Collecting Contact Information Using Request Forms
Automation
- Building and Editing Workflows
- Configuring Workflow Start/Stop Conditions
- Start Block
- Popular Blocks
- Message Blocks
- Using One from Many Message Block
- Contact Blocks
- Conditions Blocks
- Other Blocks
- Message to Segment Blocks
- Time Blocks
- Advanced Workflow Block Parameters
- Setting Up Allowed Send Time
- Using Workflow Launch History
- Webhook Workflows
- Workflow Troubleshooting
- Double Opt-In
- Welcome Сampaign
- Welcome Series Segmented by Category
- Launching a Workflow After a Contact Import
- Regular Workflow for a Segment
- Birthday Campaign
- Linking Workflow to the Button
- Using Variables from Order in Workflow
- Collecting Order Feedback
- Customer Reactivation
- Sending Extra Campaigns
- Sending Reminders at the Time Specified by the User
- Sending Campaign to Those Who Did Not Open the Previous One
- Using A/B Tests In Workflows
Personalization
Analytics
- Email Campaign Report
- Web Push Campaign Report
- Viber Campaign Report
- Mobile Push Campaign Report
- App Inbox Campaign Report
- Telegram Campaign Report
- In-App Report
- Widget Report
- Triggered Campaign Report
- AMP Campaign Report
- SMS Campaign Report
- Multilingual Campaign Report
- Setting up UTM Tags
- Revenue from Campaigns
- Tracking Campaign Performance in Google Analytics 4
- Message Analytics
Multilanguage Campaigns
Events and Behaviour Tracking
Recommendations
API
Security and Compliance
Creating Mobile Push Messages
In this guide, you will learn how to create mobile push notifications.
Important
To send mobile push messages via Yespo, you need to set up a connection between your mobile app and our system.
Once you set up the integration, you can prepare and send your mobile campaign.
Creating New Mobile Push
Go to Messages → Messages → select the Mobile Push section in the left sidebar. Click the New Mobile Push button.
Main settings
Fill in the following fields:
- Name. The system name that the recipient will not see.
- Title. Required field, the recipient will see its value in the message.
- Subtitle. Optional field, which value only iOS users will see.
- Text. The main content of a push message is up to 40 characters long. Please note that the display of the message may vary on different devices.
5. Personalization. Use the dynamic variables to add a name, city, bonuses or any personal data available in the user profile. Click on the Personalization icon in the Title, Subtitle or Text field to select data.
6. Image. Add a 2:1 aspect ratio image, approximately 512x256, to your message body. Larger images will be scaled. The typical file size is up to 5 MB. For iOS, you can upload a GIF file that will display as a static image on Android.
- Image — one picture.
- Image carousel — up to 10 scrolling images. The carousel is available on Android and iOS devices. Before using the image carousel for iOS, you must set the content extension.
7. Link. The URL can be opened by a device browser or as a deep link to a specific location within your mobile app. If no link is specified, a tap on the push notification will open the app. Also, you can set an individual link for each user using the personalization option.
8. Buttons. Use buttons to trigger any event. For example, some answer options or the transition to the specified URL. When a recipient touches the screen for an extended period of time (long pressing), it displays the actions assigned to your push notification.
Note
- We do not recommend using links with the HTTPS protocol in mobile pushes because, after the first click, the user will see a pop-up window asking where to open the link — in a browser or in a mobile app.
- For the user to immediately get to the desired screen of the app by clicking, use links of the format “myphotoapp:Vacation?index=1”. Read more >
- For iOS, you can add up to four buttons; for Android — up to three.
To add the action buttons to your mobile push notification, click + Add Button and enter the following parameters:
| Parameter | Description |
| Action ID | A unique identifier of the button action. |
| Text | The text that the button displays. |
| iOS icon path | The icon associated with an action. Available in iOS 15 and later. Enter the name of an image in your app’s bundle, preferably in an asset catalogue. |
| Launch URL | A URL or a deeplink that opens when the notification is selected. |
| Custom data | Additional parameters associated with the button in JSON format. |
Note
You must enter the values in Action ID and Text for a button to work correctly. Use different Action IDs when you add several buttons.
To learn more about notification action icons, see Apple documentation.
For click event handling, you can use your preferred tools.
Also, you can use our SDK for this purpose. Learn more about installing and using our SDK for mobile apps.
9. Tags. Select tags from the list or enter a new one and click Enter. Use tags to filter search results and set campaign frequency strategy.
Additional settings
Fill in the following fields:
- Custom data. You can create push notification messages using custom data in JSON format. If custom data is used in a multilingual message, it can be applied to all language versions. To do this, activate the Use custom data from the default language version for all versions switcher. If the switcher is disabled, different custom data can be used in each language version.
Also, you can use dynamic variables to add data into the Custom data parameter: message name, first name, city, and so on. Click on the personalization icon and select the required.
Note
This option will only work if your app supports custom data, regardless of the user’s device. Please make sure that your app’s developers have provided this option.
2. Sound. A sound to play when the device receives the notification.
3. Unread messages badge. By default, each notification increments a number displayed in the long-press menu. To display arbitrary values, activate the switcher and specify the desired number. For example, you can enter a value greater than the real one to attract attention or, conversely, lesser so as not to disturb the user with many unread messages.
4. Annoyance level. Prioritize your notifications to protect subscribers from intrusive messages.
5. Subscription categories. These settings help deliver content to the right users based on their preferences.
6. Time to Live (TTL). TTL — the period after which the message will not be displayed if it has not been delivered by this time. By default, it’s 1 day, but you can select other options.
Note
Your organization’s logo is added to the mobile push notification from your app automatically.
Multilingual version (optional)
In our platform, you can create a multilingual version of any message. Click the Globe icon in the top panel, specify the default language, and add language versions. Fill each version with the content in the corresponding language. You can switch between versions within one template in one click.
Learn more about multilanguage >
Testing Message
1. Test the messages by clicking the Test button on the top panel.
2. In a popup window, enter a phone number enter email, contactID, or phone number linked to the mobile push token.
- Under Application, select the app in which you want to send your push notification. If you have only one app, it will be selected automatically.
- Under Search, enter email, contactID, or phone number to send your push notification to.
If the contact with the specified phone number is an app user, you will see such status:
It means the provided contact data has a matching mobile token. You can send a test notification to this contact. Otherwise, you will receive the next notification: The contact does not have an application token.
After sending your test mobile notification, you’ll see how your push notification will look on the device it’s sent to. There are three options for how your push notification can be displayed:
On iOS: Push notifications display as a banner in the notification tray.
On Android:
- A cropped push notification is displayed in the push notification drawer.
- The push notification is expanded in the push notification drawer.
