米国の請求レポート

このページでは、米国の通信事業者が米国の 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 時間のウィンドウ内のすべてのメッセージが1 つのセッション として請求されます。セッションをトリガーしないメッセージや、セッションの範囲外のメッセージは、個々の通信事業者の料金表に基づいて、リッチ メッセージまたはリッチメディア メッセージの標準のメッセージ単位の料金 で請求されます。

次の図は、会話型エージェントの 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 を使用します。 ファイル名の date は、ファイルの生成日です。

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

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

フィールド	形式	説明	例
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	文字列	イベントに参加したエージェントの一意の識別子。	[e-mail]
agent_owner	文字列	エージェントが作成されたパートナー アカウントの現在のオーナーのメールアドレス。	[e-mail]
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 パートナーからの日次レポートのサイズは、通信事業者のネットワークで生成されたアクティビティの量によって異なります。