Amazon Pinpoint
Developer Guide

Handling Push Notifications from Apple Push Notification Service

You can enable your iOS app to receive push notifications that you send by using Amazon Pinpoint. With Amazon Pinpoint, you can send push notifications to iOS apps through Apple Push Notification service (APNs).


Before you update your app to receive push notifications, integrate the AWS Mobile SDK for iOS. For more information, see Integrating the AWS Mobile SDKs for Android or iOS.

Enabling Push Notifications

To enable push notifications in your app, update your app to include push listening code. For more information, see Add Push Notifications to Your Mobile App with Amazon Pinpoint in the AWS Mobile Developer Guide.

Setting Up Deep Linking

Amazon Pinpoint campaigns can take one of three actions when a user taps a notification. One of those possible actions is a deep link, which opens the app to a specified activity.

Registering a Custom URL Scheme

To specify a destination activity for deep links, the app must have set up deep linking. This setup requires registering a custom URL scheme the deep links will use. To register a custom URL identifier, go to your Xcode project's target Info tab and expand the URL Types section.

To open the app via a pinpoint:// URL scheme you need to assign a unique identifier to the scheme. Apple recommends reverse DNS notation to avoid name collisions on the platform. The following example uses com.exampleCorp.exampleApp:

To register a custom URL scheme in Xcode:

  1. In Xcode, select the Info tab.

  2. In the URL Types section, select + to add a URL type.

  3. Enter the reverse DNS notation identifier for this URL type in Identifier.

  4. Enter the URL you want to use for your app in URL Schemes.

  5. Save the project.

After this custom URL scheme is registered, test it in the iOS simulator. Open Safari and navigate to your custom URL; in this example, pinpoint://. Your app launches and opens to its home screen.

Listening for Custom URLs

To direct the app to a specific view, implement a callback in your AppDelegate that is called when your app launches from a deep link. The scheme launches the app, using the host and path to go to a separate screen within the app.