パートナーの請求レポート

パートナーには、エージェント、イベントタイプ、携帯通信会社ごとにグループ化された、課金対象イベントの 1 日あたりの集計数を示す請求レポート が届きます。これは、すべての課金対象トラフィックの概要を示し、トラフィック データに関する貴重な分析情報と必要な可視性を提供します。

ファイルの生成とアクセス

レポートは毎日 CSV 形式で生成され、Google SFTP サービスを使用して配信されます。

SFTP アクセス

レポートへのアクセスは、公開鍵と秘密鍵のペアによって保護されています。SFTP 認証情報により、安全で隔離されたアクセスが確保されます。

SFTP アクセス権を取得する方法

請求レポートを受け取るには、まず SFTP 認証情報を設定する必要があります。

1. SSH 鍵ペアを生成する: 手順に沿って、 SFTP ドロップボックス用のセキュアシェル（SSH）鍵ペアを生成します。
2. オンボーディングを開始する: パートナー レポートの受け取りに関心をお持ちの場合は、Google のビジネス担当者または Google のメインの担当者にお問い合わせください。請求レポート用のパートナー アカウントの初期設定と登録をご案内します。
3. 公開鍵を送信する: 公開鍵（PUB ファイル）を Google の担当者に提供します。Google がアカウントをプロビジョニングし、一意の <partner_id>を割り当てます。アクセスが可能になったら通知が届きます。

4. サーバーにアクセスする: 通知を受け取ったら、ポート 19321 を使用して partnerupload.google.com の SFTP サーバーでレポートにアクセスできます。接続するには、次のコマンドを使用します。

   sftp -i <path_to_private_key> -P 19321 rbmreports-partner-<partner_id>@partnerupload.google.com
   

ファイル名の命名規則

すべての携帯通信会社のレポートは、携帯通信会社ごとに分割されます。

ディレクトリとファイル名の命名規則は次のとおりです。

rbmreports-partner-<partner_id>/
  <YYYY>/<MM>/<DD>/
     summary_<short_carrier_id>/
        summary_<short_carrier_id>_<YYYY-MM-DD>.csv
     ...
     <prefix>_<short_carrier_id>/
        <prefix>_<short_carrier_id>_<YYYY-MM-DD>.csv

<prefix> は、配信されるレポートの特定のタイプを示します。

標準の接頭辞は次のとおりです。

レポートタイプ	ファイル名の接頭辞
概要レポート	summary

同じ携帯通信会社とパートナーに対して複数のレポートが存在する場合（形式の移行時など）は、必要に応じてカスタムのファイル名の接頭辞を追加できます。日付付きディレクトリ内のすべてのファイルを再帰的にスキャンする必要があります。

CSV レポートの構造

以降のセクションでは、パートナーの請求レポートで使用されるフィールド、データ形式、列の定義について説明します。

ご不明な点がございましたら、ご利用の携帯通信会社にお問い合わせください。

概要レポートの形式

フィールド	形式	説明	例
type	文字列	課金イベントのタイプ	a2p_session
agent_id	文字列	エージェントの一意の ID	[e-mail]
agent_name	文字列	イベントに参加したエージェントの名前	ACME Brand
carrier_id	文字列	トラフィックの携帯通信会社 ID	super-carrier
carrier_name	文字列	配送業者名	Super Carrier
carrier_country	文字列	ISO 3166-1 alpha-2 の国コード	US
start_date	文字列	イベントが開始された日付（YYYY-MM-DD 形式）	2026-05-07
billing_date	文字列	請求レポートが生成された日付	2026-05-08
event_count	数値	タイプ別の集計イベント数（合計）	150
segment_count*	数値	米国の請求モデル イベントの計算されたセグメント数（合計） *米国のみ	5