プッシュ通知ストーリー

前提条件

この機能を使う前に、Swift Braze SDKを統合する必要がある。 プッシュ通知の設定も必要で、これにはUNNotification フレームワークの実装も含まれる。

プッシュストーリーを受信するには、以下のSDKの最低バージョンが必要である：

プッシュストーリーの設定

ステップ 1: 通知コンテンツ拡張ターゲットを追加する{#notification-content-extension}

アプリ・プロジェクトで、メニュー「ファイル」＞「新規作成」＞「ターゲット」と進み、新しいNotification Content Extension ・ターゲットを追加してアクティブにする。

Xcode によって新しいターゲットが生成され、次のようなファイルが自動的に作成されるはずです。

• NotificationViewController.swift
• MainInterface.storyboard

ステップ2:機能を有効にする

Xcodeで、メインアプリターゲットのSigning& Capabilitiesペインを使用して、Background Modesケイパビリティを追加する。バックグラウンドフェッチとリモート通知の両方のチェックボックスを選択します。

アプリグループの追加

さらに、Xcode のSigning& Capabilitiesペインから、Notification Content Extension ターゲットと同様に、メインアプリターゲットに App Groups ケーパビリティを追加する。次に、＋ボタンをクリックする。アプリのバンドル ID を使用してアプリグループを作成します。たとえば、アプリのバンドル ID が com.company.appname の場合、アプリグループに group.com.company.appname.xyz という名前を付けることができます。

アプリをアプリグループに追加しないと、アプリがプッシュペイロードからの特定のフィールドの入力に失敗し、期待したとおりに完全に動作しない可能性があります。

ステップ3:アプリにPush Storyフレームワークを追加する

• swift package manager
• cocoapods
• manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
target 'YourAppTarget' do
pod 'BrazeKit'
pod 'BrazeUI'
pod 'BrazeLocation'
end

target 'YourNotificationContentExtensionTarget' do
pod 'BrazePushStory'
end

# Only include the below if you want to also integrate Rich Push
target 'YourNotificationServiceExtensionTarget' do
pod 'BrazeNotificationService'
end

ステップ4: 通知ビューコントローラーを更新する{#enable-capabilities}

NotificationViewController.swift に以下の行を追加し、ヘッダーファイルをインポートする：

1
import BrazePushStory

次に、BrazePushStory.NotificationViewController を継承してデフォルトの実装を置き換えます。

1
class NotificationViewController: BrazePushStory.NotificationViewController {}

プッシュストーリーイベントのカスタム処理

独自のカスタムロジックを実装してプッシュストーリー通知イベントを処理する場合は、上記のように BrazePushStory.NotificationViewController を継承し、以下のように didReceive メソッドをオーバーライドします。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
import BrazePushStory
import UserNotifications
import UserNotificationsUI

class NotificationViewController: BrazePushStory.NotificationViewController {
  override func didReceive(_ notification: UNNotification) {
    super.didReceive(notification)
    
    // Custom handling logic
  }
  
  override func didReceive(_ response: UNNotificationResponse, completionHandler completion: @escaping (UNNotificationContentExtensionResponseOption) -> Void) {
    super.didReceive(response, completionHandler: completion)
    
    // Custom handling logic
  }
}

ステップ5:通知コンテンツ拡張 plist を設定する{#notification-content-extension}

Notification Content Extension のInfo.plist ファイルを開き、NSExtension \ NSExtensionAttributes の下に以下のキーを追加・変更する：

あなたのInfo.plist ファイルは、以下の画像と一致するはずだ：

ステップ 6: メインアプリでの Braze 統合の更新{#update-braze}

Brazeを初期化する前に、アプリグループの名前をBraze設定の push.appGroupプロパティに割り当てる。

1
2
3
4
let configuration = Braze.Configuration(apiKey: "<YOUR-BRAZE-API-KEY>",
                                        endpoint: "<YOUR-BRAZE-ENDPOINT>")
configuration.push.appGroup = "REPLACE_WITH_APPGROUP"
let braze = Braze(configuration: configuration)