米国の請求レポート

このページでは、米国の RBM フレームワークに基づく請求と監査を米国の携帯通信会社が実施するうえで役立つよう、RCS for Business が作成するデータファイルについて説明します。米国の RBM フレームワークについて詳しくは、usrbm.org をご覧ください。

請求レポートは、起動されたエージェントとユーザー間の課金対象イベントを集計したレポートです。課金対象とは、イベントが課金の対象であることを意味します。課金対象イベントが課金されるかどうか、またどのように課金されるかは、携帯通信会社によって決まります。RCS for Business を積極的に運用している米国のすべての携帯通信会社は、請求レポートにアクセスできます。

米国の課金分類モデルの詳細については、米国の課金に関するよくある質問を参照してください。

ファイル生成

詳細については、ファイル生成をご覧ください。

ファイル ストレージとアクセス

詳細については、ファイル ストレージとアクセスをご覧ください。

ファイルの可用性

詳細については、ファイルの可用性をご覧ください。

お支払いとご請求に関するレポート

請求レポートは、課金対象イベントの記録です。課金対象イベントは、エージェントの課金カテゴリと送信するメッセージのタイプに基づいて計算されます。請求レポートは、RCS for Business を積極的に運用しているすべての携帯通信会社で利用できます。

請求レポートには機密情報が含まれますが、MSISDN、ハッシュ化された MSISDN、ユーザー固有の識別子などのユーザーの個人情報（PII）は含まれません。

請求カテゴリと課金対象イベント

エージェントの請求対象を理解するには、エージェントの請求カテゴリと請求対象イベントの違いを理解することが重要です。

  • 請求カテゴリは、エージェントの作成時に選択する固定の分類です。エージェントの課金方法（メッセージ単位（非会話型エージェント）またはセッション単位（会話エージェント））を決定します。
  • 請求可能なイベントは、請求目的で追跡される RCS for Business エージェントとユーザー間のやり取りです（rich_message など）。

米国のエージェントの請求カテゴリ

エージェントを作成するときに、オーナーはエージェントがユーザーとどのようにやり取りするかに基づいて課金カテゴリを設定します。請求カテゴリは、エージェントが送信できるメッセージの数や種類を制限しません。ただし、エージェントがメッセージに対してどのように課金されるかは決定します。次の表に、2 つの主な課金カテゴリを示します。

請求カテゴリ エージェント タイプ サンプル ユースケース 請求方法
会話型ではない 主に一方向のメッセージを送信するエージェント。
  • OTP
  • アラート
  • プロモーションの特典
 ユーザーに配信されたメッセージごとに課金されます。
会話型 会話の開始者に関係なく、ユーザーとのやり取りを想定して設計されたエージェント。
  • 適切な製品を見つける
  • チケットの予約
  • 問題のトラブルシューティング
 セッション単位の課金: セッションの条件を満たしている場合、24 時間のセッション ウィンドウ内のすべてのリッチ メッセージとリッチメディア メッセージは、長さやセグメントに関係なく、フラットレートで課金されます。

メッセージ単位の課金: セッションの条件を満たしていない場合や、メッセージが 24 時間のセッション ウィンドウ外にある場合は、個々の携帯通信会社の料金表に従って、リッチ メッセージまたはリッチメディア メッセージのメッセージ単位の料金で個別に課金されます。

会話エージェントと非会話型エージェント

エージェントの請求カテゴリには、会話型と非会話型の 2 つがあります。

  • 会話型ではないエージェントは、ユーザーに配信するメッセージごとに課金されます。

    • このカテゴリは、頻繁な返信を想定していないエージェントに最適です。

  • 会話型エージェントは、セッションがトリガーされた場合にセッションごとにフラットレートで請求されます。セッションがトリガーされると、セッションをトリガーしたメッセージを含め、24 時間以内に交換されたすべてのメッセージが対象となります。会話エージェントでは、24 時間セッションに含まれないメッセージに対して料金が発生する場合があります。

    • このカテゴリは、ユーザーと複数のターンからなる会話を行うエージェントに最適です。

セッションの課金ロジック

米国の課金モデルでは、トリガー シーケンスの最初のメッセージから 24 時間以内に交換された 4 つのリッチ メディア メッセージ（少なくとも 2 つの MO メッセージと少なくとも 1 つの MT メッセージを含む）のシーケンスによってセッションがトリガーされます。このしきい値に達すると、その 24 時間のウィンドウ内のすべてのメッセージが単一セッションとして課金されます。セッションの範囲外にあるメッセージやセッションをトリガーできなかったメッセージは、個々の携帯通信会社の料金表に従って、リッチ メディアまたはリッチ メディアの標準のメッセージあたりの料金で課金されます。

次の図は、会話エージェントの A2P 課金セッションの例を示しています。

  • MT（Mobile Terminated）は、ビジネスから送信されるメッセージです。
  • MO（Mobile Originated）は、ユーザーが開始したメッセージまたはアクションです。

米国の請求 - セッション

請求対象イベント数

メッセージ フローは、送信元と方向によって分類されます。メッセージ トラフィックの方向を説明するために、米国の携帯通信会社は通常 MT/MO という用語を使用します。これらの用語は、RCS for Business のドキュメント全体で使用されている A2P/P2A の用語に対応しています。これらの用語の対応関係は次のとおりです。

  • A2P（Application-to-Person）は MT（Mobile Terminated）: 企業が送信するメッセージ。
  • P2A（Person-to-Application）は MO（Mobile Originated）: ユーザーが開始したメッセージまたはアクション。
イベント 説明 非会話エージェント 会話エージェント
a2p_rich_message エージェントが送信したメッセージで、テキスト、返信の候補、または特定の操作候補（電話番号をダイヤル、ブラウザで URL を開く）のみが含まれているもの。 常に個別の課金対象イベントとして扱われます。

セグメントに基づくメッセージ単位の課金（1 セグメントは 160 UTF-8 バイトに相当）。

 セッションの一部にならない限り、個別の課金対象イベントとして扱われます。
p2a_rich_message 自由形式のテキストのみ、または返信の候補をタップして入力したテキストのみを含む、ユーザーが送信したメッセージ。 常に個別の課金対象イベントとして扱われます。

セグメントに基づいてメッセージごとに課金されます。

 セッションの一部にならない限り、個別の課金対象イベントとして扱われます。
a2p_rich_media_message メディア（画像、動画、音声）、リッチカード、カルーセル、または「場所を表示」などの複雑なアクションを含むエージェント送信メッセージ。 常に個別の課金対象イベントとして扱われます。

サイズやコンテンツに関係なく、単一の定額イベントとして課金されます。

 セッションの一部にならない限り、個別の課金対象イベントとして扱われます。
p2a_rich_media_message アップロードされたメディア ファイル（画像、動画、音声）を含むユーザー送信メッセージ。 常に個別の課金対象イベントとして扱われます。

単一の定額料金イベントとして課金されます。

 セッションの一部にならない限り、個別の課金対象イベントとして扱われます。
p2a_suggested_action ユーザーが、返信の候補ではない提案されたアクション（「場所を表示」など）をタップした場合。 常に個別の課金対象イベントとして扱われます。

クリックごとに 1 つの課金対象イベントを生成します。

 個別の課金対象イベントとして扱われ、セッションの一部にならない限り、クリックごとに 1 つの課金対象イベントが生成されます。
a2p_session セッション トリガーが開始され、最初のメッセージが MT の場合に開始される 24 時間のやり取り期間。詳しくは、セッションとは、その仕組みをご覧ください。 なし。セッションは会話エージェント以外のエージェントには適用されません。 トリガーされると、24 時間のウィンドウ内のすべてのメッセージが 1 回のセッション料金でカバーされます。24 時間のセッション内の課金対象イベントは、セッションの課金対象イベント ID に割り当てられます。
p2a_session セッション トリガーが開始され、最初のメッセージが MO の場合に開始される 24 時間のインタラクション ウィンドウ。詳しくは、セッションとは、その仕組みをご覧ください。 なし。セッションは会話エージェント以外のエージェントには適用されません。 トリガーされると、24 時間のウィンドウ内のすべてのメッセージが 1 回のセッション料金でカバーされます。24 時間のセッション内の課金対象イベントは、セッションの課金対象イベント ID に割り当てられます。

請求レポートの生成

テストユーザー以外のトラフィックのみが請求対象イベントを生成します。テスト用の電話番号からのアクティビティは、請求レポートに表示されません。

これらのレポートは、メッセージが送信されたときではなく、A2P メッセージが配信されたときにイベントが課金対象になることを前提としています。配信されなかったメッセージや、配信前にキャンセルされたメッセージは、課金対象のイベントをトリガーしません。

請求レポートの形式

請求レポートのファイル名の形式は rbm_billable_events_YYYY-MM-DD.csv です。ファイル名の日は、ファイル生成日です。

レポートの各行は、1 つの課金対象イベントを表すレコードです。A2P/P2A セッションは、複数の行で表されます。交換されたメッセージごとに 1 行です。セッションに関連付けられたすべての行（同じ billing_event_id を共有）は、mt_messages 列と mo_messages 列で、24 時間のセッション ウィンドウ全体の MT メッセージと MO メッセージの合計数を報告します。

ファイルはバイト オーダー マークなしで UTF-8 エンコードされ、行末にはラインフィードが使用されます。各ファイルの 1 行目は、フィールド名を含むヘッダー行です。

レポートの各レコードには、課金対象イベントごとに次の情報が含まれています。

フィールド 形式 説明 例
billing_event_id 文字列 課金対象イベントを区別する生成された ID。

セッションの一部であるすべてのメッセージには、同じ billing_event_id が含まれます。

 63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e
type 文字列 イベントの種類:
  • a2p_rich_message
  • a2p_rich_media_message
  • p2a_rich_message
  • p2a_rich_media_message
  • p2a_suggested_action
    		•  p2a_rich_message
    agent_id 文字列 イベントに参加したエージェントの固有識別子。 acme_342h23_agent@rbm.goog
    agent_owner 文字列 エージェントが作成されたパートナー アカウントの現在の所有者のメールアドレス。 marketing@xyzaggregator.com
    billing_party 文字列 イベントの請求を行う当事者。 携帯通信会社
    max_duration_single_message 数値 会話開始ウィンドウが閉じ、メッセージが single_message イベントとして分類される前に、ユーザーがエージェントのメッセージに返信できる最大時間（時間単位）。個々のリッチ メッセージの米国モデルには適用されません。 24
    max_duration_a2p_conversation 数値 セッションのパイロット版では、トリガー シーケンスの最初のメッセージから測定された 24 時間のセッション ウィンドウが反映されます。期間は時間単位で測定されます。 24
    max_duration_p2a_conversation 数値 セッションのパイロット版では、トリガー シーケンスの最初のメッセージから測定された 24 時間のセッション ウィンドウが反映されます。 24
    start_time YYYY-mm-ddTHH:00:00Z

    イベントが開始された UTC の日時（ISO 8601）。セッションの場合、これはトリガー シーケンスの最初のメッセージのタイムスタンプです。

    A2P

  • a2p_rich_message や a2p_rich_media_message などのセッション以外のイベントの場合、これはメッセージがユーザーに配信された時刻です。
  • a2p_session イベントの場合、これは会話の最初のメッセージがユーザーに配信された時間です。

    • P2A

  • p2a_rich_message や p2a_rich_media_message などのセッション以外のイベントの場合、これはユーザーがメッセージを送信した時刻です。
  • p2a_session イベントの場合、これは会話の最初のメッセージがユーザーによって送信された時間です。
    		•  2025-05-20T08:00:00Z
    duration 数値 継続時間はセッションにのみ適用され、分単位で測定されます。イベントがセッション以外のイベントの場合、値は 0 です。 45
    mt_messages 数値 イベント内のモバイル宛（A2P）メッセージの数。セッションの場合、同じ billing_event_id を共有する各行には、セッション全体の MT メッセージの合計数が表示されます。 5
    mo_messages 数値 イベント内のモバイル発信（P2A）メッセージの数。セッションの場合、同じ billing_event_id を共有する各行には、セッション全体の MO メッセージの合計数が表示されます。 3
    size_kilobytes 数値 イベント内のメッセージに添付されたすべてのファイルのサイズ。最も近いキロバイトに丸められます（1 KB は 1, 024 バイトに相当します）。 912
    agent_name 文字列 イベントに参加したエージェントの名前。 ACME Brand
    owner_name 文字列 エージェントが作成されたパートナー アカウントの現在の所有者の名前。 XYZ Aggregator
    segment_count 数値 a2p_rich_message events イベントと p2a_rich_message イベントの計算されたセグメント数（1 セグメントは 160 UTF-8 バイトに相当します）。イベントが上記に該当しない場合、値は 0 になります。 5
    session_type 文字列 セッションのタイプ:
  • a2p_session
  • p2a_session
    • アクティビティがセッションとして認められない場合は空になります。    		 a2p_session

    請求レポートのサンプル

    サンプル レポートをダウンロードできます。

    一般的なファイルサイズ

    アクティブな RCS for Business パートナーからの日次レポートのサイズは、携帯通信会社のネットワークで生成されたアクティビティの量によって異なります。