基本セットアップ
MoEngage を使用して Android デバイスでプッシュ通知を有効にするには、このセクションで説明する基本セットアップに従ってください。
- MoEngage ダッシュボードでの FCM セットアップ - FCM 認証は、Android デバイスにインストールされたアプリにプッシュ通知を送信できるようにするための方法です。こちらの記事に記載されている方法を使用して、MoEngage が Firebase サービスにアクセスできるよう認証します。
- プッシュ通知のメタデータの追加 - こちらの記事で説明されている方法を使用して、スモールアイコンとラージアイコンの drawable、およびプッシュ通知を処理するためのその他のオプションを設定します。
- Android 通知のランタイム権限 - アプリケーションが Android 13 で実行されている場合、ユーザーに通知を表示するには、ユーザーに通知権限をリクエストする必要があります。権限リクエストを処理するには、こちらの記事で説明されている方法を参照してください。
- プッシュの登録と受信 - React Native アプリケーションでプッシュ通知を使用するには、Firebase を設定する必要があります。Firebase の設定手順は、統合方法によって異なります。ベストプラクティスが適切に統合されているため、MoEngage はプッシュの処理を MoEngage SDK に任せることをお勧めします。アプリレベルでプッシュを処理することもできます。いずれの場合も、該当する次のセクションを確認し、統合手順を完了してください。
メッセージングサービスの追加
MoEngage SDK が通知を表示するには、マニフェストファイルにメッセージングサービスを追加する必要があります。こちらのドキュメントを参照してください。トークン登録時のコールバック(任意)
新しいトークンが登録または更新されるたびにコールバックを受け取るには、こちらの方法を参照してください。通知クリックコールバックプッシュがクリックされるたびにコールバックを受け取り、リダイレクトをカスタム処理するには、こちらの記事の方法を使用します。 MoEngage の登録をオプトアウトするには?
MoEngage SDK はプッシュトークンの登録を試みます。アプリケーションがプッシュを処理するため、こちらの記事の方法を使用して SDK のトークン登録をオプトアウトする必要があります。プッシュトークンを MoEngage SDK に渡す - FCM からプッシュトークンを受信したら、こちらの記事の方法を使用してプッシュトークンを MoEngage SDK に渡し、MoEngage プラットフォームに設定します。プッシュペイロードを MoEngage SDK に渡す - アプリでプッシュペイロードを受信したら、こちらの記事の方法を使用してデバイスにプッシュ通知を送信します。 MoEngage では、React-Native/JavaScript API ではなく Android ネイティブ API を使用してプッシュペイロードを MoEngage SDK に渡すことをお勧めします。アプリケーションが強制終了されている場合や、通知が高い優先度で送信されていない場合、React-Native エンジンが初期化されない可能性があります。
Capacitor API
プッシュペイロードを MoEngage SDK に渡す際は、Capacitor API ではなく Android ネイティブ API を使用することを強くお勧めします。アプリケーションが強制終了されている場合や、通知が高い優先度で送信されていない場合、Capacitor エンジンが初期化されない可能性があります。
プッシュトークンの受け渡し
プッシュペイロードの受け渡し
プッシュペイロードを MoEngage SDK に渡す際は、Capacitor API ではなく Android ネイティブ API を使用することを強くお勧めします。アプリケーションが強制終了されている場合や、通知が高い優先度で送信されていない場合、Capacitor エンジンが初期化されない可能性があります。
通知のランタイム権限
Android 13(API レベル 33)以降では、アプリから対象外ではない(フォアグラウンドサービス(FGS)を含む)通知を送信するためのランタイム権限 POST_NOTIFICATIONS がサポートされています。この変更により、ユーザーは自分にとって最も重要な通知に集中できるようになります。
詳細については、公式ドキュメントを参照してください。
以下の API は、プラグインバージョン 2.0.0 からサポートされています。
アプリケーションが Android 13 で実行されている場合、ユーザーに通知を表示するには、ユーザーに通知権限をリクエストする必要があります。
MoEngage SDK を統合するアプリケーションでは、次の対応が必要です。
- ユーザーからの権限リクエストに対する応答を SDK に通知する。
- アプリケーションが(MoEngage の統合前に)すでにプッシュ権限をリクエストしている場合は、通知を表示するための通知チャネルを MoEngage がセットアップできるようにする。
権限の結果を SDK に通知する
アプリケーションがユーザーに通知権限をリクエストしたら、以下の API を使用してユーザーの応答を SDK に通知します。
通知チャネルのセットアップ
アプリケーションがすでにユーザーから通知権限を取得している場合は、以下の API を呼び出して、プッシュ通知を表示するための通知チャネルをセットアップします。
MoEngage SDK は、エンドユーザーに権限リクエストを表示したり、通知を有効にするための設定画面にユーザーを移動させたりするためのヘルパー API を提供しています。
ユーザーに権限リクエストダイアログを表示するには、以下の API を使用します。
以下の API を使用すると、SDK は上記の応答のトラッキングや必要な通知チャネルのセットアップなどを自動的に行います。
デバイス上のアプリケーションの通知設定にユーザーを移動させるには、以下の API を使用します。
注: Android 8(API レベル 26)未満では、ユーザーはアプリケーションのアプリ情報画面に移動します。
プッシュ通知のカスタマイズ
必要に応じて、アプリケーションはネイティブ Android コード(Java/Kotlin)を使用して通知の動作をカスタマイズできます。カスタマイズの詳細については、高度なプッシュ設定のドキュメントを参照してください。上記のドキュメントに記載されているように PushMessageListener を継承する代わりに、PluginPushCallback. を継承してください。
Push Amp+、プッシュテンプレート、ジオフェンスについては、以下のドキュメントを参照してください。