米国の請求レポート

このページでは、RCS for Businessが米国の通信事業者による米国RBMフレームワークに基づく請求および監査を支援するために作成するデータファイルについて説明します。米国RBMフレームワークの詳細については、 usrbm.orgもご参照ください。

請求レポートとは、起動したエージェントとユーザー間の課金対象イベントを集計したレポートです。課金対象とは、イベントが課金対象となることを意味します。課金対象イベントに課金するかどうか、また課金方法を決定するのは通信事業者です。RCS for Businessを積極的に運用している米国のすべての通信事業者は、請求レポートにアクセスできます。

注：標準請求モデルの詳細および請求モデルの違いの概要については、標準請求に関するFAQを参照してください。

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

ファイル生成

詳細については、 「ファイル生成」を参照してください。

ファイルの保存とアクセス

詳細については、 「ファイルの保存とアクセス」を参照してください。

ファイルの入手可能性

詳細については、 「ファイルの入手可能性」を参照してください。

請求レポート

請求レポートは、エージェントの請求カテゴリと送信メッセージの種類に基づいて計算される、請求対象となるイベントの記録です。請求レポートは、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（モバイル発信）とは、ユーザーによって開始されたメッセージまたはアクションのことです。

課金対象イベント

メッセージの流れは、発信元と方向によって分類されます。メッセージトラフィックの方向を説明するために、米国の通信事業者は通常、MT/MOという用語を使用します。これらの用語は、RCS for Businessのドキュメント全体で使用されているA2P/P2Aという用語に対応しています。これらの用語がどのように対応しているかを簡単に説明します。

• A2P（アプリケーションから個人への通信）はMT（モバイル終端）です。これは、企業から送信されるメッセージです。
• 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時間以内のすべてのメッセージは単一のセッション料金で処理されます。24時間セッション内の課金対象イベントはすべて、そのセッションの課金対象イベントIDに割り当てられます。
p2a_session	セッションのトリガーが開始され、最初のメッセージがMO（Make Out）になった時点から始まる24時間のインタラクション期間。詳細については、 「セッションとは何か、そしてその仕組み」を参照してください。	該当なし。セッションは非対話型エージェントには適用されません。	一度トリガーされると、24時間以内のすべてのメッセージは単一のセッション料金で処理されます。24時間セッション内の課金対象イベントはすべて、そのセッションの課金対象イベントIDに割り当てられます。

請求レポートの生成

テスター以外のトラフィックを持つエージェントのみが課金対象となるイベントを生成します。テスト用電話番号からのアクティビティは請求レポートには表示されません。

これらのレポートでは、A2Pメッセージが配信された時点で課金対象となるイベントが発生すると想定しており、メッセージが送信された時点では課金対象とはなりません。配信されなかったメッセージ、または配信前にキャンセルされたメッセージは、課金対象となるイベントを発生させません。

請求書レポートのフォーマット

請求レポートのファイル名は、 rbm_billable_events_YYYY-MM-DD.csvという形式です。ファイル名に含まれる日付は、ファイルの生成日です。

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

レポート内の各レコードには、請求対象となる各イベントに関する以下の情報が含まれています。

分野	形式	説明	例
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年5月20日午前8時00分（UTC）
duration	番号	期間はセッションのみに適用され、単位は分です。イベントがセッション以外のイベントの場合、値は0になります。	45
mt_messages	番号	イベントにおけるモバイル端末経由（A2P）メッセージの数。セッションの場合、同じbilling_event_idを共有する各行は、セッション全体の MT メッセージの総数を示します。	5
mo_messages	番号	イベントにおけるモバイル発信（P2A）メッセージの数。セッションの場合、同じbilling_event_idを共有する各行は、セッション全体のモバイル発信メッセージの総数を示します。	3
size_kilobytes	番号	イベント内のメッセージに添付されたすべてのファイルのサイズを、最も近いキロバイトに四捨五入した値（1kBは1024バイトに相当）。	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のアクティブなパートナーからの日次レポートのサイズは、そのパートナーが通信事業者のネットワーク上でどれだけの活動を行ったかによって異なります。