Page tree
Skip to end of metadata
Go to start of metadata

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 LayoutEach one of the 2 Buttons
MainImagemandatoryImagemandatory
MainTitleoptional ( if not supplied, the title of the small notifications view will be used )Titlemandatory


Rich media, 3 buttons

Template Id : "2"

Mandatory fields

Main LayoutEach one of the 3 Buttons
MainImagemandatoryImagemandatory
MainTitleoptional ( if not supplied, the title of the small notifications view will be used )Titlemandatory

Text only, 3 buttons

Template Id : "3"

Mandatory fields

Main LayoutEach one of the 3 Buttons
MainTitleoptional ( if not supplied, the title of the small notifications view will be used )Titlemandatory
MainTextoptional ( if not supplied, the text of the small notifications view will be used )Textmandatory

Creating a notification

Using the Remote Server API

Icon
This sections assumes you are familiar with our Remote Server API and are capable of using it. If that is not the case please refer to our guides or contact the support team for further assistance

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.

NameTypeDescription
MainImageStringa 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
MainTitleStringa String that will be displayed at the top part of the layout
MainTextStringa String that will be displayed at the body or bottom of the layout, depending on the template chosen
MainActionJSON formatted Stringan 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.

NameTypeDescription
ImageStringa 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
TitleStringa String that will be displayed at the top part of the button
TextStringa String that will be displayed at the boddy or bottom of the button, depending on the template chosen
ActionJSON formatted Stringan object That contains the actions and/or data which is relevant for handling clicks on this layout
  • No labels