Android のリッチプッシュ配信の設計 rich-push

IMPORTANT
リッチプッシュ通知を設計する前に、まず V2 コネクタを設定する必要があります。 手順について詳しくは、このページを参照してください。

Firebase Cloud Messaging では、次の 2 種類のメッセージの中から選択できます。

  • データメッセージ​は、クライアントアプリで処理されます。 これらのメッセージは、モバイルアプリケーションに直接送信され、デバイス上で Android 通知を生成して表示されます。 データメッセージには、カスタムアプリケーション変数のみが含まれます。

  • 通知メッセージ​は、FCM SDK によって自動的に処理されます。 FCM は、クライアントアプリに代わって、ユーザーのデバイスにメッセージを自動的に表示します。 通知メッセージには、事前に定義された一連のパラメーターとオプションが含まれていますが、カスタムアプリケーション変数を使用してさらにパーソナライズすることもできます。

インターフェイスでスクロールバーが無効になっている場合は、管理/>プラットフォーム>/オプション​にアクセスし、「XtkUseScrollBar」オプションを 1 に設定します。

Android 通知コンテンツの定義 push-message

プッシュ配信を作成したら、次のいずれかのテンプレートを使用して、そのコンテンツを定義できます。

  • デフォルト​では、シンプルなアイコンと付属の画像を使用して通知を送信できます。

  • 基本​では、通知にテキスト、画像、ボタンを含めることができます。

  • カルーセル​では、ユーザーがスワイプできるテキストと複数の画像を含む通知を送信できます。

  • アイコンボタン​では、アイコンと対応する画像を使用して通知を送信できます。

  • 入力ボックス​では、通知を通じてユーザー入力とフィードバックを直接収集します。

  • 製品カタログ​には、様々な製品画像が表示されます。

  • 製品評価​では、ユーザーはフィードバックを提供し、製品を評価できます。

  • タイマー​には、通知にライブカウントダウンタイマーが含まれます。

  • ゼロベゼル​では、テキストをシームレスにオーバーレイして、画像に対して背景サーフェス全体を使用します。

これらのテンプレートをパーソナライズする方法について詳しくは、以下のタブを参照してください。

デフォルト
  1. 通知タイプ​ドロップダウンから、「デフォルト」を選択します。

  2. メッセージを作成するには、「タイトル」フィールドと「メッセージ」フィールドにテキストを入力します。

  3. 動的パーソナライゼーションフィールドを使用して、コンテンツの定義、データのパーソナライズ、動的コンテンツの追加を行います。 詳細情報

  4. プッシュ通知をさらにカスタマイズするには、プッシュ通知の​ 通知オプション ​と HTTPv1 追加オプション​を設定します。 詳細情報

メッセージのコンテンツを定義したら、テストサブスクライバーを利用して、メッセージをプレビューしテストできます。

基本
  1. 通知タイプ​ドロップダウンから、「基本」を選択します。

  2. メッセージを作成するには、「タイトル」、「メッセージ」、「拡張されたメッセージ」の各フィールドにテキストを入力します。

    メッセージ​テキストは折りたたまれたビューに表示され、通知を拡張すると​ 拡張されたメッセージ ​が表示されます。

  3. 動的パーソナライゼーションフィールドを使用して、コンテンツの定義、データのパーソナライズ、動的コンテンツの追加を行います。 詳細情報

  4. カラーオプション​メニューで、タイトル、メッセージ、背景​の 16 進数のカラーコードを入力します。

  5. 必要に応じて、 「後で通知」ボタン​を追加します。 対応するフィールドに​ リマインダーテキスト ​と​ 日付 ​を入力します。

    「リマインダーの日付」フィールドには、エポックを表す値(秒単位)が必要です。

  6. 「追加ボタン」をクリックし、次のフィールドに入力します。

    • ラベル:ボタンに表示されるテキスト。
    • リンク URI:ボタンクリック時に実行する URI を指定します。

    プッシュ通知には、最大 3 つのボタンを含めるオプションがあります。 「後で通知ボタン」を選択した場合、含めることができるボタンは最大 2 つだけです。

  7. ボタンのリンク先 URL の​ リンクタイプ ​を選択します。

    • Web URL:Web URL は、ユーザーをオンラインコンテンツに誘導します。 クリックすると、デバイスのデフォルトの web ブラウザーが開き、指定した URL に移動するように求められます。

    • ディープリンク:ディープリンクは、アプリが閉じている場合でも、ユーザーをアプリ内の特定のセクションに誘導する URL です。 クリックすると、ダイアログが表示され、ユーザーはリンクを処理できる様々なアプリから選択できます。

    • オープンアプリ:オープンアプリの URL を使用すると、アプリケーション内のコンテンツに直接接続できます。 これにより、アプリケーションでは、曖昧さ回避ダイアログをバイパスして、特定のタイプのリンクのデフォルトハンドラーとして確立できます。

    Android アプリリンクの処理方法について詳しくは、Android 開発者向けドキュメントを参照してください。

  8. プッシュ通知をさらにカスタマイズするには、プッシュ通知の​ 通知オプション ​と HTTPv1 追加オプション​を設定します。 詳細情報

メッセージのコンテンツを定義したら、テストサブスクライバーを利用して、メッセージをプレビューしテストできます。

カルーセル
  1. 通知タイプ​ドロップダウンから、「カルーセル」を選択します。

  2. メッセージを作成するには、「タイトル」、「メッセージ」、「拡張されたメッセージ」の各フィールドにテキストを入力します。

    メッセージ​テキストは折りたたまれたビューに表示され、通知を拡張すると​ 拡張されたメッセージ ​が表示されます。

  3. 式エディターを使用して、コンテンツの定義、データのパーソナライズ、動的コンテンツの追加を行います。 詳細情報

  4. カラーオプション​メニューで、タイトル、メッセージ、背景​の 16 進数のカラーコードを入力します。

  5. カルーセル​の操作方法を選択します。

    • 自動:画像をスライドとして自動的に切り替えさせ、定義済みの間隔で移行します。
    • 手動:ユーザーはスライド間を手動でスワイプして画像間を移動できます。
  6. レイアウト​ドロップダウンから「フィルムストリップ」オプションを選択して、メインスライドの横に前と次の画像のプレビューを含めます。

  7. 「画像を追加」をクリックし、画像の URL、テキスト、アクションの URL を入力します。

    少なくとも 3 つの画像、最大 5 つの画像を含めます。

  8. プッシュ通知をさらにカスタマイズするには、プッシュ通知の​ 通知オプション ​と HTTPv1 追加オプション​を設定します。 詳細情報

メッセージのコンテンツを定義したら、テストサブスクライバーを利用して、メッセージをプレビューしテストできます。

アイコンボタン
  1. 通知タイプ​ドロップダウンから、「アイコンボタン」を選択します。

  2. カラーオプション​メニューで、背景​の 16 進数のカラーコードを入力します。

  3. キャンセルボタン画像​の URL を指定します。

  4. アイコン画像ボタン​で、「画像を追加」をクリックします。 次に、画像 URL、リンクタイプ、リンク URI を入力します。

    少なくとも 3 つの画像、最大 5 つの画像を含めます。

  5. プッシュ通知をさらにカスタマイズするには、プッシュ通知の​ 通知オプション ​と HTTPv1 追加オプション​を設定します。 詳細情報

メッセージのコンテンツを定義したら、テストサブスクライバーを利用して、メッセージをプレビューしテストできます。

入力ボックス
  1. 通知タイプ​ドロップダウンから、「入力ボックス」を選択します。

  2. メッセージを作成するには、「タイトル」、「メッセージ」、「拡張されたメッセージ」の各フィールドにテキストを入力します。

    メッセージ​テキストは折りたたまれたビューに表示され、通知を拡張すると​ 拡張されたメッセージ ​が表示されます。

  3. カラーオプション​メニューで、タイトル、メッセージ、背景​の 16 進数のカラーコードを入力します。

  4. 入力ボックスオプション​メニューで、次のオプションを入力します。

    • 入力受信者名:入力の受信者の名前または識別子を入力します。
    • 入力テキスト:入力ボックス​のテキストを入力します。
    • フィードバックテキスト:返信の後に表示するテキストを入力します。
    • フィードバック画像:返信の後に表示される画像の URL を追加します。

  5. プッシュ通知をさらにカスタマイズするには、プッシュ通知の​ 通知オプション ​と HTTPv1 追加オプション​を設定します。 詳細情報

メッセージのコンテンツを定義したら、テストサブスクライバーを利用して、メッセージをプレビューしテストできます。

製品カタログ
  1. 通知タイプ​ドロップダウンから、「製品カタログ」を選択します。

  2. メッセージを作成するには、「タイトル」、「メッセージ」、「拡張されたメッセージ」の各フィールドにテキストを入力します。

    メッセージ​テキストは折りたたまれたビューに表示され、通知を拡張すると​ 拡張されたメッセージ ​が表示されます。

  3. カラーオプション​メニューで、タイトル、メッセージ、背景​の 16 進数のカラーコードを入力します。

  4. 製品カタログオプション​メニューで、次のオプションを入力します。

    • アクションボタンのテキスト:ボタンに表示されるテキスト。
    • アクションボタンのテキストの色:アクションボタンのテキストの色。
    • アクションボタンの色:アクションボタンの色。
    • アクションボタン URI:ボタンクリック時に実行する URI を指定します。
    • 表示タイプ:垂直表示または水平表示を選択します。

  5. 製品カタログ項目​メニューで「追加」をクリックし、各項目に次の詳細を入力します。

    • タイトル
    • 説明
    • 画像 URL
    • 価格
    • URI

    必ず最大 3 つの項目を含めます。

  6. プッシュ通知をさらにカスタマイズするには、プッシュ通知の​ 通知オプション ​と HTTPv1 追加オプション​を設定します。 詳細情報

メッセージのコンテンツを定義したら、テストサブスクライバーを利用して、メッセージをプレビューしテストできます。

製品評価
  1. 通知タイプ​ドロップダウンから、「製品評価」を選択します。

  2. メッセージを作成するには、「タイトル」、「メッセージ」、「拡張されたメッセージ」の各フィールドにテキストを入力します。

    メッセージ​テキストは折りたたまれたビューに表示され、通知を拡張すると​ 拡張されたメッセージ ​が表示されます。

  3. カラーオプション​メニューで、タイトル、メッセージ、背景​の 16 進数のカラーコードを入力します。

  4. 製品評価オプション メニューで、選択されていない状態の評価アイコン​と​ 選択されている状態の評価アイコン ​の URL を入力します。

  5. 製品評価の項目​メニューで、「追加」をクリックし、リンク URI を入力して、リンクタイプ​を選択します。

    • Web URL:Web URL は、ユーザーをオンラインコンテンツに誘導します。 クリックすると、デバイスのデフォルトの web ブラウザーが開き、指定した URL に移動するように求められます。

    • ディープリンク:ディープリンクは、アプリが閉じている場合でも、ユーザーをアプリ内の特定のセクションに誘導する URL です。 クリックすると、ダイアログが表示され、ユーザーはリンクを処理できる様々なアプリから選択できます。

    • オープンアプリ:オープンアプリの URL を使用すると、アプリケーション内のコンテンツに直接接続できます。 これにより、アプリケーションでは、曖昧さ回避ダイアログをバイパスして、特定のタイプのリンクのデフォルトハンドラーとして確立できます。

    • 解除:ボタンに URL が関連付けられていません。クリックすると、ダイアログやインターフェイスが閉じるだけです。

    少なくとも 3 つの値、最大 5 つの値を含めます。

  6. プッシュ通知をさらにカスタマイズするには、プッシュ通知の​ 通知オプション ​と HTTPv1 追加オプション​を設定します。 詳細情報

メッセージのコンテンツを定義したら、テストサブスクライバーを利用して、メッセージをプレビューしテストできます。

タイマー
  1. 通知タイプ​ドロップダウンから、「タイマー」を選択します。

  2. メッセージを作成するには、「タイトル」、「メッセージ」、「拡張されたメッセージ」の各フィールドにテキストを入力します。

    メッセージ​テキストは折りたたまれたビューに表示され、通知を拡張すると​ 拡張されたメッセージ ​が表示されます。

  3. タイマーの有効期限が切れた後に表示されるテキストを「代替タイトル」、「代替メッセージ」、「拡張された代替メッセージ」の各フィールドに入力します。

  4. カラーオプション​メニューで、「タイトル」、「メッセージ」、「背景」、「タイマー」の 16 進数のカラーコードを入力します。

  5. タイマー期間​を秒単位で設定するか、タイマー終了タイムスタンプ​を特定のエポックタイムスタンプに設定し、タイマーの有効期限が切れた後に表示される​代替画像 URL を追加します。

  6. プッシュ通知をさらにカスタマイズするには、プッシュ通知の​ 通知オプション ​と HTTPv1 追加オプション​を設定します。 詳細情報

メッセージのコンテンツを定義したら、テストサブスクライバーを利用して、メッセージをプレビューしテストできます。

ゼロベゼル
  1. 通知タイプ​ドロップダウンから、「ゼロベゼル」を選択します。

  2. メッセージを作成するには、「タイトル」、「メッセージ」、「拡張されたメッセージ」の各フィールドにテキストを入力します。

    メッセージ​テキストは折りたたまれたビューに表示され、通知を拡張すると​ 拡張されたメッセージ ​が表示されます。

  3. カラーオプション​メニューで、タイトル、メッセージ、背景​の 16 進数のカラーコードを入力します。

  4. ゼロベゼルオプション​メニューで、「折りたたまれた通知スタイル」フィールドに画像 URL を追加します。

  5. プッシュ通知をさらにカスタマイズするには、プッシュ通知の​ 通知オプション ​と HTTPv1 追加オプション​を設定します。 詳細情報

メッセージのコンテンツを定義したら、テストサブスクライバーを利用して、メッセージをプレビューしテストできます。

プッシュ通知の詳細設定 push-advanced

通知オプション notification-options

パラメーター
説明
チャネル ID
通知のチャネル ID を設定します。 このチャネル ID を持つ通知を受信するには、このチャネル ID を持つチャネルをアプリで事前に作成しておく必要があります。
アイコン
プロファイルのデバイスに表示される通知のアイコンを設定します。
サウンド
デバイスが通知を受け取るときに再生するサウンドを設定します。
タグ
通知ドロワー内の既存の通知を置き換えるために使用する識別子を設定します。 これにより、複数の通知が蓄積されるのを防ぎ、関連する最新通知のみが表示されるようにします。
カラー
通知のアイコンのカラーを 16 進数のカラーコードで設定します。
クリックアクション
通知のユーザークリックに関連付けられたアクションを設定します。
通知の背景色
通知の背景色を 16 進数のカラーコードで設定します。
リンクタイプ
  • Web URL:Web URL は、ユーザーをオンラインコンテンツに誘導します。 クリックすると、デバイスのデフォルトの web ブラウザーが開き、指定した URL に移動するように求められます。
  • ディープリンク:ディープリンクは、アプリが閉じている場合でも、ユーザーをアプリ内の特定のセクションに誘導する URL です。 クリックすると、ダイアログが表示され、ユーザーはリンクを処理できる様々なアプリから選択できます。
  • オープンアプリ:オープンアプリ URL を使用すると、アプリケーション内のコンテンツに直接接続できます。 これにより、アプリケーションでは、曖昧さ回避ダイアログをバイパスして、特定のタイプのリンクのデフォルトハンドラーとして確立できます。

HTTPv1 その他のオプション additional-options

パラメーター
説明
ティッカー
通知のティッカーテキストを設定します。 Android 5.0 Lollipop に設定されたデバイスでのみ使用できます。
スティッキー
有効にした場合、ユーザーがクリックした後も通知は表示されたままになります。
無効にした場合、ユーザーが操作すると通知は自動的に閉じられます。 スティッキー動作を使用すると、重要な通知を長期間画面に保持できます。
画像
通知に表示する画像の URL を設定します。
通知優先度
通知の優先度レベル(デフォルト、最小、低、高)を設定します。 優先度レベルは通知の重要度と緊急性を決定し、通知の表示方法と、特定のシステム設定をバイパスできるかどうかに影響します。 詳しくは、FCM のドキュメントを参照してください。
通知数
アプリケーションアイコンに直接表示する新しい未読情報の数を設定します。 これにより、ユーザーは保留中の通知数をすばやく確認できます。
可視性
通知の表示レベルを(パブリック、プライベート、秘密)のいずれかに設定します。 表示レベルは、通知の内容をロック画面やその他の機密領域にどの程度表示するかを決定します。 詳しくは、FCM ドキュメントを参照してください。
アプリケーション変数
通知動作を定義できます。 これらの変数は完全にカスタマイズ可能で、モバイルデバイスに送信されるメッセージペイロードの一部に含まれます。
recommendation-more-help
campaign-help-v8