Push Notifications

Mobile Center Push allows you to engage your users by sending them targeted push notifications.

How to set up Push Notifications

In order to set up Push Notifications, you will have to set up the Push Mobile Center SDK, as well as the platform specific push services (Firebase Cloud Messaging (FCM), Apple Notifications Service (APNs), Windows Notifications Services (WNS). These instructions can be found in the Mobile Center Push portal, as well as in the Mobile Center SDK docs. You can follow the instructions provided in the Mobile Center portal, along with our detailed instructions found in the following links:

Sending Push Notifications

Once Mobile Center Push is configured following the instructions above, you are ready to start sending notifications to your users. By clicking the "Send Notification" button on top right of the page, a panel will show up where you will have to include:

  • Campaign Name: this name will be used to track the campaign but your users will not see it.
  • Title: title of the notification that your user will receive.
  • Message: content of the push notification.

You can also attach custom data along with your notification. More information on this can be found later in this document.

Send Notification

The next step is to select your target. You can send the notification to:

  • All registered devices: all your users with push notifications opt-in will received the message.
  • Custom devices list: the notification will be sent to the list of install IDs that you include. You can get the install IDs by using our API.
  • Audiences: this will send a notification to a segment of your users based on a set of device and custom properties.

Custom Data in your notifications

You can send optional custom data as part of the push payload. The data will be sent in the key-value format. This custom data can be intercepted in the app through Push SDK callback. Documentation for this can be found in the our Push SDK docs.

There are few reserved keywords in each platform that can be set via custom data:

iOS:

  • badge: Add this key when you want to modify the badge of your app icon. If this key is not included, the badge is not changed. To remove the badge, set the value of this key to 0.
  • sound: Add this key when you want the to play a sound. The value of this key is the name of a sound file in your app's main bundle or in the Library/Sounds folder of your app’s data container. If the sound file cannot be found, or if you specify default for the value, the system plays the default alert sound.
  • content-available: Add this key with a value of 1 to configure a silent notification. When this key is present, the system wakes up your app in the background and delivers the notification to its app delegate. For information about configuring and handling silent notifications, see Configuring a Silent Notification.
  • mutable-content: Add this key with a value of 1 to enable media attachments. The application needs to support a service extension to download and handle the attachment content. For more information you can refer to Apple documentations.

Android:

  • color: The notification's icon color, expressed in #rrggbb format.
  • icon: The notification's icon.
  • sound: Add this key when you want the to play a sound when the device receives the notification. Supports default or the filename of a sound resource bundled in the app. Sound files must reside in /res/raw/.

Windows:

  • audio: Add this key when you want the to play a sound. this will modify the audio attribute for toast notifications.
  • image: Add this key when you want to modify the image attribute for tile and toast notifications.