Trang này mô tả các tệp dữ liệu mà RBM tạo để hỗ trợ các nhà mạng trong việc lập hoá đơn và kiểm tra.
| Tệp | Mô tả | Người có quyền truy cập |
|---|---|---|
| Báo cáo sự kiện thanh toán | Báo cáo tổng hợp về các sự kiện có thể tính phí giữa người dùng và các tác nhân đã khởi chạy. | Tất cả nhà mạng có MDA RBM đã ký. |
| Nhật ký hoạt động | Nhật ký dữ liệu thô về hoạt động RBM, bao gồm cả các sự kiện có thể tính phí. | Những nhà mạng có MDA RBM đã ký và vận hành Dịch vụ RCS của Google theo Điều khoản dịch vụ (ToS) của riêng họ. |
Tạo tệp
Mỗi tệp dữ liệu đại diện cho một ngày sử dụng RBM theo Giờ phối hợp quốc tế (UTC). Các tệp được tạo hằng ngày từ 10:00 đến 12:00 (giờ UTC).
Đối với các trợ lý không trò chuyện, các tệp này chứa dữ liệu trong khoảng thời gian 24 giờ ngay trước thời điểm tạo tệp. Ví dụ: nếu báo cáo sự kiện thanh toán được tạo vào lúc 11:00 (giờ UTC) ngày 5 tháng 5, thì báo cáo đó sẽ chứa dữ liệu từ 11:00 (giờ UTC) ngày 4 tháng 5 đến 11:00 (giờ UTC) ngày 5 tháng 5.
Đối với các trợ lý trò chuyện, các tệp này chứa dữ liệu trong khoảng thời gian 24 giờ từ 1 đến 2 ngày trước thời điểm tạo tệp. Ví dụ: nếu báo cáo sự kiện thanh toán được tạo vào lúc 11:00 (giờ UTC) ngày 5 tháng 5, thì báo cáo đó có thể chứa dữ liệu từ 11:00 (giờ UTC) ngày 3 tháng 5 đến 11:00 (giờ UTC) ngày 4 tháng 5.
Lý do dẫn đến sự chậm trễ này là hoạt động RBM cho các nhân viên hỗ trợ trò chuyện được liên kết với các cuộc trò chuyện. Quá trình này có thể mất đến 48 giờ để hoàn tất. Độ trễ này cho phép RBM ghi lại tất cả tin nhắn trong một cuộc trò chuyện trước khi tính toán sự kiện thanh toán. Để biết thêm thông tin về các trợ lý trò chuyện, hãy tham khảo bài viết Danh mục thanh toán của trợ lý.
Điểm chính:
Không có hoạt động: Nếu không có hoạt động nào trên nền tảng vào một ngày nhất định, thì sẽ không có tệp nào được tạo.
Đặt tên: Ngày trong tên tệp là ngày tạo tệp, chứ không phải ngày của dữ liệu trong tệp.
Thời gian lưu giữ: Các tệp được lưu trữ trong tối đa 30 ngày trước khi bị xoá.
Bạn có thể sử dụng các tệp này để cập nhật kho dữ liệu bằng các chỉ số sử dụng nền tảng mới nhất.
Lưu trữ và truy cập tệp
Các tệp dữ liệu được mã hoá ở trạng thái tĩnh và trong khi truyền.
Để truy xuất tệp dữ liệu bằng SFTP, hãy cung cấp khoá công khai SFTP. Để tạo khoá, hãy xem bài viết Tạo cặp khoá Secure Shell (SSH) cho tài khoản đăng SFTP.
Máy chủ SFTP là partnerupload.google.com và kết nối ở số cổng cao (19321) để tăng cường bảo mật.
Bạn có thể sử dụng lệnh sau để truy cập vào các tệp dữ liệu:
sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com
Google cung cấp tên người dùng của tài khoản theo các định dạng sau:
rbmreports-billableevents-<carrier name>rbmreports-activity-<carrier name>
Google chỉ định <carrier name> và cung cấp tài khoản riêng cho từng loại báo cáo.
Bạn sẽ được cung cấp các tài khoản riêng để truy cập vào các loại báo cáo khác nhau.
Tình trạng sẵn có của tệp
Nếu chưa có tệp dữ liệu nào được tạo, bạn sẽ thấy lỗi SFTP tương tự như remote readdir("/"): No such file or directory.
Tệp sẽ không được tạo nếu không có lưu lượng truy cập RBM để báo cáo. Điều này có nghĩa là có thể có một số ngày không tạo được tệp nào. Nếu bạn cần tệp trống để đơn giản hoá quy trình, hãy liên hệ theo địa chỉ rbm-support@google.com.
Báo cáo sự kiện thanh toán
Báo cáo sự kiện thanh toán là bản ghi của sự kiện thanh toán, được tính toán dựa trên danh mục thanh toán của tác nhân và loại thông báo mà tác nhân gửi. Tất cả các nhà mạng đã triển khai MDA RBM đều có thể sử dụng báo cáo sự kiện thanh toán.
Báo cáo sự kiện thanh toán chứa thông tin bảo mật nhưng không có Thông tin nhận dạng cá nhân (PII) của người dùng, chẳng hạn như MSISDN, MSISDN đã băm hoặc bất kỳ giá trị nhận dạng duy nhất nào của người dùng.
Danh mục thanh toán của nhân viên hỗ trợ
Khi tạo một nhân viên hỗ trợ, chủ sở hữu sẽ đặt danh mục thanh toán dựa trên cách nhân viên hỗ trợ tương tác với người dùng. Danh mục thanh toán không hạn chế số lượng hoặc loại tin nhắn mà nhân viên hỗ trợ có thể gửi. Tuy nhiên, thông tin này sẽ xác định cách nhân viên hỗ trợ được tính phí cho các tin nhắn. Hai danh mục thanh toán chính được mô tả trong bảng sau.
| Danh mục thanh toán | Loại nhân viên hỗ trợ | Ví dụ về trường hợp sử dụng | Phương thức thanh toán |
|---|---|---|---|
Không phải cuộc trò chuyện (Bao gồm danh mục Tin nhắn cơ bản và Tin nhắn đơn. Lưu ý: Hai danh mục này không còn khác biệt nữa. Một nhân viên hỗ trợ thuộc một trong hai danh mục này sẽ được tính phí là nhân viên hỗ trợ không có tính năng trò chuyện.) |
Các tác nhân chủ yếu gửi thông báo một chiều. |
|
Tính phí cho mỗi thông báo được gửi đến người dùng. |
| Cuộc trò chuyện | Các trợ lý được thiết kế để trao đổi qua lại với người dùng. |
|
Tính phí theo cuộc trò chuyện: Nếu một bên (nhân viên hỗ trợ hoặc người dùng) trả lời tin nhắn của bên kia trong vòng 24 giờ, thì một cuộc trò chuyện sẽ bắt đầu. Trong khoảng thời gian trò chuyện (24 giờ sau khi trả lời đầu tiên), nhân viên hỗ trợ và người dùng có thể trao đổi số lượng tin nhắn bất kỳ và nhân viên hỗ trợ sẽ được tính phí theo mức cố định cho cuộc trò chuyện. Tính phí theo tin nhắn: Nếu người dùng không trả lời tin nhắn mà nhân viên hỗ trợ gửi trong vòng 24 giờ, thì nhân viên hỗ trợ sẽ bị tính phí cho từng tin nhắn, tương tự như nhân viên hỗ trợ không có tính năng trò chuyện. |
Nhân viên hỗ trợ trò chuyện so với nhân viên hỗ trợ không trò chuyện
Có hai danh mục thanh toán chính: trò chuyện và không trò chuyện. Danh mục không phải cuộc trò chuyện bao gồm các danh mục Tin nhắn cơ bản và Tin nhắn đơn, có chức năng giống hệt nhau. Một nhân viên hỗ trợ thuộc một trong hai danh mục này sẽ được tính phí là nhân viên hỗ trợ không có tính năng trò chuyện.
Điểm khác biệt chính trong các danh mục thanh toán là giữa các nhân viên hỗ trợ có tính năng trò chuyện và không có tính năng trò chuyện:
Các tác nhân không trò chuyện sẽ được tính phí cho mỗi thông báo mà họ gửi đến người dùng.
- Danh mục này phù hợp nhất với những nhân viên hỗ trợ không mong đợi nhận được thư trả lời thường xuyên.
Các trợ lý trò chuyện được tính phí theo mức giá cố định cho cuộc trò chuyện, bao gồm tất cả tin nhắn được trao đổi trong khoảng thời gian 24 giờ.
- Danh mục này phù hợp nhất với những nhân viên hỗ trợ tham gia vào các cuộc trò chuyện nhiều lượt với người dùng.
Sự kiện thanh toán
Có 5 loại sự kiện thanh toán được ghi lại trong báo cáo sự kiện thanh toán. Các sự kiện này bao gồm cả tin nhắn A2P và P2A.
- A2P (Ứng dụng đến người dùng): Do thương hiệu gửi.
- P2A (Người dùng đến ứng dụng): Do người dùng gửi.
Bảng sau đây mô tả từng sự kiện thanh toán áp dụng cho các trợ lý không trò chuyện và trợ lý trò chuyện.
| Sự kiện | Mô tả | Nhân viên hỗ trợ không có tính trò chuyện | Nhân viên hỗ trợ trò chuyện |
|---|---|---|---|
basic_message
|
Tin nhắn A2P chỉ chứa văn bản có tối đa 160 ký tự. Nếu văn bản bao gồm URL của một trang web có thẻ openGraph, thì thông báo có thể hiển thị bản xem trước hình ảnh mà không tính thêm phí cho đối tác. | Luôn được coi là một sự kiện thanh toán riêng lẻ, bất kể người dùng có trả lời hay không. | Được coi là một sự kiện thanh toán riêng lẻ, trừ phi người dùng trả lời trong vòng 24 giờ. Trong trường hợp đó, thông báo sẽ trở thành một phần của a2p_conversation.
|
single_message
|
Tin nhắn A2P có nội dung đa phương tiện và/hoặc văn bản dài hơn 160 ký tự. | Luôn được coi là một sự kiện thanh toán riêng lẻ, bất kể người dùng có trả lời hay không. | Được coi là một sự kiện thanh toán riêng lẻ, trừ phi người dùng trả lời trong vòng 24 giờ. Trong trường hợp đó, thông báo sẽ trở thành một phần của a2p_conversation.
|
a2p_conversation (do thương hiệu khởi tạo)
|
Được bắt đầu khi người dùng trả lời tin nhắn A2P trong vòng 24 giờ kể từ khi nhận được tin nhắn, ngoài cuộc trò chuyện hiện có. | Không có. Các tác nhân không trò chuyện không bao giờ tạo loại sự kiện này. | Nếu một tin nhắn P2A được phân phối trong vòng 24 giờ sau khi gửi nhiều tin nhắn A2P, thì chỉ tin nhắn A2P ngay trước tin nhắn P2A mới được dùng để bắt đầu cuộc trò chuyện. Thông báo A2P này và mọi thông báo được phân phối trong vòng 24 giờ tới đều thuộc a2p_conversation.
|
p2a_conversation (do người dùng khởi tạo)
|
Được bắt đầu khi nhân viên hỗ trợ trả lời tin nhắn P2A trong vòng 24 giờ kể từ khi nhận được tin nhắn đó, ngoài cuộc trò chuyện hiện có. | Không có. Các tác nhân không trò chuyện không bao giờ tạo loại sự kiện này. | Nếu một tin nhắn A2P được phân phối trong vòng 24 giờ kể từ nhiều tin nhắn P2A, thì chỉ tin nhắn P2A ngay trước tin nhắn A2P mới được dùng để bắt đầu cuộc trò chuyện. Thông báo P2A này và mọi thông báo được phân phối trong vòng 24 giờ tới đều thuộc p2a_conversation.
|
p2a_message
|
Tin nhắn P2A thuộc bất kỳ loại nào. | Luôn được coi là một sự kiện thanh toán riêng lẻ, bất kể nhân viên hỗ trợ có trả lời hay không. | Được coi là một sự kiện thanh toán riêng lẻ, trừ phi nhân viên hỗ trợ trả lời trong vòng 24 giờ. |
Sự kiện thanh toán so với danh mục thanh toán
Bạn không nên nhầm lẫn sự kiện thanh toán basic_message và single_message với các danh mục thanh toán Tin nhắn cơ bản và Tin nhắn đơn.
Mọi tác nhân (bất kể danh mục thanh toán) đều có thể tạo sự kiện thanh toán
basic_messagevàsingle_message.Danh mục thanh toán Tin nhắn cơ bản và Tin nhắn đơn được dùng để phân loại các nhân viên hỗ trợ không có tính năng trò chuyện. Các nhân viên hỗ trợ trong các danh mục thanh toán này không tạo sự kiện thanh toán qua cuộc trò chuyện (
a2p_conversationshoặcp2a_conversations). Thay vào đó, họ tạo các sự kiện thanh toánbasic_message,single_messagevàp2a_messageriêng lẻ.
Tạo báo cáo thanh toán
Chỉ những đại lý có lưu lượng truy cập không phải của người kiểm thử mới tạo sự kiện thanh toán. Hoạt động từ số điện thoại thử nghiệm sẽ không xuất hiện trong báo cáo sự kiện thanh toán.
Các báo cáo này giả định rằng các sự kiện được tính phí khi tin nhắn được phân phối, chứ không phải khi tin nhắn được gửi. Thư không được phân phối hoặc thư bị huỷ trước khi phân phối sẽ không kích hoạt sự kiện thanh toán.
Định dạng báo cáo thanh toán
Báo cáo sự kiện thanh toán sử dụng định dạng tên tệp rbm_billable_events_YYYY-MM-DD.csv. Ngày trong tên tệp là ngày tạo tệp.
Mỗi dòng trong báo cáo là một bản ghi đại diện cho một sự kiện thanh toán. Các trường trong một bản ghi được phân tách bằng thẻ. Ví dụ: hai cuộc trò chuyện A2P với cùng một nhân viên hỗ trợ sẽ tạo ra hai sự kiện thanh toán và hai bản ghi trong báo cáo sự kiện thanh toán.
Mỗi bản ghi trong báo cáo chứa các thông tin sau đây cho từng sự kiện thanh toán:
| Trường | Định dạng | Mô tả | Ví dụ: |
|---|---|---|---|
billing_event_id
|
chuỗi | Giá trị nhận dạng UUID. Một số ngẫu nhiên được tạo cho mỗi sự kiện mới tại thời điểm tạo sự kiện đó. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
|
type
|
chuỗi | Loại sự kiện:
|
single_message
|
agent_id
|
chuỗi | Giá trị nhận dạng duy nhất của tác nhân đã tham gia sự kiện. | rbm-welcome-bot@rbm.goog
|
agent_owner
|
chuỗi | Địa chỉ email của chủ sở hữu hiện tại của tài khoản đối tác nơi nhân viên hỗ trợ được tạo. | name@aggregator.com
|
billing_party
|
chuỗi | Bên tính phí cho các sự kiện.
|
carrier
|
max_duration_single_message
|
số | Thời gian tối đa (tính bằng giờ) mà người dùng được phép trả lời tin nhắn của nhân viên hỗ trợ trước khi cửa sổ bắt đầu cuộc trò chuyện đóng và tin nhắn được phân loại là sự kiện single_message.
|
24
|
max_duration_a2p_conversation
|
số | Thời lượng tối đa của một cuộc trò chuyện A2P, tính bằng giờ. Được đo lường từ phản hồi đầu tiên của người dùng đến tin nhắn ban đầu của nhân viên hỗ trợ. | 24
|
max_duration_p2a_conversation
|
số | Thời lượng tối đa của cuộc trò chuyện P2A, tính bằng giờ. Được đo lường từ tin nhắn đầu tiên của người dùng trong cuộc trò chuyện. | 24
|
start_time
|
YYYY-mm-ddTHH:00:00Z | Ngày/giờ theo chuẩn UTC mà sự kiện bắt đầu ở định dạng ISO 8601, được làm tròn đến giờ gần nhất.
|
2019-07-25T08:00:00Z
|
duration
|
số | Thời lượng sự kiện, được làm tròn đến phút gần nhất.
Khi loại sự kiện là |
45
|
mt_messages
|
số | Số lượng tin nhắn kết thúc trên thiết bị di động (A2P) trong sự kiện. | 11
|
mo_messages
|
số | Số lượng tin nhắn bắt nguồn từ thiết bị di động (P2A) trong sự kiện. | 9
|
size_kilobytes
|
số | Kích thước của tất cả tệp đính kèm vào tin nhắn trong sự kiện, được làm tròn đến kibibyte gần nhất (1 kibibyte = 1024 byte). | 912
|
agent_name
|
chuỗi |
Tên của nhân viên hỗ trợ đã tham gia sự kiện. |
XYZ Mobile USA
|
owner_name
|
chuỗi | Tên của chủ sở hữu hiện tại của tài khoản đối tác nơi nhân viên hỗ trợ được tạo. | XYZ Mobile
|
Báo cáo sự kiện thanh toán mẫu
Bạn có thể tải tệp báo cáo thanh toán mẫu xuống.
Kích thước tệp thông thường
Báo cáo hằng ngày của một đối tác RBM đang hoạt động có thể chứa khoảng 53.000 bản ghi và có kích thước khoảng 8 Mb.
Nhật ký hoạt động
Nhật ký hoạt động cung cấp dữ liệu thô về hoạt động trên nền tảng RBM. Bạn có thể sử dụng các nhật ký này để kiểm tra các sự kiện thanh toán và tạo sự kiện tuỳ chỉnh.
Vì nhật ký hoạt động chứa Thông tin nhận dạng cá nhân (PII), chẳng hạn như thông tin giao dịch chi tiết và MSISDN của người đăng ký, nên nhật ký hoạt động chỉ có sẵn khi nhà mạng đang vận hành RCS theo Điều khoản dịch vụ của riêng họ. Nếu có lưu lượng truy cập RBM trên mạng và bật hoạt động RCS bằng Google RCS Cloud theo Điều khoản dịch vụ của Google, thì bạn sẽ không có quyền truy cập vào nhật ký hoạt động.
Định dạng nhật ký hoạt động
Nhật ký hoạt động sử dụng định dạng tên tệp rbm_activity_YYYY-MM-DD.csv. Ngày trong tên tệp là ngày tạo tệp.
Các trường trong một bản ghi được phân tách bằng dấu tab và mỗi dòng có một bản ghi.
Mỗi bản ghi trong nhật ký hoạt động chứa các trường sau đây cho mỗi hoạt động:
| Trường | Định dạng | Mô tả | Ví dụ: |
|---|---|---|---|
activity_id
|
chuỗi | Giá trị nhận dạng duy nhất của hoạt động. | b422e1d3-ac99-442a-853d-a875d5e61762
|
billing_event_id
|
chuỗi | Giá trị nhận dạng duy nhất của sự kiện thanh toán được liên kết. Có thể trống nếu hoạt động không được liên kết với một sự kiện thanh toán, chẳng hạn như text_message không có delivery_receipt_event tương ứng.
|
91yeb201-7c3b-412b-98d2-b0a0f7abe536
|
agent_id
|
chuỗi | Giá trị nhận dạng duy nhất của đại lý. | welcome-bot@rbm.goog
|
user_id
|
chuỗi | MSISDN của người dùng. | 918369110173
|
direction
|
chuỗi | Hướng gửi thông báo:
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | Ngày và giờ gửi sự kiện đến nền tảng RBM theo định dạng UTC. Xem phần Dấu thời gian. | 2019-07-25T00:29:07.033Z
|
type
|
chuỗi | Loại hoạt động:
|
text_message
|
size_bytes
|
chuỗi | Kích thước của các tệp đính kèm vào hoạt động, tính bằng byte. | 912
|
Dấu thời gian
Dấu thời gian trong nhật ký hoạt động ghi lại thời điểm một sự kiện được gửi đến nền tảng RBM. Đối với các sự kiện phân phối nội dung cho người dùng, sự kiện sẽ không được ghi lại trong nhật ký hoạt động cho đến khi thông báo được phân phối.
Ví dụ: nếu một thông báo RBM được gửi đến người dùng vào lúc 13:00 thứ Tư và người nhận không có mạng cho đến 9:00 Chủ Nhật, thì sự kiện này sẽ xuất hiện trong nhật ký hoạt động được tạo vào Chủ Nhật, nhưng dấu thời gian sẽ là 13:00 thứ Tư.
Câu hỏi thường gặp
Cuộc trò chuyện là gì?
Trong RBM, cuộc trò chuyện là một loạt tin nhắn được trao đổi giữa người dùng và một tác nhân trò chuyện trong khoảng thời gian 24 giờ. Chỉ những nhân viên hỗ trợ có danh mục thanh toán Cuộc trò chuyện mới có thể tạo cuộc trò chuyện và bị tính phí cho các sự kiện thanh toán này:
- Cuộc trò chuyện A2P: Cuộc trò chuyện do thương hiệu bắt đầu.
- Cuộc trò chuyện P2A: Cuộc trò chuyện do người dùng bắt đầu.
Cách hoạt động của cuộc trò chuyện
Bắt đầu: Một cuộc trò chuyện bắt đầu khi một bên (nhân viên hỗ trợ hoặc người dùng) phản hồi một tin nhắn của bên kia trong vòng 24 giờ kể từ khi nhận được tin nhắn đó, ngoài mọi cuộc trò chuyện hiện có.
- Cuộc trò chuyện A2P: Bắt đầu khi người dùng phản hồi tin nhắn của nhân viên hỗ trợ.
- Cuộc trò chuyện giữa người dùng và nhân viên hỗ trợ: Bắt đầu khi nhân viên hỗ trợ phản hồi tin nhắn của người dùng.
Cửa sổ trò chuyện: Cuộc trò chuyện vẫn hoạt động trong 24 giờ sau khi bắt đầu. Cuộc trò chuyện này bao gồm tất cả tin nhắn trong khoảng thời gian 24 giờ này, cũng như tin nhắn đầu tiên được trả lời ban đầu.
Thanh toán: Thay vì tính phí cho từng tin nhắn riêng lẻ, các trợ lý trò chuyện sẽ được tính phí dựa trên toàn bộ cuộc trò chuyện. Điều này có nghĩa là chi phí được liên kết với chuỗi cuộc trò chuyện, chứ không phải số lượng tin nhắn trong chuỗi đó.
Quan trọng:
Cuộc trò chuyện không áp dụng cho các trợ lý không có tính năng trò chuyện. Nhân viên hỗ trợ có danh mục thanh toán Tin nhắn cơ bản hoặc Tin nhắn đơn lẻ sẽ được tính phí theo tin nhắn, bất kể người dùng có trả lời hay không.
Đối với các trợ lý trò chuyện, quá trình tạo báo cáo sự kiện thanh toán và nhật ký hoạt động có thể bị trì hoãn tối đa 2 ngày. Độ trễ này cho phép RBM ghi lại tất cả tin nhắn trong một cuộc trò chuyện trước khi tính toán sự kiện thanh toán.