プッシュ通知をカスタマイズする

前提条件

この機能を使用する前に、Android Braze SDKを統合する必要があります。 プッシュ通知を設定する必要もあります。

プッシュイベントにコールバックを使用する

Braze には、プッシュ通知が受信されたとき、開かれたとき、または却下されたときのための subscribeToPushNotificationEvents() コールバックが用意されています。アプリケーションが実行されていないときに発生するイベントを見逃さないように、このコールバックを Application.onCreate() に配置することをお勧めします。

• java
• kotlin

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
Braze.getInstance(context).subscribeToPushNotificationEvents(event -> {
  final BrazeNotificationPayload parsedData = event.getNotificationPayload();

  //
  // The type of notification itself
  //
  final boolean isPushOpenEvent = event.getEventType() == BrazePushEventType.NOTIFICATION_OPENED;
  final boolean isPushReceivedEvent = event.getEventType() == BrazePushEventType.NOTIFICATION_RECEIVED;
  // Sent when a user has dismissed a notification
  final boolean isPushDeletedEvent = event.getEventType() == BrazePushEventType.NOTIFICATION_DELETED;

  //
  // Notification data
  //
  final String pushTitle = parsedData.getTitleText();
  final Long pushArrivalTimeMs = parsedData.getNotificationReceivedTimestampMillis();
  final String deeplink = parsedData.getDeeplink();

  //
  // Custom KVP data
  //
  final String myCustomKvp1 = parsedData.getBrazeExtras().getString("my first kvp");
  final String myCustomKvp2 = parsedData.getBrazeExtras().getString("my second kvp");
});

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
Braze.getInstance(context).subscribeToPushNotificationEvents { event ->
    val parsedData = event.notificationPayload

    //
    // The type of notification itself
    //
    val isPushOpenEvent = event.eventType == BrazePushEventType.NOTIFICATION_OPENED
    val isPushReceivedEvent = event.eventType == BrazePushEventType.NOTIFICATION_RECEIVED
    // Sent when a user has dismissed a notification
    val isPushDeletedEvent = event.eventType == BrazePushEventType.NOTIFICATION_DELETED

    //
    // Notification data
    //
    val pushTitle = parsedData.titleText
    val pushArrivalTimeMs = parsedData.notificationReceivedTimestampMillis
    val deeplink = parsedData.deeplink

    //
    // Custom KVP data
    //
    val myCustomKvp1 = parsedData.brazeExtras.getString("my first kvp")
    val myCustomKvp2 = parsedData.brazeExtras.getString("my second kvp")
}

通知ディスプレイのカスタマイズ

ステップ 1: カスタム通知ファクトリーを作成する

サーバー側では面倒な方法や利用できない方法でプッシュ通知をカスタマイズしたい場合があります。通知表示を完全に制御できるよう追加された機能により、独自の IBrazeNotificationFactory を定義して Braze で表示する通知オブジェクトを作成できるようになりました。

カスタムの IBrazeNotificationFactory が設定されている場合、ユーザーに通知が表示される前に、プッシュ受信時に Braze がファクトリーの createNotification() メソッドを呼び出します。Braze は、Braze プッシュデータを含む Bundle と、ダッシュボードまたはメッセージング API 経由で送信されたカスタムのキーと値のペアを含む別の Bundle を渡します。

Braze は、Braze プッシュ通知からのデータを含むBrazeNotificationPayload を渡します。

• java
• kotlin

1
2
3
4
5
6
7
8
9
// Factory method implemented in your custom IBrazeNotificationFactory
@Override
public Notification createNotification(BrazeNotificationPayload brazeNotificationPayload) {
  // Example of getting notification title
  String title = brazeNotificationPayload.getTitleText();

  // Example of retrieving a custom KVP ("my_key" -> "my_value")
  String customKvp = brazeNotificationPayload.getBrazeExtras().getString("my_key");
}

1
2
3
4
5
6
7
8
// Factory method implemented in your custom IBrazeNotificationFactory
override fun createNotification(brazeNotificationPayload: BrazeNotificationPayload): Notification {
  // Example of getting notification title
  val title = brazeNotificationPayload.getTitleText()

  // Example of retrieving a custom KVP ("my_key" -> "my_value")
  val customKvp = brazeNotificationPayload.getBrazeExtras().getString("my_key")
}

カスタムの createNotification() メソッドから null を返して通知をまったく表示しないことも、BrazeNotificationFactory.getInstance().createNotification() を使用してそのデータのデフォルトの notification オブジェクトを取得し、表示前に変更することも、完全に別個の notification オブジェクトを生成して表示することもできます。

ステップ 2:カスタム通知ファクトリーを設定する

Braze にカスタム通知ファクトリーを使用するように指示するには、setCustomBrazeNotificationFactory メソッドを使用して IBrazeNotificationFactory を設定します。

• java
• kotlin

1
setCustomBrazeNotificationFactory(IBrazeNotificationFactory brazeNotificationFactory);

1
setCustomBrazeNotificationFactory(brazeNotificationFactory: IBrazeNotificationFactory)

カスタム IBrazeNotificationFactory を設定する場所として推奨されるのは、Application.onCreate() アプリケーションのライフサイクルメソッド (アクティビティではない) です。これにより、アプリプロセスがアクティブなときはいつでも通知ファクトリーを正しく設定できるようになります。

カスタム IBrazeNotificationFactory の設定を解除し、プッシュのデフォルトの Braze 処理に戻すには、null をカスタム通知ファクトリー設定機能に渡します。

• java
• kotlin

1
setCustomBrazeNotificationFactory(null);

1
setCustomBrazeNotificationFactory(null)

マルチカラーテキストのレンダリング

Braze SDK 3.1.1 では、プッシュ通知 s でマルチカラーテキストをレンダリングするためにHTMLを装置に送信できます。

この例は、以下の HTML でレンダリングされます。

1
2
3
<p><span style="color: #99cc00;">M</span>u<span style="color: #008080;">lti</span>Colo<span style="color: #ff6600;">r</span> <span style="color: #000080;">P</span><span style="color: #00ccff;">u</span><span style="color: #ff0000;">s</span><span style="color: #808080;">h</span></p>

<p><em>test</em> <span style="text-decoration: underline; background-color: #ff6600;"><strong>message</strong></span></p>

プッシュ通知sで有効なHTML要素とタグsをAndroid制限することに注意してください。たとえば、marquee は使用できません。

プッシュ通知でマルチカラーテキストをレンダリングするには、braze.xml またはBrazeConfig を更新します。

• braze.xml
• brazeconfig

1
<bool translatable="false" name="com_braze_push_notification_html_rendering_enabled">true</bool>

1
2
3
4
BrazeConfig brazeConfig = new BrazeConfig.Builder()
  .setPushHtmlRenderingEnabled(true)
  .build();
Braze.configure(this, brazeConfig);

1
2
3
4
val brazeConfig = BrazeConfig.Builder()
    .setPushHtmlRenderingEnabled(true)
    .build()
Braze.configure(this, brazeConfig)

対応HTML タグ

現在、Google はAndroid でサポートされているHTML タグをドキュメントに直接的に一覧表示しません。この情報は、Git リポジトリのHtml.java file にのみ表示されます。この情報はこのファイルから取得され、サポートされているHTML タグs は変更される可能性があるため、次のテーブルを参照するときはこの点に注意してください。

インライン”画像のレンダリング

仕組み

インライン”画像プッシュを使用して、Android プッシュ通知内の大きな”画像を表示できます。この設計により、ユーザーは画像を拡大するために手動でプッシュを拡大する必要がなくなります。通常の Android プッシュ通知とは異なり、インライン画像プッシュ画像の縦横比は 3:2 です。

互換性

インライン”画像s を任意のデバイスに送信できますが、最低限のバージョンを満たしていないデバイスやSDKでは、代わりに通常の”画像が表示されます。インライン”画像s を正しく表示するには、Android Braze SDK v10.0.0+ とAndroid M+ を実行する機器の両方が必要です。”画像をレンダリングするには、SDKも有効にする必要があります。

インライン”画像プッシュの送信

Android プッシュメッセージを作成する場合、この機能は [通知タイプ] ドロップダウンで使用できます。

設定

Braze ダッシュボードを介して送信されるAndroid プッシュ通知には、多くの高度な設定が利用可能です。この記事では、これらの機能とそれらを効果的に使用する方法について説明します。

通知 ID

通知 ID は、選択したメッセージカテゴリの一意の識別子です。その ID からの最新のメッセージのみを尊重するようメッセージングサービスに通知する役割を果たします。通知 ID を設定すると、古くて無関係なメッセージのスタックではなく、最新で関連性の高いメッセージだけを送信できます。

Firebase メッセージング配信の優先度

Firebase Messaging Delivery Priority フィールドでは、「通常」または「高」のどちらの優先度でプッシュを Firebase Cloud Messaging に送信するかを制御できます。

有効時間 (TTL)

有効期間 (TTL) フィールドを使用すると、プッシュメッセージングサービスでメッセージを保存する期間をカスタム設定できます。有効期間のデフォルト値は、FCM の場合は 4 週間、ADM の場合は 31 日です。

要約テキスト

要約テキストを使用すると、拡張通知ビューに追加のテキストを設定できます。画像付きの通知のキャプションとしても機能します。

要約テキストは、展開されたビューのメッセージ本文の下に表示されます。

画像を含むプッシュ通知の場合、折りたたまれたビューにはメッセージテキストが表示され、通知が展開されると、要約テキストが画像のキャプションとして表示されます。

カスタム URI

カスタム URI 機能を使用すると、通知がクリックされたときの誘導先 Web URL または Android リソースを指定できます。カスタム URI が指定されていない場合、通知をクリックするとユーザーはアプリに誘導されます。カスタム URI を使用してアプリ内でディープリンクし、アプリ外部のリソースにユーザーを誘導することができます。この設定は、メッセージングAPIまたはダッシュボードのプッシュ作成画面の「詳細設定」から行うことができる：

通知の表示優先度

プッシュ通知の優先度レベルは、通知トレイ内で他の通知と比較して通知がどのように表示されるかに影響します。また、通常のメッセージや優先度の低いメッセージは、バッテリー寿命を延ばすために遅延がわずかに長くなったり、バッチ処理で送信されたりするのに対し、優先度の高いメッセージは常に即座に送信されるため、配信の速度と方法にも影響する可能性があります。

Android O では、通知の優先度が通知チャネルのプロパティになりました。開発者と協力して設定中にチャネルの優先度を定義し、ダッシュボードを使用して通知音を送信するときに適切なチャネルを選択する必要があります。Android がO より前のバージョンで動作している機器では、Android 通知 s のプライオリティレベルをBraze ダッシュボード およびメッセージング API で指定できます。

特定のプライオリティでフルユーザー群を通知するには、 通知 チャネル設定 (ターゲットO+ デバイスへ) * および* によってプライオリティを間接的に指定し、個々のプライオリティをダッシュボード(ターゲット<O デバイスへ) から送信することをお勧めします。

Android または Fire OS プッシュ通知で設定できる優先度レベルは次のとおりです。

詳細については、グーグルのAndroid 通知ドキュメントを参照してください。

サウンド

Android O では、通知音は通知チャネルのプロパティになりました。開発者と協力して設定時にチャネルのサウンドを定義し、通知を送信するときにダッシュボードを使用して適切なチャネルを選択する必要があります。

Android O より前のバージョンを実行しているデバイスの場合、Braze を使用すると、ダッシュボードコンポーザーを通じて個々のプッシュメッセージのサウンドを設定できます。これを行うには、デバイスのローカルサウンドリソースを指定します (例: android.resource://com.mycompany.myapp/raw/mysound)。このフィールドに「default」を指定すると、デフォルトの通知音がデバイスで再生されます。これは、メッセージングAPIまたはダッシュボードのプッシュ作成画面の「詳細設定」で指定できる。

完全なサウンドリソース URI (例: android.resource://com.mycompany.myapp/raw/mysound) をダッシュ​​ボードプロンプトに入力します。

特定のサウンドでフルユーザー群を伝えるには、通知 チャネル設定 (ターゲットO+ デバイスへ) * および* で間接的にサウンドをダッシュボードから(ターゲット<O デバイスへ) 送信することをお勧めします。