Launched with iOS 8, interactives notifications (unlike basic notifications) incorporate buttons and provide the opportunity for mobile users to interact directly with the message displayed on the screen or in the center of notifications without having to open the application. Widely appreciated by mobile users, this message format is now available on your Accengage interface, with our iOS SDK version 5.4.0 and onwards, for push notifications and scheduled alarms.
Discover below all the information you need to setup and use buttons on your push messages or scheduled alarms:
For iOS, button categories must first be declared in your application.
A category usually contains 2 buttons (but up to 4 buttons can be addded - the display in this case is subject to specific conditions described further on).
Within a category, each button is defined by an (a):
- ID: value supported by the application
- Label: this is the text displayed on the button
- Type: choice between
- Foreground: is a button which opens the app
- Background: is a button which does not open the app (can be used to send a transparent tracking request for example)
- State "Destructive" (or not): a button defined as “destructive” will be red. This color is used to indicate to the mobile user the importance of his action (like deleting a message, for example)
- Authentication Required" (or not): specifies whether the mobile user has to log on before interacting with the notification received
For a quick start, please note that our SDK already includes more than 40 preset categories . Each category contains 2 buttons. Feel free to use our pre-configured buttons for your push messages and/or scheduled alarms.
|I agree||I disagree||Login||Close|
|Satisfied||Unsatisfied||Create an account||Close|
|Buy now||Later||Get more||Get less|
|Show me||Share||Get more||No, thanks|
|Add to wishlist||Later||Add to calendar||Close|
|Show offer||Share||Answer it||Close|
|Show the deal||Later||Take part||Close|
|Enjoy now||No, thanks||Give a feedback||No, thanks|
|Add to cart||No, thanks||Rate the app||Later|
|Show cart||Later||I have a feedback||Later|
|Access booking||Later||See more||Close|
|Share||No, thanks||Let's go||Close|
|Open||Close||I'm in||No, thanks|
Once defined in the application, custom categories of buttons have to be added on the Accengage interface in order to be used for push notifications and/or scheduled alarms.
Follow the steps below :
Go to the Settings menu > Advanced Settings > Section 7. Categories (buttons of interactive notifications)
- Fill in each category button in accordance with the criteria defined by the developper within the application, then click on SAVE
To add buttons to your push notifications and/or scheduled alarms, follow the steps below:
- Select your iOS application
- Go to the Actions menu > Push notifications > New message Or Actions menu > scheduled alarms > New alarm (for the scheduled alarms)
- In the section 2. Message (or section 4 for scheduled alarms), set all information related to your notification (message, sound, badge, Rich push URL, advanced settings etc...)
- Check the box " Content available" if you want to notify the application that it has content to download in the background . This pre-downloading will optimize the display time to the mobinaute
- Then, unfold the "buttons" field and select the button category you want to use (custom buttons or preset buttons)
- Choose on click action type between the following propositions : webview, browser, mail, phone, Appstore, sms, Url scheme, Request, no action
- Add additional parameters if needed
- Then test your message by selecting your test segment(s)
iOS allows you to display up to 4 buttons on an interactive notification but only under specific conditions, specified below:
- The mobile user must choose, in his phone setting's, the "Alerts" format as a preference for notification reception
- His phone must be unlocked when he receives the notification
- He must click on the "Options" button in order to display the additional buttons on the notification (as shown below)
Interactive notification with 4 buttons
Due to these constraints, we recommend you create your custom categories with 2 buttons, which is the most common use case on most devices. Here are some examples of common use.