本頁介紹了 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:00 至 5 月 5 日凌晨 12:00 的數據。此處所指時間為太平洋標準時間 (PST)。
對於對話式代理，檔案包含產生檔案前 1-2 天的 24 小時資料。例如，5 月 5 日產生的報告涵蓋 5 月 2 日或 3 日的 24 小時數據。指定時間為太平洋標準時間 (PST)。
延遲的原因是，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 for Business 的業者均可取得計費報告。
帳單報告包含機密訊息，但不包含使用者個人識別資訊 (PII)，例如 MSISDN、哈希 MSISDN 或任何使用者唯一識別碼。
仲介計費類別
建立代理程式時，所有者會根據代理與使用者的互動方式設定其計費類別。計費類別不會限制代理可以發送的訊息數量或類型，但會決定代理發送訊息的計費方式。下表描述了兩種主要的計費類別。
| 計費類別 | 代理類型 | 範例用例 | 計費方式 |
|---|---|---|---|
| 非對話式 | 主要發送單向訊息的代理。 |
| 按發送給用戶的每個訊息收費。 |
| 對話 | 專為與使用者進行雙向交流而設計的代理。 |
| 依對話次數計費：如果一方（客服人員或使用者）在 24 小時內回覆另一方的訊息，則對話開始。在對話有效期限內（自首次回覆之日起 24 小時內），客服人員和使用者可以交換任意數量的消息，客服人員將以固定費率支付對話費用。 按訊息計費：如果客服人員發送的訊息用戶在 24 小時內沒有回复，客服人員將按該訊息單獨計費，類似於非對話式客服人員。 |
下圖展示了對話式代理程式的 A2P 計費會話範例：
對話式代理與非對話式代理
計費方式主要分為兩大類：對話式計費和非對話式計費。
計費類別的主要區別在於對話式代理和非對話式代理：
非對話式代理程式會根據其向用戶發送的每個訊息收費。
- 這一類別最適合那些不期望頻繁收到回覆的經紀人。
對話代理按對話次數收取固定費用，其中包括 24 小時內交換的所有訊息。
- 此類別最適合與用戶進行多輪對話的代理。
計費事件
計費報告中記錄了五種計費事件。這些事件包括 MT 和 MO 事件，分別稱為 A2P 事件和 P2A 事件。
- A2P（應用程式到個人）是 MT（行動終端） ：由企業發送的訊息。
- P2A（人機互動）即 MO（行動端發起） ：由使用者發起的訊息或操作。
下表描述了適用於非對話式代理程式和對話式代理程式的每項計費事件。
| 事件 | 描述 | 非對話代理 | 對話代理 |
|---|---|---|---|
basic_message | A2P訊息僅包含不超過160個字元的文字。如果文字包含帶有OpenGraph標籤的網站URL，則訊息可以顯示圖像預覽，合作夥伴無需支付額外費用。 | 無論用戶是否回复，請始終將其視為單獨的計費事件。 | 除非用戶在 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檔案名稱格式。檔案名稱中的日期是檔案產生日期。
報告中的每一行都是一筆記錄，代表一次計費事件。記錄內的各個欄位以製表符分隔。例如，與同一客服人員進行的兩次A2P對話將產生兩次單獨的計費事件，並在計費報告中產生兩筆記錄。
報告中的每筆記錄都包含以下關於每個計費事件的資訊。
| 場地 | 格式 | 描述 | 例子 |
|---|---|---|---|
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 平台上活動的原始資料。您可以使用這些日誌來審核計費事件並建立自訂事件。
由於活動日誌包含個人識別資訊 (PII)，例如詳細的交易資訊和使用者 MSISDN，因此只有當業者根據其自身的服務條款運作 RCS 時，才能存取這些日誌。如果您在網路上使用 RCS for Business 流量，並根據 Google 的服務條款啟用 Google RCS 活動，您將無法存取活動日誌。
活動日誌格式
活動日誌使用rbm_activity_YYYY-MM-DD.csv的檔案名稱格式。檔案名稱中的日期是檔案產生日期。
記錄中的欄位以製表符分隔，每行一筆記錄。
活動日誌中的每筆記錄都包含以下字段，分別對應每項活動：
| 場地 | 格式 | 描述 | 例子 |
|---|---|---|---|
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 平台的時間。對於向使用者傳遞內容的事件，只有在訊息送達後才會記錄在活動日誌中。
例如，如果週三 13:00 向使用者發送 RCS for Business 訊息，而收件者直到週日 9:00 才上線，則該事件將出現在周日產生的活動日誌中，但時間戳記將顯示為週三 13:00。