Clicking on the Create button in the Android Push Notifications panel at the top of the Actions Management page will take you to a form that lets you create a new, reusable push notification message action for Android devices.

ActionName

The Action Panel lets you give your action a descriptive, meaningful name and contains 3 buttons that

1) Create a New action

2) Open an existing action

3) Clone an existing action to a new action. Handy if you are setting up multiple similar actions.

This Action panel will become familiar as it is used by all the action management screens.

 

The Android Message Content form lets you define the content for your push notification message. Only the Alert field is required, all other fields are optional.

Android-Notification-Content

The Alert message is the text that appears in the notification. This can be any unicode character including Emojis: 😁. In order to pickup the notification, the game’s GcmIntentService must look for ‘alert’ in the Extra’s top level keys.

Custom Fields allow additional key values pairs to be added into the notification. These can be read by your game when it launches. The fields appear as top level keys in the notification Extras.

More information on Google’s notification payloads can be found here. Google limit the total payload, which includes all the fields here to 4096 bytes.

You can also add dynamic content to your Android notifications. Clicking the “Add Dynamic Field” button will add a new dynamic field, you can add multiple.

dynamic content

Each dynamic field will need a placeholder that acts as the substitution text in your email template.

Your dynamic content can be populated with:

  1. One of your player’s Metric values (Environment Metric)
  2. A derived Metric that is calculated from a mathematical derivation of multiple other metrics or derived metrics. (Derived Metric)
    e.g. You could create a missionSuccess ratio as a derived metric based on the missionCompleted and missionFailed event counts then use that dynamically in your message.
    “Because you lose in 65% of battles, here’s a bigger gun”
  3. Variant Property that lets you dynamically alter content for each variant group in a campaign.
    e.g.
    Variant A – Here’s a new Tommy Gun to help you in Robbers missions.
    Variant B – Here’s a new whistle to help you in Cops missions
The Placeholder field is uses freeform text as the substitution key in your content, you should therefore ensure that the same text doesn’t appear naturally in your text or you will end up with additional unexpected substitutions. You may want to wrap your substitution in something that won’t appear naturally e.g. %maxLevel% , #lastMission# etc..
Please check that the characters you use are acceptable with any 3rd party content delivery channels.

NB : Don’t forget to click the green Commit button commit on any custom fields you add before Saving your notification.

Your newly saved action will be listed on the Action Management Screen. There are two buttons beside each action so you can Edit or Delete them.

Android-Notification-List

 

Your action will now be available to use in Out of Game Campaigns.

NB : Your game will be responsible for reacting to any custom parameters you put in the payload, so some planning and instrumentation is required when your developers are integrating with deltaDNA and planning your event collection and engagement specification. If you wish to display a custom Title or Icon with your Android Push notification you will need to add the correct keys as Custom Fields. You may need to confirm the key names with your developer as it is possible to override the defaults in your manifest file. There is more information on this in the Android Notifications Library documentation.