Rich Push Notifications in iOS and Android - Media Attachments

This document describes how to use media attachments with push notifications on iOS and Android.

#iOS

Rich push notifications are supported on iOS 10+.

For iOS notifications with media attachments to be displayed on device add a Notification Service Extension to your application.

For the most up-to-date documentation, please refer to the SDK documentation.

#iOS 10 media attachment integration steps

1. Create a new Notification Service Extension

   • In Xcode, navigate to File > New > Target....
   • Click iOS > Notification Service Extension > Next.
   • Fill in the information and click Finish.

2. Implement the Notification Service Extension

   • Import IterableAppExtensions CocoaPod into your Notification Extension target (this example assumes that the target name for the Notification Service Extension is MyAppNotificationExtension):

     target 'MyAppNotificationExtension' do
       pod 'IterableAppExtensions'
     end
     

   • Insert this into your main Notification Extension source file:

     #import <UserNotifications/UserNotifications.h>
     #import <IterableAppExtensions/IterableExtensions.h>
     
     @interface NotificationService : ITBNotificationServiceExtension
     
     @end
     

3. In Iterable, create a rich push template by navigating to Templates > Create New Template > Push. Then, for iOS 10 Attachment URL, provide an image URL:

   

   NOTE

   iOS requires that the attachment URLs use HTTPS.

   Click Iterable's preview of the push notification to expand it and show the image.

#Android

Rich push notifications for Android are only supported in version 2.2.4 (from March 2018) and higher of Iterable's Android SDK.

When creating a push template in Iterable, in the Android Attachment URL field, enter the URL for the image you'd like the push notification to display:

Click Iterable's preview of the push notification to expand it and show the image.