Notification Handling
Contents
Manual Integration
Token Handling
Some third party libraries and frameworks can interfere with the Sailthru Mobile SDK's ability to collect push tokens and to handle incoming notifications. If devices are registering with Sailthru Mobile, but without push tokens, you may need to manually forward notifications and device tokens to the Sailthru Mobile iOS SDK. To do this, you will need to override a few delegate methods on your application delegate. Inapplication:didRegisterForRemoteNotificationsWithDeviceToken:
call the setDeviceTokenInBackground
method:
Objective-C
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
// Forward the device token data to the Sailthru Mobile iOS SDK
[[SailthruMobile new] setDeviceTokenInBackground:deviceToken];
}
Swift
func application(application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) {
// Forward the device token data to the Sailthru Mobile iOS SDK
SailthruMobile().setDeviceTokenInBackground(deviceToken)
}
Notification Handling
To forward notifications to the Sailthru Mobile iOS SDK call thehandleNotification:
method on Sailthru Mobile with the notification received from application:didReceiveRemoteNotification:
and applicationDidReceiveRemoteNotification:fetchCompletionHandler:
where appropriate:
Objective-C
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo
{
// Forward the notification's userInfo to the Sailthru Mobile iOS SDK
[[SailthruMobile new] handleNotificationPayload:userInfo];
}
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))handler {
// Forward the notification's userInfo to the Sailthru Mobile iOS SDK
[[SailthruMobile new] handleNotificationPayload:userInfo];
}
Swift
func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject]) {
// Forward the notification's userInfo to the Sailthru Mobile iOS SDK
SailthruMobile().handleNotificationPayload(userInfo)
}
func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject], fetchCompletionHandler completionHandler: (UIBackgroundFetchResult) -> Void) {
// Forward the notification's userInfo to the Sailthru Mobile iOS SDK
SailthruMobile().handleNotificationPayload(userInfo)
}
UNUserNotificationCenterDelegate
instead of the AppDelegate
. In order to provide notifications to the Sailthru Mobile SDK you can conform to a UNUserNotificationCenterDelegate
object and implement the userNotificationCenter:didReceiveNotificationResponse:withCompletionHandler:
. See an example below.
Objective-C
- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)(void))completionHandler {
// Forward the notification response to the Sailthru Mobile iOS SDK
[[SailthruMobile new] handleNotificationResponse:response];
completionHandler();
}
Swift
func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
// Forward the notification response to the Sailthru Mobile iOS SDK
SailthruMobile().handle(response)
completionHandler()
}
Foreground Presentation
As of iOS 10, notifications may appear inside the app while the app is open. By default, the Sailthru Mobile SDK hides these, and when In App Messages are associated, a roll-down In App Notification for those are shown. You can override this behaviour by conforming an objectUNUserNotificationCenterDelegate
and implementing userNotificationCenter:willPresentNotification:withCompletionHandler:
. See an example below.
Objective-C
- (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler {
// Forward the notification to the Sailthru Mobile iOS SDK
[[SailthruMobile new] handlePresentNotification:notification];
completionHandler(UNNotificationPresentationOptionBadge | UNNotificationPresentationOptionSound | UNNotificationPresentationOptionAlert);
}
Swift
func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
// Forward the notification to the Sailthru Mobile iOS SDK
SailthruMobile().handlePresent(notification)
completionHandler([.alert, .badge, .sound])
}