Last modified November 30, 2018 by Shelly Wolfe

Push campaign prerequisites

This article details the steps your development team must take before you can create push notification campaigns in Swrve. It also explains how to configure custom alert sounds or iOS action categories for your push notifications.

Technical prerequisites

Depending on the app platform, your development team must complete the following tasks:

All platforms

  • Update your app with the latest SDK – To make use of all of the features included in Swrve push notifications (for example, rich media, silent notifications, audience targeting), update your app with the latest Swrve SDK. For more information about integrating the SDK, see the platform-specific integration guide.
  • Time the push permission request – When a user first installs a push-enabled app, they are typically asked for permission to accept push notifications from the app. Swrve enables your development team to change this timing. For example, you can set the timing to request permission at the start of the session or when a user triggers one of a list of events. For more information, see the platform-specific integration guide.
  • Rich push notifications – To use rich push notifications on iOS, there are a few extra steps required to add the rich push service extension. For more information, see the iOS integration guide.
  • Test push notifications in your Swrve dashboard – Before creating your first push notification campaign, your development team should test the push notification integration on QA devices. For more information, see QA testing push notifications.


  • Enable remote notification background mode for silent notifications – If you want to send background app updates, you must configure your app to process silent notifications in the background. For more information, see the iOS integration guide.
  • Create a push certificate and upload it to Swrve – If you’re not already using push notifications, your development team must create a push certificate, upload it to Swrve and test it. The certificate is used to authorize your app to receive push notifications and authorize Swrve to send push notifications to your app. For more information, see How do I manage iOS push certificates for push notifications?
  • Submit your updated app to Apple for review – After your development team has integrated the latest SDK, your iTunes Connect administrator must submit the app for review and inclusion in the App Store. As soon as it is available, your existing users are prompted to update the app while new users automatically get the latest version. This new app version then invokes the push permission request, logging device tokens back to Swrve, which you can then use to target those users by means of push notifications.


Custom alert sounds

Swrve enables you to include a custom sound that is played when a user receives your push notification. To make a custom sound available to select in the push campaign workflow, you must first add add it to your app Push Notification Settings.

To add a custom sound:

  1. On the Settings menu, select Push notifications settings.
  2. On the Push Notification Settings screen, under Custom Notification Alert Sounds, select Add Sound.
  3. In the Add Sound dialog box, in the Friendly name box, enter a user-friendly name for your sound file.
  4. In the File name box, enter the actual name of your file, without the extension. For example, enter custom_sound for the filename custom_sound.wav.
  5. Select Create Sound.

The custom sound is now available to select from the Alert Sound list on the Add Content screen of the push notification workflow.

For guidelines on using sounds with push notifications, see Push notification best practices.

Custom iOS action categories

Swrve enables you to include custom action categories (for example, Yes/No, Ignore/Respond) when creating interactive push notifications on devices running iOS 8 or later. Before you can add or use custom categories in a push notification, you must provide any custom action categories when initializing the SDK and then add it to your app Push Notification Settings. For more information, see the iOS integration guide.

To add a custom action category:

  1. On the Settings menu, select Push notifications settings.
  2. On the Push Notification Settings screen, under the Custom Action Categories (iOS 8+) section, select Add Category.
  3. In the Add Custom Action Category (iOS 8+) dialog box, in the Friendly name box, enter a user-friendly name for the category (for example, Yes/No, Invite, Reminder).
  4. In the Identifier box, enter the identifier used in your app to identify this category (for example, INVITE_CATEGORY).
  5. Select Create Push category.

The custom action categories are now available to select from the iOS Category list on the Add Content screen of the push notification workflow.

Push token update period

Swrve performs several batch jobs throughout the day to find users with push device tokens registered and then loads any new device tokens into the push notification system. Therefore, it can take up to six hours to add non-QA users to the system, depending on factors such as when the batch job is run and your company’s time zone. The number of devices that appears on the Overview screen of the new push campaign workflow is updated regularly to include new users. However, they may not be immediately available to send push notifications to, depending on the timing of the batch run (this does not apply to testing push notifications on QA devices).

Next steps