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.
Depending on the app platform, your development team must complete the following tasks:
- 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.
- Create an Android server key and enter it in Swrve – To enable an app to send push notifications to Google Play devices, you must create a server key, enter it in Swrve and test it. For more information, see How do I manage the Android Server Key for 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:
Step 1: On the Settings menu, select Push notifications settings.
Step 2: On the Push Notification Settings screen, under Custom Notification Alert Sounds, select Add Sound.
Step 4: In the Add Sound dialog box, in the Friendly name box, enter a user-friendly name for your sound file.
Step 5: 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.
Step 6: 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:
Step 1: On the Settings menu, select Push notifications settings.
Step 2: On the Push Notification Settings screen, under the Custom Action Categories (iOS 8+) section, select Add Category.
Step 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).
Step 4: In the Identifier box, enter the identifier used in your app to identify this category (for example, INVITE_CATEGORY).
Step 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).
- Create a new push notification campaign. For more information, see Creating push notifications.
- Send quick, breaking news-type notifications to a predefined audience of users. For more information, see Quick push notifications.
- Personalize your push notification content using custom user properties. For more information, see Personalizing push notifications.
- A/B test the content of your message to compare conversion rates. For more information, see A/B testing push notifications.
- Create localized versions of your message to target specific language groups. For more information, see Localizing push notifications.
- QA test a campaign before launching it. For more information, see QA testing push notifications.
- View results and reports for your campaign or change the status. For more information, see Managing push notifications.