合作夥伴帳單報表

合作夥伴會收到摘要帳單報表，其中提供每日可計費事件的匯總計數，並依代理商、事件類型和電信業者分組。這份報表會提供所有可計費流量的概略摘要，讓您取得有價值的分析資料，並充分掌握流量資料。

產生及存取檔案

系統每天會產生 CSV 格式的報表，並透過 Google SFTP 服務傳送。

安全檔案傳輸通訊協定存取權

公開/私密金鑰組會保護報表的存取權。SFTP 憑證可確保安全且獨立的存取權。

如何取得安全檔案傳輸通訊協定存取權

如要接收帳單報表，請先設定安全檔案傳輸通訊協定憑證：

1. 產生安全殼層 (SSH) 金鑰組：按照操作說明產生 SFTP dropbox 的安全殼層 (SSH) 金鑰組。
2. 啟動新手上路程序：如要接收合作夥伴報表，請洽詢 Google 業務代表或 Google 主要聯絡人。他們會引導你完成初始設定，並註冊合作夥伴帳戶以取得帳單報表。
3. 提交公開金鑰：將公開金鑰 (PUB 檔案) 提供給 Google 聯絡窗口。Google 隨後會佈建帳戶、指派專屬 <partner_id> 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*	數字	美國帳單模式事件的計算區隔數 (SUM) *僅限美國	5