ブロードキャストレシーバー {#android-push-listener-broadcast-receiver} を介したプッシュの受信、開封、却下、およびキーと値のペアのカスタム処理
important:
プッシュ通知にカスタムBroadcastReceiver を使用することは廃止された。代わりに subscribeToPushNotificationEvents()で代用する。
また、Braze は、プッシュ通知が受信、開封、または却下されたときにカスタムインテントをブロードキャストします。これらのシナリオに特定のユースケースがある場合 (カスタムのキーと値のペアをリッスンする必要がある場合や、ディープリンクを独自に処理する必要がある場合など)、カスタム BroadcastReceiver を作成してこれらのインテントをリッスンする必要があります。
ステップ 1:BroadcastReceiverを登録する
カスタムBroadcastReceiver を登録して、AndroidManifest.xml でBrazeプッシュ開封をリッスンし、インテントを受信します。
1
2
3
4
5
6
7
<receiver android:name="YOUR-BROADCASTRECEIVER-NAME" android:exported="false" >
<intent-filter>
<action android:name="com.braze.push.intent.NOTIFICATION_RECEIVED" />
<action android:name="com.braze.push.intent.NOTIFICATION_OPENED" />
<action android:name="com.braze.push.intent.NOTIFICATION_DELETED" />
</intent-filter>
</receiver>
ステップ2:BroadcastReceiverを作成する
レシーバーは、Brazeからブロードキャストされたインテントを処理し、それを使ってアクティビティを起動する：
- これは
BroadcastReceiverをサブクラス化し、onReceive()をオーバーライドする必要があります。 onReceive()メソッドは、Braze でインテントブロードキャストをリッスンする必要があります。- プッシュ通知が届くと、
NOTIFICATION_RECEIVEDインテントを受信する。 - ユーザーがプッシュ通知をクリックすると、
NOTIFICATION_OPENEDインテントが受信されます。 - ユーザーがプッシュ通知を却下 （スワイプ） すると、
NOTIFICATION_DELETEDインテントが受信されます。
- プッシュ通知が届くと、
- これらのケースごとにカスタムロジックを実行する必要があります。受信者がディープリンクを開封する場合は、
braze.xmlでcom_braze_handle_push_deep_links_automaticallyをfalseに設定し、自動ディープリンク開封を無効にしてください。
カスタム・レシーバーの詳細な例については、以下のコード・スニペットを参照のこと：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
public class CustomBroadcastReceiver extends BroadcastReceiver {
private static final String TAG = CustomBroadcastReceiver.class.getName();
@Override
public void onReceive(Context context, Intent intent) {
String pushReceivedAction = Constants.BRAZE_PUSH_INTENT_NOTIFICATION_RECEIVED;
String notificationOpenedAction = Constants.BRAZE_PUSH_INTENT_NOTIFICATION_OPENED;
String notificationDeletedAction = Constants.BRAZE_PUSH_INTENT_NOTIFICATION_DELETED;
String action = intent.getAction();
Log.d(TAG, String.format("Received intent with action %s", action));
if (pushReceivedAction.equals(action)) {
Log.d(TAG, "Received push notification.");
} else if (notificationOpenedAction.equals(action)) {
BrazeNotificationUtils.routeUserWithNotificationOpenedIntent(context, intent);
} else if (notificationDeletedAction.equals(action)) {
Log.d(TAG, "Received push notification deleted intent.");
} else {
Log.d(TAG, String.format("Ignoring intent with unsupported action %s", action));
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
class CustomBroadcastReceiver : BroadcastReceiver() {
override fun onReceive(context: Context, intent: Intent) {
val pushReceivedAction = Constants.BRAZE_PUSH_INTENT_NOTIFICATION_RECEIVED
val notificationOpenedAction = Constants.BRAZE_PUSH_INTENT_NOTIFICATION_OPENED
val notificationDeletedAction = Constants.BRAZE_PUSH_INTENT_NOTIFICATION_DELETED
val action = intent.action
Log.d(TAG, String.format("Received intent with action %s", action))
when (action) {
pushReceivedAction -> {
Log.d(TAG, "Received push notification.")
}
notificationOpenedAction -> {
BrazeNotificationUtils.routeUserWithNotificationOpenedIntent(context, intent)
}
notificationDeletedAction -> {
Log.d(TAG, "Received push notification deleted intent.")
}
else -> {
Log.d(TAG, String.format("Ignoring intent with unsupported action %s", action))
}
}
}
companion object {
private val TAG = CustomBroadcastReceiver::class.java.name
}
}
tip:
通知アクションボタンを使用すると、opens app または deep link アクションを持つボタンがクリックされると、BRAZE_PUSH_INTENT_NOTIFICATION_OPENED インテントが起動します。ディープリンクとエクストラの処理は変わりません。close アクション付きのボタンは BRAZE_PUSH_INTENT_NOTIFICATION_OPENED インテントを起動せず、通知を自動的に閉じます。
ステップ 3:カスタムキーと値のペアにアクセスする
ダッシュボード またはメッセージング API を介して送信されたカスタムキーと値のペアは、選択した用途に応じてカスタムブロードキャストレシーバでアクセス可能になります。
1
2
3
4
5
6
7
8
// intent is the Braze push intent received by your custom broadcast receiver.
String deepLink = intent.getStringExtra(Constants.BRAZE_PUSH_DEEP_LINK_KEY);
// The extras bundle extracted from the intent contains all custom key-value pairs.
Bundle extras = intent.getBundleExtra(Constants.BRAZE_PUSH_EXTRAS_KEY);
// example of getting specific key-value pair from the extras bundle.
String myExtra = extras.getString("my_key");
1
2
3
4
5
6
7
8
// intent is the Braze push intent received by your custom broadcast receiver.
val deepLink = intent.getStringExtra(Constants.BRAZE_PUSH_DEEP_LINK_KEY)
// The extras bundle extracted from the intent contains all custom key-value pairs.
val extras = intent.getBundleExtra(Constants.BRAZE_PUSH_EXTRAS_KEY)
// example of getting specific key-value pair from the extras bundle.
val myExtra = extras.getString("my_key")
note:
Braze のプッシュデータキーに関するドキュメントは、Android SDK を参照してください。
GitHub でこのページを編集
「このページはどの程度役に立ちましたか?」
New Stuff!