Sending Push Notifications
In order to send push notifications to your application, follow these steps for each platform. For more information on how to receive the push in the application please check the SDK documentation.
Configuring Google Cloud Messaging (GCM) for Android
On Google Developer Console
To enable GCM for your application first access the Google Developer Console page and select your Product.
Select the "APIs" section under "APIs & auth" from the left-hand navigation and make sure the Google Cloud Messaging for Android API is enabled.
Next you will have to create a new API Key to allow Kiwi to send Push notifications on your behalf.
Click "Credentials" under "APIs & auth" and select "Public API access" click "Create new Key".
Click the "Server key" button and leave the IPs whitelisting blank.
Copy the newly generated API Key.
On Kiwi
Access your application on Admin interface, go to Settings and select Push Configuration and enter the API Key generated previously.
Click save and your done.
Configuring Apple Push Notifications for iOS
To configure Kiwi to send Push Notifications through APNS you will need to provide the Certificate file provided by Apple Inc.
You can access your application on Admin interface, go to Settings and select Push Configuration.
Select your Certificate file, and provide your Certificate password. You will be able to validate the information about the certificate provided after you save it.
Sending Push Notifications
For Android Devices
To send a push notification for an Android App, you can access the User Engagement area of the Admin and choose Push Notifications.
Kiwi Android SDK will handle push messages for the applications, creating an alert notification based on sent parameters or just redirecting a payload to the app, without showing a notification. If a notification is created by the SDK, it will also take care of launching the desired intent with all extra parameters that were sent on the push message.
Configuring the application
Check our Push Guide for the Android SDK.
Parameters
Publication Name:
A user-friendly name that will identify this push on the user interface.
Push Type:
Indicates the type of action that will happen when a push message reaches the user's device. Currently the available options are:
SEND_NOTIFICATION: Creates a notification based on the parameters sent on the push message
SDK_SILENT: Reserved for Kiwi's internal use
APP_SILENT: Bypass all the data inside the push message to the application, by launching an intent that has all the extra parameters from the push message. No notification is created by Kiwi
Push Action
Intent filter that indicates what should be done when the user opens and clicks on the notification message (SEND_NOTIFICATION push only) or what intent shoud be launched right after the push message reaches the device (APP_SILENT push only).
The action must match the intent filter of an intent for which the application has a receiver or activity registered. If unsure check this with the development team.
notificationOpenMethod
Indicate how Kiwi will launch the intent specified on parameter Push Action. The available options are:
START_ACTIVITY: Starts an activity using the intent filter sent.
SEND_BROADCAST: Sends a broadcast using the intent filter sent.
ticker
Message that is shown for a few seconds on the device's action bar right after the notification is created.
alert
Title of the notification that will show on the device.
message
Body of the notification. This will be the content of the push notification.
Extra Parameters
Json with information that should be transmitted to the listener for the intent filter determined by Push Action.
This is advanced feature and will only be used if the app requires special treatment of the push and implements it's own push receiver.
For iOS Devices
To send a push notification for an iOS App, you can access the User Engagement area of the Admin and choose Push Notifications.
Configuring the application
Check our Push Guide for the iOS SDK.
Push Parameters
Publication Name:
A user-friendly name that will identify this push on the user interface.
Message:
Message shown on the device notification center.
Badge
Number shown next to the notification icon, used to indicate number of messages
Alert Sound URL
Path of the sound file that will play when the push message is received
Extra parameters
Map of parameters that will be processed by the SDK or by the application. This is advanced feature and will only be used if the app requires special treatment of the push and implements it's own push types.
Last updated