You must have at least one device registered in your application in order to send notifications. If you don't have any devices registered please refer to the mobile SDK guides or to the testing guide
- Choosing your application
- Basic notification
- Advanced features
- Validation warnings
Choosing your application
My Apps tab is the entry point for choosing your application and starting to send notifications.
Choose your application:
Once you have chosen your application, go to Main tab within that application.
You can send a quick basic notification which will contain just text , and you can select which platform you wish to send it to.
When you are done composing the message, click on Click To Push It! and review the form before sending. you might be prompted with Validation warnings
You can also enrich your notification with special features, general and platform related:
Badge - will appear above the application icon, usually indicates number of new notifications. Opening the notification by clicking or sliding it will clear the badge, for manual clearing of the badge please refer to Clear notification badge in our iOS Reference.
Sound - name of sound file to play when receiving the notification. The sound files must be in the main bundle of the client application (you just need to import this file to your Xcode project). If you want to keep the default notification sound keep the value as default, if you want the notification to be silent leave the value empty. For more information please refer to Apple developers.
Category ( iOS8 interactive notifications) - take action directly from your push notifications, as seen in Apple's documentations
For handling values received in the notification please refer to Handling Push Notifications in the iOS reference
Title - An Android notification can also contain a title, which will be visible at the notification screen of the device. If you leave the value empty, the application name (as set in the application itself) will act as the title.
Sound - name of sound file to play when receiving the notification. If you want to keep the default notification sound - don't set any value. The file must be placed inside the raw folder of the app.
For handling values received in the notification please refer to Properties on the Android reference
Link - a link to a web page. If this value is set, opening the notification will open the link in the device's external browser.
Custom JSON - If you need to give extra data, you can supply them in a JSON formatted key - value string. Key will be the key of that entire JSON string in the data object received in the notification. Value is the JSON formatted string containing the relevant information.
For handling custom data please refer to:
Don't always send the same notification to all of your users, apply PushApps smart segmentation tool to for better targeting and higher conversion rates!
For full documentation please refer to our segmentation section.
You can apply scheduling rules to your notification.
For more information please refer to Scheduling your notifications.
Once you are with composing and setting your notification , click on Click To Push It! for us to validate the notification before sending.
If we encounter errors that prevent us from sending the notification you will be alerted with a note at the top of the screen.
If we only find warnings we will display them in red in the validation form, you can choose to go back and fix those issues or ignore and continue.
A clean free of warnings validation form will look like this:
However, if there were issues with your content, you will see warnings in a red color text, for example:
- Link might be invalid - don't forget to start with http:// or https://
- Notification has too many characters ( limited by Apple to 255 Bytes ) - The notification payload consists of the messages, and the extra data such as link, custom JSON and sound, if its size is over 255 Bytes it might be truncated and this can result in unexpected behavior.
- Notice, You already configured notifications for this Event. If you proceed, more than one notification might be sent for this event.
When done validating, click on Send it ! and the notification will be sent.