アクションボタン
Braze Swift SDK では、プッシュアクションボタン用の URL 処理がサポートされています。
Braze のデフォルトプッシュカテゴリのデフォルトプッシュアクションボタンには、4つのセット Accept/Decline
、Yes/No
、Confirm/Cancel
、More
があります。
独自の通知カテゴリを作成する場合は、アクションボタンカスタマイズを参照してください。
自動統合(推奨)
configuration.push.automation
設定オプションを使用してプッシュを統合すると、Brazeは自動的にデフォルトプッシュカテゴリのアクションボタンを登録し、プッシュアクションボタンのクリック分析とURLルーティングを処理します。
手動統合
これらのプッシュアクションボタンs を手動で有効にするには、まずデフォルトプッシュカテゴリに登録します。次に、didReceive(_:completionHandler:)
デリゲートメソッドを使用してプッシュアクションボタンs を有効にします。
ステップ1:Braze デフォルトプッシュカテゴリの追加
register for push の場合、デフォルトのプッシュカテゴリに登録するには、次のコードを使用します。
1
UNUserNotificationCenter.current().setNotificationCategories(Braze.Notifications.categories)
1
[[UNUserNotificationCenter currentNotificationCenter] setNotificationCategories:BRZNotifications.categories];
バックグラウンドアクティベーションモードでプッシュアクションボタンをクリックすると、通知が閉じられるだけで、アプリは開きません。ユーザーが次回アプリを開くと、これらのアクションのボタンクリック分析がサーバーにフラッシュされます。
ステップ2:インタラクティブなプッシュ処理を有効にする
クリック分析や URL ルーティングを含むプッシュアクションボタンの処理を有効にするには、アプリの didReceive(_:completionHandler:)
デリゲートメソッドに次のコードを追加します。
1
AppDelegate.braze?.notifications.handleUserNotification(response: response, withCompletionHandler: completionHandler)
1
2
[AppDelegate.braze.notifications handleUserNotificationWithResponse:response
withCompletionHandler:completionHandler];
UNNotification
フレームワークを使用し、Braze 通知メソッド を実装した場合、このメソッドはすでに統合されている必要があります。
プッシュカテゴリのカスタマイズ
Brazeはデフォルトのプッシュカテゴリのセットを提供するだけでなく、カスタムの通知カテゴリとアクションもサポートしています。アプリケーションにカテゴリを登録すると、Braze ダッシュボードを使用してこれらのカスタム通知カテゴリをユーザーに送信できます。
その後、これらのカテゴリーをダッシュボードからプッシュ通知に割り当てて、デザインのアクションボタン構成をトリガーできます。
カスタムプッシュカテゴリの例
デバイスに表示される LIKE_CATEGORY
を活用する例を次に示します。
を表示するプッシュメッセージ
ステップ1:カテゴリを登録する
以下のような方法で、アプリにカテゴリを登録します。
1
2
3
4
5
6
7
8
9
10
Braze.Notifications.categories.insert(
.init(identifier: "LIKE_CATEGORY",
actions: [
.init(identifier: "LIKE_IDENTIFIER", title: "Like", options: [.foreground]),
.init(identifier: "UNLIKE_IDENTIFIER", title: "Unlike", options: [.foreground])
],
intentIdentifiers: []
)
)
UNUserNotificationCenter.current().setNotificationCategories(Braze.Notifications.categories)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
NSMutableSet<UNNotificationCategory *> *categories = [BRZNotifications.categories mutableCopy];
UNNotificationAction *likeAction = [UNNotificationAction actionWithIdentifier:@"LIKE_IDENTIFIER"
title:@"Like"
options:UNNotificationActionOptionForeground];
UNNotificationAction *unlikeAction = [UNNotificationAction actionWithIdentifier:@"UNLIKE_IDENTIFIER"
title:@"Unlike"
options:UNNotificationActionOptionForeground];
UNNotificationCategory *likeCategory = [UNNotificationCategory categoryWithIdentifier:@"LIKE_CATEGORY"
actions:@[likeAction, unlikeAction]
intentIdentifiers:@[]
options:UNNotificationCategoryOptionNone];
[categories addObject:likeCategory];
[UNUserNotificationCenter.currentNotificationCenter setNotificationCategories:categories];
UNNotificationAction
を作成するときに、アクションオプションのリストを指定できます。たとえば、UNNotificationActionOptions.foreground
を使用して、ユーザーがアクションボタンをタップしてからアプリを開けるようにします。これは、「アプリを開く」や「アプリケーションにディープリンクする」などのナビゲーションクリック時の動作に必要です。詳細については、UNNotificationActionOptions
を参照してください。
ステップ2:カテゴリを選択
カテゴリを登録したら、Braze ダッシュボードを使用して、そのタイプの通知をユーザーに送信します。
アプリケーションにディープリンクしたり、URL を開いたりするアクションなど、_特殊なアクション_を含むアクションボタンの場合にのみ、カスタム通知カテゴリを定義する必要があります。通知を閉じるだけのアクションボタン用に定義する必要はありません。
- Braze ダッシュボードで、メッセージング> プッシュ通知を選択し、iOS プッシュキャンペーンを選択します。
- [プッシュ通知を作成する] の下で、[アクションボタン] をオンにします。
- [iOS 通知カテゴリ] ドロップダウンで、[事前登録されたカスタム iOS カテゴリを入力] を選択します。
- 最後に、前に作成したカテゴリのいずれかを入力します。次の例では、カスタムカテゴリ
LIKE_CATEGORY
を使用します。