帳單報表和活動記錄

本頁說明 RCS for Business 建立的資料檔案，這些檔案可協助電信業者進行帳單結算和稽核。

檔案 說明 擁有存取權的使用者
帳單報表 代理程式與使用者之間可計費事件的匯總報表。 所有積極經營 RCS for Business 的電信業者。
活動記錄 RCS for Business 活動的原始資料記錄，包括可計費事件。 積極經營 RCS for Business，並根據自身服務條款 (ToS) 經營 Google RCS 服務的電信業者。

RCS for Business 採用兩種計費模式：非美國流量的標準計費模式，以及美國流量的美國計費模式。標準模型或美國模型特有的資訊 (例如不同的可計費事件分類或報表欄位) 會明確註記。

  • 如要瞭解標準計費模式的詳細資訊，以及計費模式差異的摘要說明，請參閱計費常見問題。
  • 如要進一步瞭解美國的帳單分類，請參閱美國帳單模式指南。

檔案生成

每個資料檔案代表太平洋標準時間 (PST) 的一天 RCS for Business 用量。檔案每天都會產生，反映前 24 小時的活動 (午夜到午夜)。生成過程可能需要數小時，完成時間可能有所不同。

  • 如果是非對話式代理程式，檔案會包含檔案生成當天前 24 小時的資料。舉例來說，5 月 5 日產生的報表會涵蓋 5 月 4 日凌晨 12 點到 5 月 5 日凌晨 12 點的資料。指定時間以太平洋標準時間為準。

  • 如果是對話式代理，檔案會包含檔案產生時間前 1 到 2 天的 24 小時資料。舉例來說，5 月 5 日產生的報表會涵蓋 5 月 2 日或 5 月 3 日的 24 小時資料。指定的時間以太平洋標準時間為準。

    延遲的原因是，對話式代理程式的 RCS for Business 活動會連結至工作階段，而工作階段最多可能需要 24 小時才能完成。這段延遲時間可讓 RCS for Business 擷取對話中的所有訊息，再計算可計費事件。如要進一步瞭解對話式代理程式，請參閱「代理程式計費類別」。

重點：

  • 沒有活動：根據預設，如果特定日期沒有任何平台活動，系統就不會產生檔案。不過，如有需要，您可以選擇接收空白檔案。如要啟用這項功能，請與 rbm-support@google.com 聯絡。
  • 命名：檔案名稱中的日期是檔案產生日期，而非檔案內資料的日期。
  • 保留期限：檔案最多保留 63 天，期限一到就會刪除。

您可以使用這些檔案，以最新的平台使用情況指標更新資料倉儲。

檔案儲存空間和存取權

資料檔案在靜態和傳輸時都會加密。

如要透過安全檔案傳輸通訊協定 (SFTP) 擷取資料檔案，請提供 SFTP 公開金鑰。如要產生金鑰，請參閱產生 SFTP dropbox 的安全殼層 (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 服務，就能使用帳單報表。

帳單報表包含機密資訊，但不含使用者個人識別資訊 (PII)，例如 MSISDN、雜湊 MSISDN 或任何使用者專屬 ID。

代理商帳單類別

建立代理時，擁有者會根據代理與使用者的互動方式，設定帳單類別。帳單類別不會限制代理可傳送的訊息數量或類型。但會決定系統如何向代理程式收取訊息費用。下表說明兩大主要帳單類別。

帳單類別 服務專員類型 應用實例 計費方式
非對話 主要傳送單向訊息的代理程式。
  • 動態密碼
  • 快訊
  • 促銷優惠
 系統會針對傳送給使用者的每則訊息收費。
對話式 這類代理專為與使用者來回對話而設計。
  • 尋找合適的產品
  • 預訂車票
  • 排解問題

以對話計費：如果一方 (代理程式或使用者) 在 24 小時內回覆另一方的訊息，系統就會開始計算對話。在對話視窗期間 (首次回覆後的 24 小時內)，代理和使用者可以交換任意數量的訊息，且代理會以固定費率支付對話費用。

按訊息計費： 如果代理程式傳送訊息後，使用者在 24 小時內未回覆，系統會針對該訊息向代理程式收費，與非對話式代理程式類似。

下圖顯示對話式代理程式的 A2P 帳單結算工作階段範例：

計費圖表

對話式代理與非對話式代理

主要有兩大類帳單：對話式和非對話式。

帳單類別的主要差異在於對話式和非對話式代理程式：

  • 非對話式代理程式會針對傳送給使用者的每則訊息收費。

    • 如果代理程式不常回覆，最適合使用這個類別。

  • 系統會以固定費率向您收取對話費用，包括 24 小時內的所有訊息。

    • 這個類別最適合與使用者進行多輪對話的虛擬服務專員。

可計費事件

帳單報表會記錄五種可計費事件。這類事件包括 MT 和 MO 事件，也就是所謂的 A2P 和 P2A 事件。

  • A2P (應用程式對個人) 是 MT (行動裝置終止)：商家傳送的訊息。
  • P2A (使用者對應用程式) 是 MO (行動裝置發起)：使用者發起的訊息或動作。

下表說明各項可計費事件，適用於非對話式和對話式代理程式。

事件 說明 非對話式代理 對話式代理
basic_message A2P 訊息，僅包含 160 個半形字元以下的文字。如果文字包含具有 openGraph 標記的網站網址，訊息可能會顯示圖片預覽，合作夥伴無須支付額外費用。 無論使用者是否回覆，一律視為個別計費事件。 除非使用者在 24 小時內回覆，否則系統會將這類訊息視為個別計費事件。在這種情況下，訊息會成為 a2p_conversation 的一部分。
single_message 含有豐富內容的 A2P 訊息，或是超過 160 個半形字元的純文字訊息。 無論使用者是否回覆，一律視為個別計費事件。 除非使用者在 24 小時內回覆，否則系統會將這類訊息視為個別計費事件。在這種情況下，訊息會成為 a2p_conversation 的一部分。
a2p_conversation (商家發起) 使用者在收到 A2P 訊息後 24 小時內回覆，且不在現有對話中，就會觸發這個事件。 以上選項皆不適用，非對話式代理絕不會產生這類事件。 如果 P2A 訊息是在多則 A2P 訊息的 24 小時內傳送，系統只會使用緊接在 P2A 訊息前方的 A2P 訊息發起對話。這則 A2P 訊息和接下來 24 小時內傳送的任何訊息，都屬於 a2p_conversation。
p2a_conversation (使用者選擇關機) 服務專員在收到 P2A 訊息後 24 小時內回覆，且不在現有對話中回覆。 以上選項皆不適用，非對話式代理絕不會產生這類事件。 如果 A2P 訊息是在多則 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 檔案名稱格式。檔案名稱中的日期是檔案產生日期。

報表中的每一行都是一筆記錄，代表單一可計費事件。記錄中的欄位會以 Tab 字元分隔。舉例來說，如果同一位代理程式與使用者進行兩次 A2P 對話，系統會產生兩項可計費事件，並在帳單報表中顯示兩筆記錄。

報表中的每筆記錄都包含下列資訊，適用於每個可計費事件。

欄位 格式 說明 範例
billing_event_id string 產生的 ID，用於區分可計費事件。 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
type string 活動類型：

    標準計費模式

  • basic_message
  • single_message
  • a2p_conversation
  • p2a_conversation
  • p2a_message

    • 美國結帳模式

  • a2P_rich_message
  • a2p_rich_media_message
  • p2a_rich_message
  • p2a_rich_media_message
  • p2a_suggested_action
 single_message

p2a_rich_message
agent_id string 參與事件的代理程式專屬 ID。 rbm-welcome-bot@rbm.goog
agent_owner string 建立代理程式的合作夥伴帳戶現任擁有者電子郵件地址。 name@aggregator.com
billing_party string 負責支付活動費用的當事人。
  • 電信業者
 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 訊息

  • 如果是 single_message 和 basic_message 事件，這是指訊息傳送給使用者的時間。
  • 如果是 a2p_conversation 事件，這是指對話中的第一則訊息傳送給使用者的時間。

P2A 訊息

  • 如果是 single_message 和 basic_message 事件，這是指使用者傳送訊息的時間。
  • 如果是 p2a_conversation 事件，這是指使用者在對話中傳送第一則訊息的時間。
 2019-07-25T08:00:00Z
duration 數字 活動時間長度，四捨五入至最接近的分鐘數。

如果不是對話事件，這個值會是 0。

 45
mt_messages 數字 事件中的行動裝置終端 (A2P) 訊息數。 11
mo_messages 數字 活動中以行動裝置發送 (P2A) 的訊息數。 9
size_kilobytes 數字 活動中所有郵件附件的總大小，四捨五入至最接近的 KB (1 KB = 1024 位元組)。 912
agent_name string

參與活動的代理程式名稱。

 XYZ Mobile USA
owner_name string 建立服務專員的合作夥伴帳戶現任擁有者名稱。 XYZ Mobile
segment_count 數字 僅限美國結帳模式

RICH_MESSAGE 事件的計算區隔計數。

 5

帳單報表範例

您可以下載範例報表：

一般檔案大小

有效 RCS for Business 合作夥伴的每日報表大小，取決於他們在電信業者網路中產生的活動量。舉例來說，如果報表中有 53,000 筆記錄，檔案大小約為 8 MB。

活動記錄

活動記錄會提供 RCS for Business 平台活動的原始資料。您可以使用這些記錄稽核可計費事件，並建立自訂事件。

由於活動記錄含有個人識別資訊 (PII)，例如詳細交易資訊和訂閱者 MSISDN，因此只有在電信業者依據自家《服務條款》營運 RCS 時，才能使用活動記錄。如果您的網路有 RCS for Business 流量，並根據 Google 服務條款啟用 Google RCS 的 RCS 活動，您就無法存取活動記錄。

活動記錄格式

活動記錄會使用 rbm_activity_YYYY-MM-DD.csv 檔案名稱格式。檔案名稱中的日期是檔案產生日期。

記錄中的欄位會以 Tab 鍵分隔，且每行一筆記錄。

活動記錄中的每筆記錄都包含下列欄位：

欄位 格式 說明 範例
activity_id string 活動的專屬 ID。 b422e1d3-ac99-442a-853d-a875d5e61762
billing_event_id string 相關可計費事件的專屬 ID。如果活動未與可計費事件 (例如沒有相應 delivery_receipt_event 的 text_message) 建立關聯，則此欄位可以留空。 91yeb201-7c3b-412b-98d2-b0a0f7abe536
agent_id string 代理程式的專屬 ID。 welcome-bot@rbm.goog
user_id string 使用者的 MSISDN。 918369110173
direction string 訊息傳送方向：
  • MT (行動裝置終端) 的代理商對使用者活動
  • MO (行動裝置發起) 的使用者與服務專員互動
 MT
time YYYY-mm-ddTHH:MM:SS.SSSZ 以世界標準時間格式將事件提交至 RCS for Business 平台時的日期和時間。請參閱「時間戳記」。 2019-07-25T00:29:07.033Z
type string 活動類型：
  • text_message
  • file_transfer
  • rich_card/carousel
  • suggestion_tap
  • delivery_receipt_event
  • read_receipt_event
  • spam_report
 text_message
size_bytes string 附加至活動的檔案大小，以位元組為單位。 912

時間戳記

活動記錄中的時間戳記會記錄事件提交至 RCS 企業通訊平台的時間。如果事件會向使用者傳送內容，系統要等到訊息傳送完畢，才會將事件記錄在活動記錄中。

舉例來說，如果系統在星期三下午 1 點傳送 RCS for Business 訊息給使用者，但收件者直到星期日早上 9 點才上線，則該事件會顯示在星期日產生的活動記錄中，但時間戳記會是星期三下午 1 點。