SDK デリゲート

すべての SDK デリゲートをアプリケーションの AppDelegate クラス内に含めることを推奨します。これにより、すべてのイベントを適切に処理できます。

SDK ライフサイクル デリゲート

これらのデリゲートを実装すると、SDK の読み込みと終了を監視できます。

このプロトコルを実装するクラスを SDK に通知する必要があります。これは、 setSDKLifecycleDelegate メソッドを SDK で使用して行えます:

Swift

PushSDK.setSDKLifecycleDelegate(self)

Objective-C

以下の SDK ライフサイクル デリゲートが利用できます:

読み込み完了

このデリゲートは、SDK が初期化を完了し、操作可能になったときに呼び出されます。

Swift

func pushSDK(didFinishLoading configuration: PNApplicationConfig, withNotificationSettings settings: UNNotificationSettings) {
    // SDK の読み込み完了後に実行するコードを追加
}

Objective-C

権限ライフサイクルデリゲート

これらのデリゲートを実装すると、ユーザーの権限承認の変更を監視できます。

このプロトコルを実装するクラスを SDK に通知する必要があります。これは、 setPermissionLifecycleDelegate メソッドを SDK で使用して行えます:

Swift

PushSDK.setPermissionLifecycleDelegate(self)

Objective-C

以下の権限ライフサイクル デリゲートが利用できます:

権限ステータスの変更

このデリゲートは、ユーザーの権限ステータス/承認が変更されたときに呼び出されます。

「 status 変数はユーザーの 新しい 権限ステータスを UNAuthorizationStatus 列挙型を使用して表します。

Swift

func pushSDK(didReceivePermissionStatusChange status: UNAuthorizationStatus, withSettings settings: UNNotificationSettings) {
    // ユーザーの通知権限が変更された後に実行するコードを追加
}

Objective-C

通知ライフサイクル デリゲート

これらのデリゲートを実装すると、インプレッション、オープン、その他の通知とのインタラクションなどのイベントを監視できます。

このプロトコルを実装するクラスを SDK に通知する必要があります。これは、 setNotificationLifecycleDelegate メソッドを SDK で使用して行えます:

Swift

PushSDK.setNotificationLifecycleDelegate(self)

Objective-C

以下の通知ライフサイクル デリゲートが利用できます:

通知受信

このデリゲートは、ユーザーが通知を受信したときに呼び出されます

Swift

func pushSDK(didReceiveNotification notification: PNNotification)
    // サブスクライバーのデバイスが通知を受信した後に実行するコードを追加
}

Objective-C

URI/URL 宛先付きで通知が開かれた場合

このデリゲートは、ランディング URL が関連付けられた通知が開かれたときに呼び出されます。サブスクライバーは、その URL を表すビューへ移動する必要があります。

このメソッドは Boolean の応答を想定しています。応答が true の場合、この通知のオープンに対して SDK はナビゲーションを行いません。応答が false の場合、SDK は open メソッド内に追加します。

Swift

func pushSDK(didReceiveNotificationDestination destination: String, withInteraction interaction: PNNotificationInteraction) -> Bool {
    // destination（ランディング URL）を使用して、アプリケーション内のビューへ移動
        
    // SDK に対して遷移しないよう通知するために true を返す
    return true
}

Objective-C

次を参照してください。 ディープリンク 完全な例についてはドキュメントを参照してください。

アプリメッセージ ライフサイクル デリゲート

これらのデリゲートを実装すると、インプレッション、オープン、その他のアプリメッセージとのインタラクションなどのイベントを監視できます。

このプロトコルを実装するクラスを SDK に通知する必要があります。これは、 setAppMessageLifecycleDelegate メソッドを SDK で使用して行えます:

Swift

PushSDK.setAppMessageLifecycleDelegate(self)

Objective-C

以下のアプリメッセージ ライフサイクル デリゲートが利用できます:

アプリメッセージ表示時

このデリゲートは、アプリメッセージがユーザーに表示されたときに呼び出されます。

Swift

func pushSDK(willPresentAppMessage appMessage: PNAppMessage) {
    // ユーザーのデバイスにアプリメッセージが表示されたときに実行するコードを追加
}

Objective-C

アプリメッセージでユーザーが操作したとき

このデリゲートは、ユーザーがアプリメッセージとやり取りしたときに呼び出されます。

このメソッドは Boolean の応答を想定しています。応答が true その場合、SDK はそのインタラクションを処理せず、Open URL アクションの場合もナビゲーションを試みません。応答が false の場合、SDK はそのインタラクションを処理し、インタラクションが Open URL アクションの場合は、 open メソッド内に追加します。

Swift

func pushSDK(didReceiveAppMessageInteraction interaction: PNAppMessageInteraction, fromAppMessage appMessage: PNAppMessage) -> Bool {
    // ユーザーがアプリメッセージとやり取りしたときに実行するコードを追加
    
    // SDK がそのインタラクションを処理しないようにするには true を返します
    return true
}

Objective-C