3.1 Customize the SDK default launching configuration

3.2 Handling push delegate callbacks manually

Custom notification sounds

You can specify a custom sound, that iOS will play when it receives a local or remote notification for your app. For more details, you can consult Apple's documentation.

Remember that the default sound is played when:

  • The sound file is not found.
  • The sound is longer than 30 seconds.
  • The data format is invalid. Accepted data formats are: aiff, wav, or caf.

To add the sound file to your project, you can simply drag and drop it to your resource folder. Make sure you check the box Copy items if needed.

In the Accengage dashboard, you can easily specify this sound when composing a push message by selecting "custom" in the sound section, and enter the file name with its extension (customsound.wav for instance).


Prefer a short file name.

Configure interactive notifications

Interactive notifications give the user a quick and easy way to perform relevant tasks in response to a notification. Instead of the user being forced to launch your app, the interface for an actionable notification displays custom action buttons that the user can tap. When tapped, each button dismisses the notification interface and forwards the selected action to your app for immediate handling. Forwarding the action to your app avoids the need for the user to navigate further in your app to perform the action, thereby saving time.

A set of default notification categories is provided by Accengage. If you want to add more categories for interactive notifications, you should call the setCustomCategories: before registering for push notifications:

// The app custom categories set
[[Accengage push] setCustomCategories:customCategories];
// Register for notification
ACCNotificationOptions options = (ACCNotificationOptionSound|ACCNotificationOptionBadge|ACCNotificationOptionAlert|ACCNotificationOptionCarPlay);

[[Accengage push] registerForUserNotificationsWithOptions:options];
// The app custom categories set
Accengage.push().customCategories = customCategories
// Register for notification
Accengage.push().registerForUserNotifications(options: [.sound, .badge, .alert, .carPlay])


If you would like to handle custom categories and buttons, you must declare them in the Accengage Dashboard (Settings > Settings > Categories (Buttons)). See our User Guide for more details.

Preventing notification display

Sometimes, it might be useful to prevent displaying push notifications, for various reasons : avoid displaying push notifications on top of ads, respecting user preferences etc...

Accengage provides you an option, but don't forget to deactivate it if need be!

You can prevent the display of any push notification by suspending the Push service :

[Accengage push].suspended = YES;
Accengage.push().suspended = true


This will not affect In-App messages.

3.3 Carousel Template

Silent push notifications

Silent push notifications improve the user experience by giving you a way to wake up your app periodically so that it can refresh its data in the background.

To enable silent push in your Xcode project:

  1. In the Project Navigator, select your project.

  2. In the editor, select your iOS app target.

  3. Select the Capabilities tab.

  4. Enable the Background Modes capability.

  5. Enable the Remote notifications background mode. 

To enable silent push on the Accengage dashboard, tick the content available checkbox when configuring your push message.

Please bare in mind that APNs treats silent push notifications as low priority and may throttle their delivery altogether if the total number becomes excessive. The actual limits are dynamic and can change based on conditions, but try not to send more than a few notifications per hour.