Deep Linking

Overview of how the SDK handles deep links and how to perform custom navigation within your application

The PushSDK handles opening of a notification in the following ways:

Android

  • By default, the SDK will automatically create a new ACTION_VIEW intent using the landing URL attached to the notification.

iOS

  • By default, the SDK will automatically call the open method using the landing URL attached to the notification.

If you implement the onPushSDKDidReceiveNotificationDestination lifecycle callback you can perform any custom logic needed when the notification is opened.

Implementing URL Handling Callbacks

The PushSDK provides callbacks that will be called when a subscriber interacts with a notification. These callbacks should be implemented so that the subscriber is automatically navigated to the proper activity after opening the notification.

It is recommend to put all SDK callbacks within your application's main.dart file to ensure proper handling of all notification events.

When the SDK receives a notification open event it will attempt to call one of the below callbacks with parameters that you can use to navigate the subscriber to the appropriate activity within your app.

In order to implement these callbacks you can use SDK's registerNotificationLifecycleCallbacks method and implements the callback(s) within it.

import 'package:pushly_pushsdk/pushsdk.dart';

...
await PushSDK.registerNotificationLifecycleCallbacks(
    // Add function overrides here
);

For example, if a landing URL was attached to the notification and you implemented the callback to handle subscriber navigation your method the code may look like this:

import 'package:pushly_pushsdk/pushsdk.dart';

...
await PushSDK.registerNotificationLifecycleCallbacks(
    onPushSDKDidReceiveNotificationDestination: (destination, interaction) {
        // Navigate to a activity within your application using the destination (the Landing URL)
        
        // Return true to inform the SDK that it should not navigate 
        return true;
    }
);

Notification Interaction Callbacks

Notification Opened With URI/URL Destination

Use this callback when you need to perform custom parsing and/or modification of the attached landing URL that wouldn't be properly handled by opening the URL directly.

This callback is invoked when a notification is opened that has destination landing URL attached. The subscriber should be navigated to the view that represents the provided landing URL.

This method expects a boolean response. If the response is true then the SDK will perform no additional actions for this notification open. If the response is false then the SDK will attempt to navigate the subscriber to the destination URL.

onPushSDKDidReceiveNotificationDestination: (destination, interaction) {
    // Navigate to a activity within your application using the destination (the Landing URL)
        
    // Return true to inform the SDK that it should not navigate 
    return true;
}

Last updated