How to Use Mobile Push notifications (SDK V1 )

Set up Your App to use Push

1. First, configure the Push Settings for your app unser ‘App Settings’, ‘Push settings’ section. For IOS, upload p12 files. For android, set the Google Cloud Messaging API key. This will enable Pendo to send push notifications to your app.
   
   
2. Add the relevant code to your app allowing you to show a push campaign with images.

How to set up a Push campaign

1. Add a “Rich Push” guide from the guides catalog.
2. Under the ‘Content’ tab, configure the title, message and optional image for the push campaign. There is no preview for push notifications so you will not see anything on the phone frame on the right.

Push actions

Configure what you want to happen when the user clicks on the push notification.
You have a few options:

Open another guide when the push message is clicked

In case you want the user to see a specific guide once the push notification is clicked and the app is launched, select the option ‘Trigger an insert” and select a guide to display.
You'll be able to select from a list of guides that have a 'permalink trigger'.

When you select a guide, you can see the triggered guide’s status (whether it’s published), segment and schedule to ensure that the schedule and segment of the triggered guide match those of the push campaign that opens it and that the guide is public. 

You need to set up that other guide in advance. The guide that is launched from the push notifications must be: 

1. Published
2. Have a Permalink trigger, which you can set under the ‘Trigger’ tab
3. Match the segment and schedule of the push campaign.

Here is how you select a permalink trigger for a guide, under the 'Triggers' tab:

Testing a push campaign on a device

In order to test your push notification on your device, use the ‘Push to Device’ button on top of the empty phone frame on the 'Content' tab.

As part of your testing:

1. Use a paired device or connect a new device
2. You will be asked to send your app to the background and let Pendo know when the app is in the background (if the app is in the foreground at the time the push notification is sent, you will not see the notification)
3. You should see the push notification on your device

Push Segment

When you select a segment for your push notification, remember that only users who agreed to receive push notifications to their app will see the push notification (i.e. said ‘Yes’ in the permissions dialog).

Also, the app needs to be launched at least once and the user should see the permissions dialog before a user can receive a push notification

Push Scheduling Options

A push campaign can be sent now, once in a set future date, or in a recurrent manner. Configure the schedule under the ‘Settings' tab.

When you set up a recurrent push, setup how often this message should be sent

Note that a push campaign will be sent within 15 minutes from the scheduled time.

Push Campaign Stats

• When a push is scheduled to a later time you will see its status as ‘Scheduled’
• A recurrent campaign will be ‘Running’ as long as the end date has not arrived
• After the push notification was sent for a one-time push (and for a recurrent push, after its end date has passed), it will move to “Ended”

Push Campaign Analytics 

• After a push campaign has been published, click on it to see analytics on the number of push notifications sent, and the number of 'App opens' as a result of clicking the push notification.
• If the push opens a separate guide, the analytics for views of this guide can be accessed when clicking this guide.
• Note that even if your campaign for push included 3000 users, it might be received by only 2800 users, depending on the number of users who have the app installed and provided push permissions at the time the push campaign is sent.