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.

Activate GCM

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".

Create API KEY

Click the "Server key" button and leave the IPs whitelisting blank.

Server Key

Copy the newly generated API Key.

Generated Key

On Kiwi

Access your application on Admin interface, go to Settings and select Push Configuration and enter the API Key generated previously.

Generated Key

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