本頁說明 RBM 建立的資料檔案，協助電信業者進行帳單和稽核作業。
| 檔案 | 說明 | 擁有存取權的使用者 |
|---|---|---|
| 帳單事件報表 | 匯總報表，顯示已啟動服務專員和使用者之間的可計費事件。 | 所有具備已簽署 RBM MDA 的電信業者。 |
| 活動記錄 | RBM 活動的原始資料記錄，包括可計費事件。 | 擁有簽署 RBM MDA 的電信業者，並根據自身服務條款 (ToS) 營運 Google RCS 服務。 |
檔案產生
每個資料檔案都代表 RBM 在世界標準時間 (UTC) 的使用情形，檔案會在世界標準時間每天 10:00 至 12:00 之間產生。
對於非對話式的服務機器人，檔案會包含檔案產生前 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 (世界標準時間) 的資料。
延遲的原因是對話方塊的 RBM 活動會連結至對話，而對話最多可能需要 48 小時才能完成。這段延遲時間可讓 RBM 在計算帳單事件前，先擷取對話中的所有訊息。如要進一步瞭解對話式代理程式，請參閱「代理程式計費類別」。
重點：
沒有活動：如果某天沒有平台活動，系統就不會產生檔案。
命名：檔案名稱中的日期是檔案產生日期，而非資料日期。
保留：檔案最多可保留 30 天，期限一到就會刪除。
您可以使用這些檔案，透過最新的平台使用量指標更新資料倉儲。
檔案儲存和存取
資料檔案會在靜態和傳輸狀態下加密。
如要透過 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 的安全檔案傳輸通訊協定錯誤，這也是預期的結果。
如果沒有可回報的 RBM 流量，系統就不會產生檔案。也就是說，有些日子可能不會產生任何檔案。如需空白檔案來簡化程序，請與 rbm-support@google.com 聯絡。
帳單事件報表
帳單事件報表是帳單事件的記錄，這些事件會根據服務專員的帳單類別和傳送的訊息類型計算。所有已啟用 RBM MDA 的電信業者都能使用帳單活動報表。
帳單事件報表包含機密資訊，但不含使用者的個人識別資訊 (PII)，例如 MSISDN、雜湊 MSISDN 或任何使用者專屬 ID。
服務專員帳單類別
建立服務專員時，擁有者會根據服務專員與使用者的互動方式，設定計費類別。帳單類別不會限制服務專員可傳送的訊息數量或類型。但這會決定服務專員的訊息收費方式。下表說明兩個主要的帳單類別。
| 帳單類別 | 服務專員類型 | 使用範例 | 計費方式 |
|---|---|---|---|
非對話式 (包括基本訊息和單一訊息類別。注意：這兩個類別之間已無任何差異。系統會將這兩類服務專員視為非對話服務專員，並依此收費)。 |
主要傳送單向訊息的服務專員。 |
|
每向使用者傳送一則訊息，就會產生費用。 |
| 對話式 | 專為與使用者進行雙向互動的服務專員。 |
|
按對話計費：如果一方 (代理人或使用者) 在 24 小時內回覆另一方傳送的訊息，就會開始對話。在對話時間範圍內 (首次回覆後的 24 小時)，服務專員和使用者可以交換任意數量的訊息，且服務專員將依固定費率收費。 按訊息計費：如果服務機器人傳送的訊息在 24 小時內未獲得使用者回覆，系統會針對個別訊息向服務機器人收費，類似於非對話式服務機器人。 |
對話式與非對話式服務專員
主要的計費類別有兩種：對話和非對話。非對話類別包含「Basic Message」和「Single Message」類別，兩者功能相同。這兩類服務專員都會以非對話型服務專員計費。
結算類別的主要差異在於對話式和非對話式服務：
非對話式服務機器人會為向使用者傳送的每則訊息收費。
- 這個類別最適合不需頻繁回覆的服務專員。
對話型虛擬服務專員的對話收費以固定費率計算，包括 24 小時內傳送的所有訊息。
- 這個類別最適合與使用者進行多回合對話的服務專員。
結帳事件
帳單事件報表會記錄五種不同類型的帳單事件。這類事件包括 A2P 和 P2A 訊息。
- A2P (應用程式傳送給使用者)：由品牌傳送。
- P2A (使用者對應用程式)：由使用者傳送。
下表說明各項結帳事件，以及如何套用至非對話和對話式服務機器人。
| 活動 | 說明 | 非對話式服務專員 | 對話式虛擬服務專員 |
|---|---|---|---|
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 小時內傳送，系統只會使用最先傳送的 P2A 訊息來發起對話。這則 P2A 訊息和接下來 24 小時內傳送的任何訊息，都屬於 p2a_conversation。
|
p2a_message
|
任何類型的 P2A 訊息。 | 無論服務專員是否回覆，一律視為個別帳單事件。 | 除非服務專員在 24 小時內回覆，否則會視為個別的帳單事件。 |
帳單活動與帳單類別
請勿將 basic_message 和 single_message 結帳事件與基本訊息和單一訊息結帳類別混淆。
任何代理程式 (不論其帳單類別為何) 皆可產生
basic_message和single_message結帳事件。「基本訊息」和「單一訊息」結帳類別用於分類非對話式服務機器人。這些結帳類別中的服務機器人不會產生對話結帳事件 (
a2p_conversations或p2a_conversations)，而是會產生個別的basic_message、single_message和p2a_message結帳事件。
產生帳單報表
只有非測試人員流量的代理程式會產生結帳事件。測試電話號碼的活動不會顯示在帳單事件報表中。
這些報表假設事件是在訊息傳送完成時計費，而不是在訊息傳送時計費。未送達的訊息或在傳送前取消的訊息不會觸發帳單事件。
帳單報表格式
帳單事件報表使用 rbm_billable_events_YYYY-MM-DD.csv 檔案名稱格式。檔案名稱中的日期為檔案產生日期。
報表中的每一行都是代表單一帳單事件的記錄。記錄中的欄位以 Tab 鍵分隔。舉例來說，如果有兩次 A2P 對話與同一位服務專員進行，系統就會在帳單事件報表中產生兩次帳單事件和兩個記錄。
報表中的每個記錄都包含每個帳單事件的以下資訊：
| 欄位 | 格式 | 說明 | 範例 |
|---|---|---|---|
billing_event_id
|
字串 | UUID ID。系統會在建立每個新事件時產生隨機數字。 | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
|
type
|
字串 | 事件類型：
|
single_message
|
agent_id
|
字串 | 參與事件的代理人的專屬 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 格式表示，並四捨五入至最近的小時。
|
2019-07-25T08:00:00Z
|
duration
|
號碼 | 事件時間長度，四捨五入至最接近的分鐘。 如果事件類型為 |
45
|
mt_messages
|
號碼 | 事件中行動端終端 (A2P) 訊息的數量。 | 11
|
mo_messages
|
號碼 | 事件中行動裝置原始 (P2A) 訊息數量。 | 9
|
size_kilobytes
|
號碼 | 事件中附加至郵件的所有檔案大小，四捨五入至最接近的千位元組 (1 kB = 1024 位元組)。 | 912
|
agent_name
|
字串 |
參與事件的代理人名稱。 |
XYZ Mobile USA
|
owner_name
|
字串 | 服務專員建立所在的合作夥伴帳戶目前擁有者名稱。 | XYZ Mobile
|
帳單事件報表範例
您可以下載範例帳單報表檔案。
一般檔案大小
來自有效 RBM 合作夥伴的每日報表可能包含約 53,000 筆記錄，大小約為 8 MB。
活動記錄
活動記錄會提供 RBM 平台活動的原始資料。您可以使用這些記錄稽核帳單事件，並建立自訂事件。
由於活動記錄包含個人識別資訊 (PII)，例如詳細交易資訊和訂閱者 MSISDN，因此只有在電信業者依據自身的服務條款操作 RCS 時，才能使用這些記錄。如果網路上有 RBM 流量，且您根據 Google 的服務條款啟用 Google RCS Cloud 的 RCS 活動，就無法存取活動記錄。
活動記錄格式
活動記錄會使用 rbm_activity_YYYY-MM-DD.csv 檔案名稱格式。檔案名稱中的日期是檔案產生日期。
記錄中的欄位以 Tab 鍵分隔，每行一個記錄。
活動記錄中的每個記錄都包含每項活動的以下欄位：
| 欄位 | 格式 | 說明 | 範例 |
|---|---|---|---|
activity_id
|
字串 | 活動的專屬 ID。 | b422e1d3-ac99-442a-853d-a875d5e61762
|
billing_event_id
|
字串 | 相關帳單事件的專屬 ID。如果活動未與帳單事件相關聯 (例如沒有對應的 delivery_receipt_event 的 text_message)，則此欄位可以留空。 |
91yeb201-7c3b-412b-98d2-b0a0f7abe536
|
agent_id
|
字串 | 代理人的專屬 ID。 | welcome-bot@rbm.goog
|
user_id
|
字串 | 使用者的 MSISDN。 | 918369110173
|
direction
|
字串 | 訊息傳送的方向：
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | 事件提交至 RBM 平台的日期和時間，以世界標準時間為準。請參閱「時間戳記」。 | 2019-07-25T00:29:07.033Z
|
type
|
字串 | 活動類型：
|
text_message
|
size_bytes
|
字串 | 活動附加檔案的大小，以位元組為單位。 | 912
|
時間戳記
活動記錄中的時間戳記會記錄事件提交至 RBM 平台的時間。如果事件是向使用者傳送內容，則必須在訊息傳送後，事件才會記錄在活動記錄中。
舉例來說，如果在星期三下午 1 點傳送 RBM 訊息給使用者，而收件者在星期日上午 9 點前都處於離線狀態，則事件會顯示在星期日產生的活動記錄中，但時間戳記會顯示為星期三下午 1 點。
常見問題
什麼是對話？
在 RBM 中，對話是指使用者和對話式服務專員在 24 小時內交換的一系列訊息。只有具有對話式帳單類別的服務專員，才能產生對話，並針對下列帳單事件收費：
- A2P 對話：品牌發起的對話。
- P2A 對話：使用者發起的對話。
對話的運作方式
開始：當一方 (服務專員或使用者) 在收到訊息後的 24 小時內回覆訊息，且該訊息並非來自任何現有對話時，對話就會開始。
- A2P 對話：使用者回覆服務專員訊息時開始。
- P2A 對話：服務專員回覆使用者訊息時開始。
對話視窗：對話開始後，對話會在 24 小時內保持有效。對話內容包括這段 24 小時內的所有訊息，以及最初回覆的首則訊息。
計費：對話式服務會根據整個對話計費，而非個別訊息。這表示費用與對話串相關聯，而非其中的訊息數量。
重要事項：
對話功能不適用於非對話式服務專員。使用「基本訊息」或「單一訊息」帳單類別的服務專員，無論使用者是否回覆，都會依訊息計費。
在對話式服務中，帳單事件報表和活動記錄檔的產生時間最多可能延遲兩天。這段延遲時間可讓 RBM 在計算帳單事件前，先擷取對話中的所有訊息。