Interface

How do I access the Push Dashboard?


  1. Log into your Upsight Marketing Dashboard.

  2. On the top navigation bar, click the Push button.

How do I set my GCM API Key or APNS Certificate?


  1. Navigate to the Push Dashboard

  2. From the Apps section, choose the app you would like to send a Push Notification to and click its Edit Settings link.

  3. On this screen you will be able to enter your Google Cloud Messaging (GCM) API Key, or Apple Push Notifications Service (APNS) Certificate.

    iOS

    • In the API Key Field section, use the Choose File button to upload your APNS Certificate.

    • From the radio buttons below, choose Development if you are in a testing environment, and Production for the production version of your app.

    • Click Upload Certificate to save your settings.

    Upload APNS Interface

    Android

    • In the API Key Field section, enter your GCM API Key.

    • Click the Save API Key button to save your settings.

How do I send a Push Message?


  1. Navigate to the Push Dashboard

  2. From the Apps section, choose the app you would like to send a Push Notification to and click its Send Push link.

    Note If you have not set your GCM API Key or APNS Certificate yet, you will be prompted to do so. More information on this here.

  3. In the Audience section, choose which players to send the Push Notification to.

    • All Players - This will send a Push Notification to all the players using your app.

    • Specific Players - Click the Choose File... button to upload a CSV file with the specific users you would like to send a push notification to. More information on this for iOS and Android.

    • A Segment of Players - Choose a predefined segment from the Segment dropdown menu or click New Segment to create a new segment of players. More information on User Segments here.

  4. From the Message section, choose the Format radio button to determine your message format.

    • Text - This will appear as a message to your audience when they receive the Push Notification.

    • JSON - This will send a string of text in JavaScript Object Notation that your app can interpret and handle.

  5. Select the Set new icon badge number checkbox if you would like to change your app icon's badge number.

    Note The icon badge management is only available on iOS.

  6. From the Action section, choose the Link this push to radio button to determine where your user will be directed when they click the Push Notification.

    • Your App Name - This will launch your app.

    • Content Unit - This will direct your user to a predefined Content Unit.

    • URI - This will direct your user to a URI in your app or on the web. Enter the desired destination in the textbox that appears.

  7. From the Schedule section, choose the radio button to determine when your Push Notification will be sent.

    • Immediately - This will send the Push Notification as soon as possible.

    • Later - This will send the Push Notification when the desired date and time has passed.

      • From the Date box, select the day.

      • From the first Time box, select the hour of the day.

      • From the second Time box, select the minute of the hour.

      • From the third Time box, select morning or afternoon.

      • From the TimeZone dropdown box, select if you would like the time you entered to reflect your user's timezone, or your own.

  8. Select the Limit individual pushes per hour checkbox and enter the number desired if you would like to prevent too many messages from being sent at once.

  9. Click the Send Push Notification button to send the Push Message.

How do I get details about Push Notifications that I sent?


After sending your first Push Notification, you will be able to access your Push Messages in a simple table on the Push Dashboard. To access the table:

  1. Navigate to the Push Dashboard.

  2. Click the app you would like information for.

Message List

The columns in the table will show you how much impact your Push Notification has made.

  • Date - The date and time your Push Notification was sent, or will be sent.

  • Notification - The body of your Push Message.

  • Sent - How many Push Messages have been sent.

  • Failed - How many Push Messages that were not successfully delivered.

  • Influenced Opens - Number of users who were likely to have been influenced by the push to open the application in that they opened the application within 7 days of receiving the push.

  • Direct Opens - Number of users who opened the application by responding directly to the push notification.

  • CTR - Click Through Rate: Total number of pushes sent out / number of influenced and direct opens. This will only work if you are pushing out to a content unit.

  • Conversion Rate - Number of downloads when you push to a content unit that is an ad type.

  • Status - The current status of the Push Message.

    • Scheduled - The message will be sent at the time set while creating the message.

    • DONE - The message has completed sending to recipients.

    • Error - When a certificate is incorrect (like a production app with a development certificate) or if there Internal Server error.

    • In Progress - Percentage of Push Notifications that have sent

    • Failed - When a certificate is invalid or if the device you are trying to send to is not provisioned. Push Message got sent out but got an error message back.

  • Actions - Click the i button for more information about the Push Notification. Click the Trash Can button to delete the Push Notification.