このページでは、RCS for Businessが通信事業者の請求および監査を支援するために作成するデータファイルについて説明します。
| ファイル | 説明 | 誰がアクセスできるのか |
|---|---|---|
| 請求レポート | 起動したエージェントとユーザー間の課金対象イベントを集計したレポート。 | RCS for Businessを積極的に運用しているすべての通信事業者。 |
| アクティビティログ | 課金対象となるイベントを含む、RCS for Businessのアクティビティの生データログ。 | RCS for Businessを積極的に運用しており、独自の利用規約（ToS）に基づいてGoogle RCSサービスを運用している通信事業者。 |
RCS for Businessは、米国以外のトラフィックに対して標準的な課金モデルを採用しています。詳細は、課金に関するFAQをご覧ください。
ファイル生成
各データファイルは、太平洋標準時（PST）におけるRCS for Businessの1日分の利用状況を表します。ファイルは毎日生成され、直前の24時間（午前0時から午前0時まで）のアクティビティを反映します。生成処理には数時間かかる場合があり、完了時間は変動する可能性があります。
- 非対話型エージェントの場合、ファイルにはファイル生成日の直前24時間分のデータが含まれます。例えば、5月5日に生成されたレポートは、5月4日午前0時から5月5日午前0時までのデータを対象としています。指定されている時刻は太平洋標準時（PST）です。
対話型エージェントの場合、ファイルにはファイル生成時刻の1～2日前の24時間分のデータが含まれます。例えば、5月5日に生成されたレポートは、5月2日または5月3日の24時間分のデータを対象としています。指定される時刻は太平洋標準時（PST）です。
遅延が発生する理由は、会話型エージェントのRCS for Businessアクティビティがセッションに紐づいており、セッションの完了には最大24時間かかるためです。この遅延により、RCS for Businessは課金対象イベントを計算する前に、会話内のすべてのメッセージをキャプチャすることができます。会話型エージェントの詳細については、 「エージェントの課金カテゴリ」を参照してください。
要点：
- アクティビティなし：デフォルトでは、特定の日にプラットフォームのアクティビティがない場合、ファイルは生成されません。ただし、必要に応じて空のファイルを受信するように設定できます。設定するには、rbm-support@google.comまでお問い合わせください。
- 命名規則：ファイル名に含まれる日付は、ファイルの生成日であり、ファイル内のデータの日付ではありません。
- 保存期間：ファイルは最大63日間保存された後、削除されます。
これらのファイルを使用すると、最新のプラットフォーム使用状況指標でデータウェアハウスを更新できます。
ファイルの保存とアクセス
データファイルは保存時および転送時に暗号化されます。
SFTP（Secure File Transfer Protocol）を使用してデータファイルを取得するには、SFTP公開鍵を指定してください。鍵の生成方法については、 「SFTPドロップボックス用のSecure Shell（SSH）鍵ペアの生成」を参照してください。
SFTPサーバーはpartnerupload.google.comで、セキュリティ強化のため高ポート番号（19321）で接続します。
以下のコマンドを使用してデータファイルにアクセスできます。
sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com
Googleはアカウントのユーザー名を以下の形式で提供しています。
-
rbmreports-billableevents-<carrier name> -
rbmreports-activity-<carrier name>
Googleは<carrier name>を指定し、レポートの種類ごとに個別のアカウントを提供します。
各種レポートにアクセスするには、それぞれ別のアカウントが必要です。
ファイルの入手可能性
データファイルがまだ生成されていない場合は、 remote readdir("/"): No such file or directoryのような SFTP エラーが表示されますが、これは想定される動作です。
RCS for Businessのトラフィックが報告対象とならない場合、ファイルは生成されません。つまり、ファイルが生成されない日があるかもしれません。プロセスを効率化するために空のファイルが必要な場合は、 RCS for Businessサポートチームにお問い合わせください。
請求レポート
請求レポートは、エージェントの請求カテゴリと送信メッセージの種類に基づいて計算される、請求対象となるイベントの記録です。請求レポートは、RCS for Businessを積極的に運用しているすべての通信事業者が利用できます。
請求レポートには機密情報が含まれますが、MSISDN、ハッシュ化されたMSISDN、またはユーザー固有の識別子などのユーザーの個人識別情報（PII）は含まれません。
エージェントの請求カテゴリ
エージェントを作成する際、所有者はエージェントがユーザーとどのようにやり取りするかに基づいて課金カテゴリを設定します。課金カテゴリは、エージェントが送信できるメッセージの数や種類を制限するものではありませんが、メッセージに対する課金方法を決定します。主な2つの課金カテゴリについては、次の表で説明します。
| 請求カテゴリ | エージェントの種類 | 使用例 | 請求方法 |
|---|---|---|---|
| 非会話的 | 主に一方通行のメッセージを送信するエージェント。 |
| ユーザーに配信されたメッセージごとに課金されます。 |
| 会話的 | ユーザーとの双方向のやり取りを目的として設計されたエージェント。 |
| 会話ごとの課金：エージェントまたはユーザーが相手からのメッセージに24時間以内に返信すると、会話が開始されます。会話期間（最初の返信から24時間）中は、エージェントとユーザーはメッセージを何度でもやり取りでき、エージェントには会話ごとに固定料金が課金されます。 メッセージごとの課金：エージェントが送信したメッセージに対してユーザーが24時間以内に返信しなかった場合、非対話型エージェントと同様に、エージェントはメッセージごとに課金されます。 |
次の図は、対話型エージェントのA2P課金セッションの例を示しています。
対話型エージェントと非対話型エージェント
料金体系は大きく分けて、会話型と非会話型の2種類があります。
課金区分における主な違いは、対話型エージェントと非対話型エージェントの違いです。
非対話型エージェントは、ユーザーに配信したメッセージごとに料金が発生します。
- このカテゴリーは、頻繁な返信を期待しないエージェントに最適です。
対話型エージェントには、24時間以内にやり取りされたすべてのメッセージを含む会話に対して、定額料金が請求されます。
- このカテゴリは、ユーザーと複数回のやり取りを行うエージェントに最適です。
課金対象イベント
請求レポートには、5種類の請求対象イベントが記録されます。これらのイベントには、MTイベントとMOイベントが含まれ、これらはA2PイベントとP2Aイベントと呼ばれます。
- A2P（アプリケーションから個人への通信）はMT（モバイル終端）です。これは、企業から送信されるメッセージです。
- P2A（Person-to-Application）はMO（Mobile Originated）です。これは、ユーザーによって開始されたメッセージまたはアクションです。
以下の表は、非対話型エージェントと対話型エージェントに適用される、課金対象となる各イベントについて説明しています。
| イベント | 説明 | 非対話型エージェント | 対話型エージェント |
|---|---|---|---|
basic_message | 160文字以下のテキストのみを含むA2Pメッセージ。テキストにopenGraphタグ付きのウェブサイトのURLが含まれている場合、パートナーに追加料金なしで画像プレビューが表示されることがあります。 | ユーザーが返信するかどうかにかかわらず、常に個別の課金対象イベントとして扱われます。 | ユーザーが24時間以内に返信しない限り、個別の課金対象イベントとして扱われます。ユーザーが24時間以内に返信した場合、メッセージはa2p_conversationの一部となります。 |
single_message | リッチコンテンツを含む、または160文字を超えるテキストのみのA2Pメッセージ。 | ユーザーが返信するかどうかにかかわらず、常に個別の課金対象イベントとして扱われます。 | ユーザーが24時間以内に返信しない限り、個別の課金対象イベントとして扱われます。ユーザーが24時間以内に返信した場合、メッセージはa2p_conversationの一部となります。 |
a2p_conversation （ビジネス主導） | 既存の会話とは関係なく、ユーザーがA2Pメッセージを受信してから24時間以内に応答した場合に開始されます。 | 該当なし。非対話型エージェントは、この種のイベントを生成しません。 | 複数のA2Pメッセージの送信後24時間以内にP2Aメッセージが送信された場合、会話の開始にはP2Aメッセージの直前に送信されたA2Pメッセージのみが使用されます。このA2Pメッセージと、その後24時間以内に送信されるメッセージはすべて、 a2p_conversationの一部となります。 |
p2a_conversation （ユーザー開始） | エージェントが既存の会話とは関係なく、P2Aメッセージを受信してから24時間以内に応答した場合に開始されます。 | 該当なし。非対話型エージェントは、この種のイベントを生成しません。 | 複数のP2Aメッセージが24時間以内に送信された場合、A2Pメッセージの直前に送信されたP2Aメッセージのみが会話の開始に使用されます。このP2Aメッセージと、その後24時間以内に送信されるメッセージはすべて、 p2a_conversationの一部となります。 |
p2a_message | あらゆる種類のP2Aメッセージ。 | エージェントが応答したかどうかに関わらず、常に個別の課金対象イベントとして扱われます。 | 担当者が24時間以内に返信しない限り、個別の課金対象イベントとして扱われます。 |
請求カテゴリと請求対象イベント
エージェントの請求カテゴリーと請求対象イベントの違いを理解することは、エージェントへの請求方法を理解する上で非常に重要です。
- 課金カテゴリは、エージェントを作成する際に選択する固定の分類です。これにより、エージェントへの課金方法が決定されます。課金方法は、メッセージ単位（非対話型エージェント）または会話単位（対話型エージェント）となります。
- 課金対象となるイベントとは、RCS for Businessエージェントとユーザー間のやり取りで、課金目的で追跡されるものです（例：
basic_message、single_message、a2p_conversation）。
請求レポートの生成
テスター以外のトラフィックを持つエージェントのみが課金対象となるイベントを生成します。テスト用電話番号からのアクティビティは請求レポートには表示されません。
これらのレポートでは、イベントはメッセージが送信された時ではなく、配信された時に課金されることを前提としています。配信されなかったメッセージ、または配信前にキャンセルされたメッセージは、課金対象となるイベントを発生させません。
請求書レポートのフォーマット
請求レポートのファイル名は、 rbm_billable_events_YYYY-MM-DD.csvという形式です。ファイル名に含まれる日付は、ファイルの生成日です。
レポートの各行は、請求対象となる単一のイベントを表すレコードです。レコード内のフィールドはタブで区切られています。たとえば、同じエージェントとのA2P会話が2回発生した場合、請求対象となるイベントは2つ生成され、請求レポートには2つのレコードが記録されます。
レポート内の各レコードには、請求対象となる各イベントに関する以下の情報が含まれています。
| 分野 | 形式 | 説明 | 例 |
|---|---|---|---|
billing_event_id | 弦 | 課金対象となるイベントを識別するための生成されたID。 | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff |
type | 弦 | イベントの種類:
| single_message |
agent_id | 弦 | イベントに参加したエージェントの固有識別子。 | rbm-welcome-bot@rbm.goog |
agent_owner | 弦 | エージェントが作成されたパートナーアカウントの現在の所有者のメールアドレス。 | name@aggregator.com |
billing_party | 弦 | イベントの費用を請求する当事者。
| carrier |
max_duration_single_message | 番号 | 会話開始ウィンドウが閉じられ、メッセージがsingle_messageイベントとして分類されるまでに、ユーザーがエージェントメッセージに応答できる最大時間（時間単位）。 | 24 |
max_duration_a2p_conversation | 番号 | A2P会話の最大継続時間（時間単位）。エージェントからの最初のメッセージに対するユーザーからの最初の応答から計測されます。 | 24 |
max_duration_p2a_conversation | 番号 | P2A会話の最大継続時間（時間単位）。会話における最初のユーザーメッセージの送信時点から計測されます。 | 24 |
start_time | YYYY-mm-ddTHH:00:00Z | イベント開始時のUTC日時をISO 8601形式で、最も近い時間に丸めた値。 A2Pメッセージ
P2Aメッセージ
| 2019-07-25T08:00:00Z |
duration | 番号 | イベントの継続時間（分単位で四捨五入）。 会話以外のイベントの場合、値は0になります。 | 45 |
mt_messages | 番号 | イベントにおけるモバイル端末で終端された（A2P）メッセージの数。 | 11 |
mo_messages | 番号 | イベントにおけるモバイル端末発（P2A）メッセージの数。 | 9 |
size_kilobytes | 番号 | イベント内のメッセージに添付されたすべてのファイルのサイズを、最も近いキロバイトに四捨五入した値（1kBは1024バイトに相当）。 | 912 |
agent_name | 弦 | イベントに参加したエージェントの名前。 | XYZ Mobile USA |
owner_name | 弦 | エージェントが作成されたパートナーアカウントの現在の所有者の名前。 | XYZ Mobile |
請求書サンプル
サンプルレポートはダウンロード可能です。
標準的なファイルサイズ
RCS for Businessのアクティブなパートナーからの日次レポートのサイズは、通信事業者のネットワーク上で発生したアクティビティの量によって異なります。たとえば、レポートに53,000件のレコードが含まれている場合、ファイルサイズは約8MBになります。
アクティビティログ
アクティビティログには、RCS for Businessプラットフォーム上でのアクティビティに関する生データが記録されます。これらのログを使用して、課金対象となるイベントを監査したり、カスタムイベントを作成したりできます。
アクティビティログには、詳細な取引情報や加入者のMSISDNなどの個人識別情報（PII）が含まれているため、通信事業者が独自の利用規約に基づいてRCSを運用している場合にのみ利用可能です。ネットワーク上でRCS for Businessトラフィックが発生しており、Googleの利用規約に基づいてGoogle RCSでRCSアクティビティを有効にしている場合、アクティビティログにアクセスすることはできません。
アクティビティログの形式
アクティビティログのファイル名はrbm_activity_YYYY-MM-DD.csvという形式です。ファイル名に含まれる日付は、ファイルの生成日です。
レコード内のフィールドはタブ区切りで、1行に1つのレコードが表示されます。
アクティビティログの各レコードには、各アクティビティについて以下のフィールドが含まれています。
| 分野 | 形式 | 説明 | 例 |
|---|---|---|---|
activity_id | 弦 | アクティビティの一意の識別子。 | b422e1d3-ac99-442a-853d-a875d5e61762 |
billing_event_id | 弦 | 関連付けられた課金対象イベントの一意の識別子。アクティビティが課金対象イベントに関連付けられていない場合（例えば、対応するdelivery_receipt_eventのないtext_messageなど）は空にすることができます。 | 91yeb201-7c3b-412b-98d2-b0a0f7abe536 |
agent_id | 弦 | エージェント固有の識別子。 | welcome-bot@rbm.goog |
user_id | 弦 | ユーザーのMSISDN。 | 918369110173 |
direction | 弦 | メッセージの送信方向：
| MT |
time | YYYY-mm-ddTHH:MM:SS.SSSZ | イベントがRCS for Businessプラットフォームに送信された日時（UTC形式）。タイムスタンプを参照してください。 | 2019-07-25T00:29:07.033Z |
type | 弦 | 活動の種類:
| text_message |
size_bytes | 弦 | アクティビティに添付されたファイルのサイズ（バイト単位）。 | 912 |
タイムスタンプ
アクティビティログのタイムスタンプは、イベントがRCS for Businessプラットフォームに送信された日時を記録します。ユーザーにコンテンツを配信するイベントの場合、メッセージが配信されるまでアクティビティログには記録されません。
例えば、RCS for Businessメッセージが水曜日の13:00にユーザーに送信され、受信者が日曜日の9:00までオフラインだった場合、そのイベントは日曜日に生成されるアクティビティログに表示されますが、タイムスタンプは水曜日の13:00になります。