Push notifications

Create a notification

  1. Click on "Actions"
  2. Select "Push notifications"
  3. Use the button "New message" to create a notification

The push form is separated in 3 differents parts :

  • Android

  • iOS

Message references

Message name : it's the message name in the Accengage's database. This name can be found in the "Push notifications list" (Actions > Push Notifications) and in your statistics.

Campaign : allows you to select which campaign will be linked to the message

Marketing pressure : if you have set a marketing pressure in the settings of your app, this "switch" allows you to decide if your message will be affected by it or not. If a pressure has been set, then the switch will be activated by default.

Messages group : allows you to select which message group will be associated to your message. If a marketing pressure has been set in the message group and the switch "Marketing pressure" is activated then the pression that will be taken into account will be the first pressure reached.

Message external ID : ID to use if you want to call the message within API requests.

Message creation

Android

Rich message template : allows you to select the template of your notification
Title : notification title that will be displayed on the user's device Thumbnail : allows you to add a thumbnail to your notification by uploading a file ( .jpg or .png) or using a URL Extended message :  body of the message that will be displayed in the notification. Accengage supports all characters and allows you to personalise your message with smileys, calligraphic characters, etc. Short message :  it's the message that will be displayed when the notification isn't unfolded. If the body of your message doesn't contain more than one line then it's unnecessary to customise the short message

Adjust your badge and sound

Badge allows you to :

  • define which number will be displayed on the application's badge - Select "Value" in the dropdown list
  • increment a value if a badge already exists on the application's icon - Select "Incremented value" in the dropdown list
  • to remove the badge displayed - Select "Reset" in the dropdown list

Sound : allows you to choose which sound alert will be played once the notification has been received on the users' devices. If your application includes a library of specific sounds, you will be able use them in your notification by selecting "Custom" in the dropdown list and indicating the name of the sound file present in your application.

If you prefer that the notification makes no sound, then select "None" in the dropdown list.

Trigger following action

Click action allows to decide, when the users click on the notification, if they should be redirected to :

  • a landing page opened in a webview : Opening a landing page through a webview will first open your application and then the wanted page. You can indicate a URL or use HTML editor by clicking on "Create New" to create a page that will automatically be hosted by Accengage.
  • a landing page opened in a browser : The landing page will be opened through the brower's device meaning that the user will leave your application to see the page. You can indicate a URL or use HTML editor by clicking on "Create New" to create a page that will automatically be hosted by Accengage.
  • a native deeplink : it means a specific page of your application. In other words a URL Scheme. You simply have to add the deeplink of the page, for instance : "myapp://mypage"

Custom parameters : allows you to send data to the application at the moment the user clicks on the notification .. It can be useful for analytic tools. For example, if you're using Google Analytics, you can indicate your custom parameters as follow in order to retrieve datas to you GA account : "key = utm_campaign" "value = campaign_name"

Push buttons : allows to add action buttons to your notification.

Accengage offers a list of default buttons available in the "Preset" in the dropdown list.

You can of course use your own buttons if the default ones don't meet your needs. You'll have to set them in the settings of your application in the Accengage Dashboard.

Manage advanced parameters

Alertbox: allows to display the notification as a system alert incentiventing the user to perform an action.

Expiration delay: The expiration deplay option discards your message if it hasn’t been delivered to a device within a specific period of time. If a device is online, the notification will be delivered immediately. If a device is offline, the push service for each platform, e.g., APNs for iOS and FCM for Android, preserves the notification and attempts to deliver it as soon as it comes online, up until the expiration date. There is no way to remove a delivered push notification.

Use cases:

  • promotional offer ending at 5:00pm : you can specifiy 5:00 as expiration date
  • a flash offer ending in the next 30 minutes : you can specify 30 minutes as expiration delay

The maximum expiration delay is 28 days and starts from the moment you send your message from Accengage FCM will try to deliver your notification during 28 days maximum (depending on the delay set) and will stop trying once the delay is passed.

This feature is compatible with all SDK versions.

Priority allows you to add 2 different levels of priority to your message :

  • Normal: your message will be displayed on the user's device once optimal conditions are met. Network connection, battery level, Doze state are some of the factors that can be taken into account by FCM to deliver your message.
  • High: your message will be delivered immediately (when possible) on the user's device. The device will be awakened and the notification displayed even if the user's network access is limited.

This feature is compatible with all SDK versions.

Behaviour if the app is already in the foreground: you can choose if the notification should be displayed even if the app is in the foreground.

Collapse key: it is an ID used to group a set of messages. When specifying a collapse key before sending, the previous notifications will be replaced by the latest ones.meaning that the notification displayed on the user's device will be the last one sent with the collapse key. See the part "Collapse key" for more information

iOS

Title: notification title that will be displayed on the user's device Subtitle: Subtitle of your notification Message:  body of the message that will be displayed in the notification. Accengage supports all characters and allows you to personalise your message with smileys, calligraphic characters, etc Rich message template: allows you to select the template of your notification

Adjust your badge and sound

Badge: allows you to:

  • Define which number will be displayed on the application's badge (by selecting "Value" in the dropdown list)
  • Increment a value if a badge already exists on the application's icon (by selecting "Incremented value" in the dropdown list)
  • Remove the badge displayed - by selecting "Reset" in the dropdown list

Sound: allows you to choose which sound alert will be played once the notification has been received on the users' devices. If your application includes a library of specific sounds, you will be able use them in your notification by selecting "Custom" in the dropdown list and indicating the name of the sound file present in your application.

If you prefer that the notification makes no sound, then select "None" in the dropdown list.

Trigger following action

Click action allows to decide when the users click on the notification, if they should be redirected to :

  • a landing page opened in a webview:

    Opening a landing page through a webview will first open your application and then the wanted page. You can indicate a URL or use HTML editor by clicking on "Create New" to create a page that will automatically be hosted by Accengage.

  • a landing page opened in a browser:

    The landing page will be opened through the brower's device meaning that the user will leave your application to see the page. You can indicate a URL or use HTML editor by clicking on "Create New" to create a page that will automatically be hosted by Accengage.

  • a native deeplink : it means a specific page of your application. In other words a URL Scheme. You simply have to add the deeplink of the page, for instance : "myapp://mypage"

Custom parameters : allows you to send data to the application at the moment the user clicks on the notification. It can be useful for analytic tools.

Example: if you're using Google Analytics, you can indicate your custom parameters as follow in order to retrieve datas to you GA account:

"key = utm_campaign" "value = campaign_name"

Push buttons : allows to add action buttons to your notification.

Accengage offers a list of default buttons available in the "Preset" in the dropdown list.

You can of course use your own buttons if the default ones don't meet your needs. You'll have to set them in the settings of your application in the Accengage Dashboard.

Manage advanced parameters

Expiration delay: you can define an expiration or date from which your message will no longer be displayed on the user's device.

Examples:

  • promotional offer ending at 5:00pm : you can specifiy 5:00 as expiration date
  • a flash offer ending in the next 30 minutes : you can specify 30 minutes as expiration delay

In both cases, when the deadline is passed, the message will no longer be displayed on the user's device.

The maximum expiration delay is 28 days and starts from the moment you send your message from Accengage
APNS will try to deliver your notification during 28 days maximum (depending on the delay set) and will stop trying once the delay is passed

This feature is compatible with all SDK versions.

Priority : allows you to add 2 different levels of priority to your message :

  • Normal: your me message will be displayed on the user's device once optimal conditions are met. Network connection, battery level, Doze state are some of the factors that can be taken into account by FCM to deliver your message.
  • High: your message will be delivered immediately (when possible) on the user's device. The device will be awakened and the notification displayed even if the user's network access is limited.

This feature is compatible with all SDK versions.

Behaviour if the app is already in the foreground: you can choose if the notification should be displayed even if the app is in the foreground.

Content available: it's a silent parameter (available from iOS 7 and onwards) to notify the application that it has a content to download in the background.

Targets

Once all parameters of your message have been filled, you just have to add your segments to your message :

Test segment(s): segments that will be targeted to send the test message allowing you to visualize how your notification is displayed on the device. You can send as many tests as you want.

Campaign segment(s): segments that will be targeted to send your definitive message. Once your definitive send has been done, it is not possible to do it another time.

At this stage other options are available :

Create new: allows you to create tests or definitive segments directly from the push form

Schedule: allows you to schedule the sending of your message at a specific date and hour. Consult the page "Programming" for more information.

Additional information

Collapse key

Collapse key is an identifier used for Android devices to group a set of messages. By default when several identical messages are sent to a phone that is unavailable (temporary absence of network, phone offline); the corresponding notifications accumulate on the Google Cloud Messaging Server (GCM). Once the phone is functional again, all the notifications are transmitted to the mobile user that is found often found overwhelmed with multiple messages containing the same information.

By specifying a collapse key before the sending, the oldest notifications are replaced by the most recent ones. It means that the mobile user will only receive the "last" message on his phone. This helps improving the mobile user experience and for the advertiser to be considered as “responsive” application by GCM servers.

On your Accengage interface, you can easily activate this feature and use it for your push messages, by following the procedure below:

  • Go to the settings menu > advanced settings
  • In the “collapse key” field, click on the button (+) to create a new key
  • A modal will open, define the name of your key and click on save. It is automatically inserted into the base through the identifier assigned to it. You can define as many collapse key as you want.

Specific details on multilingual applications

If your application is international and you wish to send a message to your app users in a specific language, you can either:

  • Create a segment by language group and create a message for each of these segments.
  • Add a language code when creating your messages to specifically separate the users of your application based on a language code.

In this case, your new notification form as specific tabs allowing you to personalise the message and any other notification setting according to the language of your app users.

  • “Others” refers to the rest of your database of recipients
  • To send a message to all “EN” recipients, go to the “English” tab
  • To send a message to all “FR” recipients, go to the “French” tab