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

 

  1. Choosing your application
  2. Basic notification
  3. Advanced features
    1. iOS settings
    2. Android settings
    3. Custom data
    4. Events
    5. Schedule
  4. Validation warnings

 Choosing your application

My Apps tab is the entry point for choosing your application and starting to send notifications.

Choose your application:

Sending notifications > Capture.PNG" data-location="PushApps > Sending notifications > Capture.PNG">
 Basic notification

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.

Sending notifications > Capture1.PNG" data-location="PushApps > Sending notifications > Capture1.PNG">
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

 Advanced features

By checking the You Can Add Features checkbox, you can enrich your notification with special features, general and platform related:

Sending notifications > Capture2.PNG" data-location="PushApps > Sending notifications > Capture2.PNG">
 iOS settings

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.

Sending notifications > Capture3.PNG" data-location="PushApps > Sending notifications > Capture3.PNG">

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.

For handling values received in the notification please refer to Handling Push Notifications in the iOS reference

 Android settings

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

 Custom data

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:

 Events

You can apply segmentation by creating notifications that will be automatically send to specific devices according to their events in the application.

For more information please refer to Users Segmentation.

 Schedule

You can apply scheduling rules to your notification.

For more information please refer to Scheduling your notifications.

Sending notifications > Capture4.PNG" data-location="PushApps > Sending notifications > Capture4.PNG">

 Validation warnings

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:

Sending notifications > Capture5.PNG" data-location="PushApps > Sending notifications > Capture5.PNG">
However, if there were issues with your content, you will see warnings in a red color text, for example:

Sending notifications > Capture6.PNG" data-location="PushApps > Sending notifications > Capture6.PNG">
Possible warnings:

When done validating, click on Send it ! and the notification will be sent.

Icon

It might take a few minutes for notification to arrive - specially if it is being sent to many devices. You can always check the sending status in the Statistics tab