Mobile push quick start guide

All you need to know before starting to send push notifications through your mobile apps

Mobile push notifications are messages delivered to your end users through your mobile app where users don’t have to be in the app or using their devices to receive them. They are a powerful engagement tool meant to provide relevant and timely information to your subscribers. Android users automatically give consent to receive pushes when they download the app and iOS users will receive a prompt asking whether they want to receive notifications. If accepted, push notifications will be delivered to the end-user.

Prerequisites: SDK integration

Mobile push notifications require you to configure your mobile applications in your Xtremepush project and that you complete the integration of the Xtremepush SDK. See details on how to achieve this in our dedicated guides for Android and iOS.


Make sure you are setting the user ID

It is recommended that at this stage you use our SDK method to set user IDs by following our dedicated guide to ensure devices can be associated and targeted in your campaigns by your own unique identifier

Testing mobile push notifications



Running tests is encouraged before start sending push campaigns to your customers. You'll find details on how to test below.

In order to test push you first need to opt-in to push for your iOS app. See detailed instructions below:


On iOS, the registerForRemoteNotificationTypes method used when initialising Xtremepush in your App Delegate will cause the push notifications system permissions dialog to appear:

XPush.register(forRemoteNotificationTypes: [.alert, .badge, .sound])
[XPush registerForRemoteNotificationTypes:XPNotificationType_Alert | XPNotificationType_Sound | XPNotificationType_Badge];

Once you do you will see this permission prompt will appear in your app:

Click on Allow to get your device subscribed to push notifications. You would be ready to test sending your device a test campaign. For more details on opting-in from your mobile app and best practices review our dedicated channel opt-ins guide.

Sending yourself a mobile push campaign

Once that you have configured your app, integrated the SDK and enabled push notifications for Android or/and iOS, you will be able to see Android / iOS push as available channels in the campaign builder page.

You can create a push campaign by navigating to Campaigns > Create Campaign > Send now or Schedule Message selecting Android Push or iOS push. Review our mobile push notifications creative guidelines for best results.

You can review more details about how to set up a mobile push campaign from our dedicated Android and iOS guides.

Navigate to the Segment tab to specify the recipients of the campaign. If you have integrated more than one app in your project you need to specify which one you want to target, otherwise the push notification will be sent through all apps. If you want to target your own test device, you can do so by selecting identifier > device ID equals condition in the Segmentation Engine and entering your device ID.


How to obtain your device ID?

Review our dedicated guide to learn how to obtain your device ID.


Count recipients before launching the campaign

Whenever launching a campaign it is a best practice to use the Calculate feature to count recipients and make sure that your targeted audience for this campaign is what you are expecting.


If you haven't received the push notification you can review some of the most common causes. First navigate to Campaigns > Live/Past campaigns > click on the menu to see additional options > Notifications Log.

This page will show one entry for each application that you have targeted for that campaign. By clicking on > Details it is possible to drill down on the details of that campaign and check for any errors.


Troubleshooting: App debug logs

You can turn debug logs to review issues. See our dedicated guide for instructions on how to enable debug logs.

Updated about a month ago

Mobile push quick start guide

All you need to know before starting to send push notifications through your mobile apps

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.