帳單報表和活動記錄

本頁說明 RCS 企業即時通訊建立的資料檔案，可協助電信業者進行帳單結算和稽核。

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

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

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

檔案生成

每個資料檔案代表一天內使用 RCS 企業訊息服務的資料，時間以世界標準時間 (UTC) 為準。系統每天都會產生檔案。生成過程可能需要數小時，完成時間可能有所不同。

  • 如果是非對話式代理程式，檔案會包含檔案產生時間前 24 小時的資料。舉例來說，如果帳單報表是在 5 月 5 日 11:00 (世界標準時間) 產生，則報表會包含 5 月 4 日 11:00 (世界標準時間) 到 5 月 5 日 11:00 (世界標準時間) 的資料。

  • 如果是對話代理程式，檔案會包含檔案產生時間前 1 到 2 天的 24 小時資料。舉例來說，如果帳單報表是在 5 月 5 日 11:00 (世界標準時間) 產生，報表可能包含 5 月 3 日 11:00 (世界標準時間) 到 5 月 4 日 11:00 (世界標準時間) 的資料。

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

重點：

  • 沒有活動：如果特定日期沒有任何平台活動，系統就不會產生檔案。

  • 命名：檔案名稱中的日期是檔案產生日期，而非檔案內資料的日期。

  • 保留期限：檔案最多保留 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 企業即時通訊流量可供匯報，系統就不會產生檔案。 也就是說，系統可能不會每天產生檔案。如需空白檔案來簡化程序，請與 rbm-support@google.com 聯絡。

帳單報表

帳單報表會記錄可計費事件，並根據代理程式的計費類別和傳送的訊息類型計算費用。只要電信業者目前正在使用 RCS 企業即時通訊，就能查看帳單報表。

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

代理商帳單類別

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

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

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

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

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

計費圖表

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

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

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

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

    • 如果服務專員不常回覆，建議使用這個類別。

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

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

可計費事件

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

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

下表說明每個可計費事件，並區分非對話式和對話式代理程式。

事件 說明 非對話式代理 對話式代理
basic_message 僅含文字的 A2P 訊息，長度不得超過 160 個半形字元。如果文字包含具有 Open Graph 標記的網站網址，訊息可能會顯示圖片預覽畫面，合作夥伴無須支付額外費用。 無論使用者是否回覆，一律視為個別計費事件。 除非使用者在 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 商家訊息服務專員與使用者之間的互動，系統會追蹤這些互動以利計費 (例如 basic_message、single_message、a2p_conversation)。

產生帳單報表

只有非測試人員流量的代理程式會產生可計費事件。帳單報表不會顯示測試電話號碼的活動。

這些報表假設事件的計費時間是訊息送達時，而非訊息傳送時。如果訊息未送達，或在送達前取消傳送，就不會觸發計費事件。

帳單報表格式

帳單報表使用 rbm_billable_events_YYYY-MM-DD.csv 檔案名稱格式。檔案名稱中的日期是檔案產生日期。

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

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

欄位 格式 說明 範例
billing_event_id string UUID 識別碼。系統會在建立每個新活動時產生隨機數字。 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
  • suggested_action_click
 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 數字 活動時間長度，四捨五入至最接近的分鐘數。

如果事件類型為 single_message 或 basic_message，值為 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 Business 合作夥伴的每日報表大小，取決於他們在電信業者網路中產生的活動量。舉例來說，如果報表中有 53,000 筆記錄，檔案大小約為 8 MB。

活動記錄

活動記錄會提供 RCS 企業訊息平台活動的原始資料。您可以使用這些記錄稽核帳單事件，並建立自訂事件。

注意：活動記錄只會包含來自非測試人員電話號碼的流量。

由於活動記錄含有個人識別資訊 (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 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 企業通訊平台的時間。如果是向使用者傳送內容的事件，系統會在訊息傳送後，才將事件記錄在活動記錄中。

舉例來說，如果系統在星期三 13:00 將 RCS 企業訊息傳送給使用者，但收件者在星期日 9:00 前都處於離線狀態，則該事件會顯示在星期日產生的活動記錄中，但時間戳記會是星期三 13:00。