RCSリッチカードとカルーセル

リッチカードは、メディア、テキスト、提案を組み合わせて、より魅力的でインタラクティブなメッセージング体験を実現します。重要な情報を強調し、明確なアクションを提供し、プレーンテキストだけよりも直感的にユーザーを会話に導くために使用できます。

カルーセルはこのコンセプトを拡張し、1つのメッセージで複数のリッチカードを提示できるようにすることで、ユーザーがさまざまな選択肢を探したり比較したりできるようにします。

リッチ・カードには以下のようなものがある:

  • メディア - 画像、GIF、ビデオ、PDFファイル
  • タイトルテキスト - 見出しやキーメッセージ
  • 説明文 - 裏付けとなる情報や背景
  • 返信とアクションの提案 - ユーザーのためのインタラクティブなオプション

リッチカードでのPDFファイル送信は、現在インドでのみGoogleメッセージクライアントでサポートされています。

最初の3つの要素(メディア、タイトル、説明文)のうち少なくとも1つは必須。

ペイロードの構成

リッチカードやカルーセルは、 Messages API.使用する message_type の card スタンドアロンのリッチカード用および carousel 多彩なカードのコレクションのために。

スタンドアロンのリッチカード

スタンドアロンのリッチカードでは、 card カードの内容用のオブジェクトと、 rcs そのレイアウト用のオブジェクト:

{
  "to": "447700900000",
  "from": "Vonage",
  "channel": "rcs",
  "message_type": "card",
  "card": {
    "title": "Hello, world!",
    "text": "This is some text to display on the card.",
    "media_url": "https://example.com/image.jpg",
    "media_description": "Image description for accessibility purposes.",
    "media_height": "TALL",
    "thumbnail_url": "https://example.com/thumbnail.jpg",
    "media_force_refresh": false,
    "suggestions": [
      {
        "type": "reply",
        "text": "Suggestion #1",
        "postback_data": "suggestion_1"
      }
    ]
  },
  "rcs": {
    "card_orientation": "VERTICAL",
    "image_alignment": "RIGHT"
  }
}

について card オブジェクトには、以下のプロパティを含めることができます:

  • title: カードのタイトル。
  • text: カードの説明。
  • media_url: 画像、動画、またはPDFファイルのURL。
  • media_description: メディアに関するアクセシビリティの説明。
  • media_height: メディアの高さ: SHORT, MEDIUMあるいは TALL.
  • thumbnail_url: メディアのサムネイルのURL。
  • media_force_refresh: メディアの更新を強制するかどうか。
  • suggestions: 推奨される返信や対応のリスト。

横向きのカードの場合は、次のように設定します。 card_orientation への HORIZONTAL そして設定する image_alignment への LEFT または RIGHT.

リッチカード・カルーセル

カルーセルは、 carousel.cards 2枚から10枚のリッチカードを含む配列。各カードは、単体のリッチカードと同じプロパティを使用します。設定 card_width での rcs 対象 SMALL または MEDIUM:

{
  "to": "447700900000",
  "from": "Vonage",
  "channel": "rcs",
  "message_type": "carousel",
  "carousel": {
    "cards": [
      {
        "title": "Card 1",
        "text": "Description for card 1",
        "media_url": "https://example.com/image1.jpg",
        "media_height": "TALL"
      },
      {
        "title": "Card 2",
        "text": "Description for card 2",
        "media_url": "https://example.com/image2.jpg",
        "media_height": "TALL"
      }
    ]
  },
  "rcs": {
    "card_width": "MEDIUM"
  }
}
Navigation pane.

リッチカードの構成要素

メディア

リッチカードは複数のメディアフォーマットをサポートしているので、コンテンツを最も効果的に見せることができます:

  • 画像JPEG/JPEG、GIF、PNG
  • ビデオH.263、M4V、MP4、MPEG、MPEG-4、WebM
  • ドキュメントPDF (Googleメッセージクライアントのインドのみ)

標準的なメディアの高さは3種類から1つを選ぶことができる:

メディアの高さ サイズ
ショート 112 DP
ミディアム 168 DP
背が高い 264 DP

DP(密度非依存ピクセル) これにより、異なるスクリーン密度でも一貫してメディアが表示されます。

メディアが選択した高さに合わない場合は、システムが自動的にトリミングとズームを行って中央に配置します。メディアの表示方法をコントロールするには、カスタムサムネイルを指定します。

Navigation pane.

PDFの動作:

  • プレビューはファイルの最初のページから生成されます。
  • プレビューが利用できない場合は、サムネイルまたはデフォルトのアイコンが表示されます。
  • 画像をタップすると、ファイルがビューアで開きます。

メディアはURLで提供するか、直接アップロードすることができます。

Navigation pane.

サムネイル

サムネイルはメディアのプレビュー画像として機能し、ファイルのダウンロード中に表示されます。

  • サムネイルの最大サイズ:100kB(推奨:50kB以下)
  • サムネイルが提供されない場合、デフォルトのアイコンが表示されます。
  • サムネイルはビデオのプレビューとしても使用される。

サムネイルまたはアイコンをタップすると、フルスクリーン表示でメディアが開きます。

Navigation pane.

タイトル

タイトルは、ユーザーの注意を引くようにデザインされた簡潔な見出しです。

  • 最大文字数:200文字
  • 絵文字やマルチバイト文字などの特殊文字は、複数文字としてカウントされます。

説明

説明文は、裏付けとなる情報や行動への呼びかけを提供する。

  • 最大文字数:2000文字

推奨される返答と行動

リッチ・カードには最大で

  • カードの中に4つの返答や行動を提案
  • カード下に11個の追加提案チップ

提案チップは、会話を前進させる新しい方法を提供すべきであり、カードやカルーセル内の選択肢と重複してはならない。

Navigation pane.

返信の提案

サジェストされた返信は、あらかじめ定義された短いメッセージ(最大25文字)で、ユーザーは素早く返信することができます。会話を効率化し、ユーザーを関連性のあるやり取りへと導きます。

推奨されるアクション

推奨されるアクションは、例えば、電話番号に電話をかける、マップを開く、ブラウザを起動するなど、デバイスのネイティブ機能にリンクしています。ユーザーを圧倒しないよう、関連するアクションのみを含める。

リッチカードのレイアウト・オプション

リッチカードは縦にも横にもフォーマットできる:

縦型レイアウト

  • メディアはトップに表示される。
  • 最小カード高さ:112DP。
  • 対応メディアの高さ:112 DP(ショート)、168 DP(ミディアム)、264 DP(トール)。
  • 対応アスペクト比:2:1、16:9、7:3。
Navigation pane.

水平レイアウト

  • メディアはテキストの左または右に配置される。
  • 固定メディア幅:128DP。
  • テキスト内容に合わせて高さを調整。
Navigation pane.

リッチカード・カルーセル

カルーセルとは、1つのメッセージの中にあるスクロール可能な一連のリッチカードのことです。カルーセルは、プラン、商品、場所など、関連する複数の選択肢を提示し、ユーザーが閲覧したり比較したりできるようにする場合に最適です。

  • カルーセルの最大カード枚数:10
  • カルーセルでは、縦長のリッチカードのみがサポートされています。

最初のカードは、最良の、あるいは推奨される選択肢を強調する。

提案チップはカルーセルの下に配置することもできるが、カルーセルの内容を繰り返さないこと。

Navigation pane.

カルーセル仕様

仕様 詳細
タイトル 最大文字数200文字
説明 最大文字数2000文字
高さ スモール:最大542DP ミディアム:最大592DP
幅 スモール:180DP(固定) ミディアム:296DP(固定)

すべてのカードは、最も背の高いカードの高さに合わせて拡大縮小されます。コンテンツがこの高さを超える場合、システムは以下の順序でテキストを切り捨てます:

  1. 説明→シングルライン
  2. タイトル → 1行
  3. 提案 → 削除
  4. 説明→削除
  5. タイトル → 削除

カルーセルのフルスクリーンビュー

カードの内容が切り捨てられた場合、ユーザーはカードを全画面表示に展開して全文を見ることができる。

どのように機能するのか:

  • コンテンツが切れると「もっと見る」ボタンが表示される。
  • カードまたはMoreボタンをタップするとフルスクリーンモードが開きます。
  • ユーザーはXをタップするか、システムに戻るジェスチャーを使うか、提案を選択することで終了できる。

フルスクリーンでのナビゲーション:

  • 長いテキストはカード内で縦スクロール。
  • 横スワイプでカード間を移動。

フルスクリーンのメディア仕様:

仕様 詳細
メディアの高さ 264 DP(トール)
メディア幅 スクリーン幅 - 32 DP(左右に16 DPのマージン)

フルスクリーン表示でのサジェスチョンの動作

提案タイプ 行動
URLを開く ブラウザまたはウェブビューで開きます。メッセージに戻ると全画面表示に戻ります。
ダイヤル / 場所を表示 / カレンダー・イベント 関連アプリを開きます。戻るとフルスクリーン表示に戻ります。
シェア・ロケーション フルスクリーンビューが閉じ、グーグルマップが開き、送信後に会話ビューが戻る。
返信推奨 フルスクリーン表示が閉じ、チャットで返信が送信される。

文字とサイズの制限

  • タイトル:200文字以内
  • 説明文:2000文字まで
  • メディアの高さ112 DP(ショート)、168 DP(ミディアム)、264 DP(トール)
  • ペイロードサイズ:最大250KB

すべてのコンテンツが正しく表示されるように、リッチカードやカルーセルがこれらの制限内に収まっていることを確認してください。

詳細情報