Jump to: navigation, search

How to Set Up Push notifications

Revision as of 19:42, 6 December 2016 by Akokulu (Talk | contribs) (Android)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

How to Set Up Push Notifications

Push notifications allow you to reach out to your users directly, helping to keep them using your app. See below for a walkthrough on creating notifications and integration instructions on each platform.

Account Set Up

Android

For the Fuse dashboard to send notifications on your behalf, we require the app's Google Cloud Messaging (GCM) key. See this page for information on GCM.

To share your GCM key with Fuse, first select the app in the dashboard. On the main dashboard page, click the configure button.

Push Notifications - Configure Android 1.png

Click the "Push Notification Config" tab, and enter your key in textbox. Click save and you are ready to start sending out notifications.

Push Notifications - Enter GCM 1.png

iOS

For the Fuse dashboard to send notifications on your behalf, we require the app's Production and/or Development Certificates. See this page for information on generating the certificates.

After you generate and download your certificate, you need to double click it to add it to your keychain. From your keychain you can export the certificate as a .p12 file by right clicking the certificate. When you do this, it's going to ask you to enter a password for the exported file. The exported file is the file you need to upload to our dashboard, and the password is what you entered before exporting it.


To upload your certificates to Fuse, first select the app in the dashboard. On the main dashboard page, click the configure button.

Push Notifications - Configure iOS 1.png

Click the "Push Notification Config" tab. Now you can upload your certificates using the file browser. Be sure to enter your passwords before clicking the save button.

Push Notifications - Enter Certificates 1.png

Building a Notification

NoteBubble.png

At this stage, you will need to have registered for notifications on your device with the app you are using to send notifications. A warning message will appear in the dashboard if no tokens have been registered.

If it is the first time you are creating a notification for your app, you will find a blue "Get Started" push notification widget on the lower right of the main dashboard page. Once you have created a notification, this will be replaced by a list displaying your latest notifications.

Push Notifications - Get Started 1.png

Click the "Add Push Notification" button and you will be taken to the "Add/Edit Push Notification" screen.

Push Notifications - Add Push Notification 1.png

Content

Now you can start adding content to your notification. Title your notification and enter the message you would like the users to read. Note that on iOS, the title is only for dashboard display purposes and will not be shown to the user.

Set the run date and time. Here you can choose to select a timezone for the runtime or check the "Same time everywhere" box. Selecting "Same time everywhere" will show the notification on the selected day, at the selected local time in every timezone in the world.

Push Notifications - Notification Content 1.png

iOS Exclusive

The next three settings are exclusive to iOS and will not appear on an Android notification set up.

You will need to select your target environment, choosing between production and development. If you have registered development tokens, the number you have registered will be displayed.

The sound file is what will be played when the notification is received. You must enter a link to a resource file in the app. This is not a required step. Follow this link for information on the type of file that can be used.

The badge number is the number displayed on the app icon when the notification is received. This is not a required step.

Push Notifications - iOS Specific Settings 1.png

Targeting

Now that you have set up the content of your notification, it's time to target its audience.

First select the segment of users that you would like to receive the notification. You can use the predefined segments or any of your own that you have saved.

Now select the language and countries that will receive the notification. Selecting a specific language will send the notification to users with that language set in their device's language settings. Country is based on the user's location. Users outside the selected countries will not see the notification.

Push Notifications - Targeting Information 1.png

Now that you have set up your notification, you can save it. You will be returned to the push notification list.

The notification still won't be sent until you add it to the queue. Notifications are added to the queue by checking the box in the "Queued" column. Notifications that are not queued will simply expire without sending.

To edit a notification, click the message in the notification list. It will return you to the add/edit page. There you can make any modifications to the notification before saving and returning to the list. Notifications in the queue cannot be edited. However, you can remove notifications from the queue to edit them and return them to the queue afterwards.

Push Notifications - Notification List 1.png

Cloning

Clicking the "Clone" button opens the add/edit notification window with all information copied from the cloned notification. You can then modify any of the settings and save a new notification as normal. This feature is useful when creating notifications in multiple languages or sending custom messages to different regions.

Push Notifications - Clone 1.png

Status

Status Column

The "Status" column on the notification list page will show one of four states that a notification can be in.

Push Notifications - Status Column 1.png

State Meaning
Sent The notification has been sent.
Not Sent The notification has not been sent.
In Progress The notification is in the process of being sent.
Expired The notification was not queued within 15 minutes of the notification's run time.

Clicking on the state in the "Status" column will take you to the push notification status page for the specified app.

Status Page

The push notification status page, accessed by clicking the notification state in the "Status" column of the notification list, gives you in depth information on your notifications. Click the button at the bottom of the page to return to the push notification list.

Section Meaning
Status Shows the current state of the notification.
Push Message Body Shows the copy that will be sent with the message.
Countries Targeted Lists the countries selected when setting up the notification.
Language Shows the language that was selected for the notification during setup.
Segment Targeted Shows the segment that was selected for the notification during setup.
Push Environment (iOS only) Shows if the notification was sent to Development or Production tokens.
Extra Information Miscellaneous information related to the notification.
Token Collection Status Displays the progress of token collection and how many tokens have been collected.
Send Status Displays the progress of sending messages and how many messages have been collected.
Scheduled Start Time Shows the start time that was selected for the notification during setup.
Completion Time Shows the time that the notification finished sending.

Push Notifications - Status Page 1.png

If you have set up a notification as "same time everywhere", you will see an expandable table, "TIme Zone Status", that shows the tokens found and messages sent for each time zone.

Push Notifications - Status Page Same Time Everywhere 1.png

Integration