Firebase コンソールの Notifications Composer を使用して通知メッセージを送信できます。Admin SDK や HTTP / XMPP プロトコルでメッセージを送信する場合と比べると、柔軟性やスケーラビリティの点で劣りますが、テスト目的やターゲットを絞り込んだマーケティング、ユーザー エンゲージメントには便利な方法です。Firebase コンソールは、マーケティング メッセージの改善に役立つ、アナリティクスに基づく A/B テスト機能を提供します。
アプリ側でメッセージを受信するロジックを開発しておけば、技術的に詳しくないユーザーでも、Notifications Composer を使用してメッセージを送信できます。
概要
Notifications Composer からメッセージを送信する場合、Google はフォームのフィールドに入力された値を次の方法で使用します。
- [ユーザー セグメント] や [有効期限] などのフィールドによってメッセージのターゲットと配信オプションを決定します。
- [通知テキスト] や [カスタムデータ] などのフィールドは、Key-Value ペアで構成されるペイロードでクライアントに送信されます。
これらのフィールドは、Message
オブジェクトを通じて使用可能なキーにマッピングされます。たとえば、Composer の [カスタムデータ] フィールドに入力された Key-Value ペアは、通知の data
ペイロードとして処理されます。他のフィールドは、notification
オブジェクトまたはプラットフォーム固有の通知構成内のキーに直接マッピングされます。
Notifications Composer の一部のフィールドは FCM API では使用できません。たとえば、アプリのバージョン、言語、ブラウザの種類やバージョン、ユーザー プロパティなど、サーバー API では可能ではない方法で特定のユーザー セグメントをターゲットとして設定できます。
Firebase コンソールからクライアントに送信されるキーには次のものがあります。
キー | コンソール フィールドのラベル | 説明 |
---|---|---|
notification.title |
通知のタイトル | 通知のタイトルを示します。 |
notification.body |
通知テキスト | 通知の本文テキストを示します。 |
data |
カスタムデータ | 定義した Key-Value ペア。これらのペアは、処理するアプリのデータ ペイロードとして配信されます。 |
メッセージの配信を決定するキーには次のものが含まれます。
キー | コンソール フィールドのラベル | 説明 |
---|---|---|
sound |
通知音 |
デバイスが通知を受信したときに再生する通知音を示します。 |
time_to_live |
有効期限 | このパラメータでは、デバイスがオフラインの場合にメッセージを FCM のストレージに保持する期間(秒単位)を指定します。詳細については、メッセージの有効期間の設定をご覧ください。 |