Getting Started
Creative notifications are all about making your Android notifications richer and sending multiple contents in one notification, thus increasing your opening rate and user engagement
The notifications are Android Remote Views, that are visible when the notification is located first at the device's notification bar and there is enough space to display it. If that is not the case the small regular view of the notification will be displayed.
PushApps offers 3 templates of layouts that are embedded in the Android SDK , you are not required to design anything, only choose the relevant content for your notifications as usual. The notifications can have images, you will just need to supply those images URLs.
Each notification has a main layout and up to three buttons, clicks on each of those views are handled separately with actions that can be predefined or dynamically determined from the notification's payload.
Creative Notifications can be sent using the Remote Server API or the Admin Console.
Templates
We currently offer 3 templates, each of them with a unique id to identify it.
Rich Media, 2 buttons
Template Id : "1"
Mandatory fields
Main Layout | Each one of the 2 Buttons | ||
---|---|---|---|
MainImage | mandatory | Image | mandatory |
MainTitle | optional ( if not supplied, the title of the small notifications view will be used ) | Title | mandatory |
Rich media, 3 buttons
Template Id : "2"
Mandatory fields
Main Layout | Each one of the 3 Buttons | ||
---|---|---|---|
MainImage | mandatory | Image | mandatory |
MainTitle | optional ( if not supplied, the title of the small notifications view will be used ) | Title | mandatory |
Text only, 3 buttons
Template Id : "3"
Mandatory fields
Main Layout | Each one of the 3 Buttons | ||
---|---|---|---|
MainTitle | optional ( if not supplied, the title of the small notifications view will be used ) | Title | mandatory |
MainText | optional ( if not supplied, the text of the small notifications view will be used ) | Text | mandatory |
Creating a notification
Using the Remote Server API
The creative notifications are created with our CreateNotification API call
You will need to construct a JSON object with the key Template and add it to the request's JSON body.
Here are JSON examples of our 3 templates, the goTo keys inside the Actions object are just examples:
Template with Id "1":
Template with Id "2":
Template with Id "3":
Using The Admin Console
You can also construct the notification with these 2 steps, while creating a notification in the Main or Testing tab, by clicking on the Add creative content to your message! button:
You will be presented with a form which in you can fill the creative notification's data: titles, subtitles and links to images :
When you click on Save, you will see the newly created Json data in the Custom Json Value text box, and the key Template in the Custom Json Key text box. This indicates that your current notification contains the creative notification feature:
Now proceed with the rest of the notification creation process, when you are done you can click on the Click To Push It! button and send your notification, it's that easy!
Objects
MainLayout
the view that appears at the top of notification, Can be embedded with combinations of image, title and text.
Name | Type | Description |
---|---|---|
MainImage | String | a URL to a web image. The image will be used as the background of the layout. Due to the architecture of Android Remote Views ,you cannot use minified URLs created by services such as tinyurl.com |
MainTitle | String | a String that will be displayed at the top part of the layout |
MainText | String | a String that will be displayed at the body or bottom of the layout, depending on the template chosen |
MainAction | JSON formatted String | an object That contains the actions and/or data which is relevant for handling clicks on this layout |
Button
the view that is attached to the bottom of the main layout, there can be up to 3 buttons in a notifications, they can be embedded with combinations of image, title and text.
Name | Type | Description |
---|---|---|
Image | String | a URL to a web image. The image will be used as the background of the layout. Due to the architecture of Android Remote Views ,you cannot use minified URLs created by services such as tinyurl.com |
Title | String | a String that will be displayed at the top part of the button |
Text | String | a String that will be displayed at the boddy or bottom of the button, depending on the template chosen |
Action | JSON formatted String | an object That contains the actions and/or data which is relevant for handling clicks on this layout |