RBM tạo các tệp dữ liệu báo cáo hoạt động của người dùng và nhân viên hỗ trợ ở cấp độ tóm tắt và giao dịch. Dữ liệu được phân tách thành nhiều tệp:
| Tệp | Nội dung mô tả | Những người có quyền truy cập |
|---|---|---|
| Báo cáo sự kiện thanh toán | Bản ghi các sự kiện có tính phí giữa nhân viên hỗ trợ và người dùng đã ra mắt | Tất cả các nhà mạng có lưu lượng truy cập RBM trên mạng của họ |
| Nhật ký hoạt động | Dữ liệu hoạt động thô trên nền tảng RBM | Các nhà mạng có lưu lượng truy cập RBM trên mạng của họ và bật hoạt động RCS với Jibe Cloud theo Điều khoản dịch vụ (ToS) của riêng họ |
Thế hệ
Báo cáo sự kiện thanh toán và Nhật ký hoạt động có độ trễ hai ngày để tạo.
Google chỉ báo cáo một sự kiện hoạt động khi phiên thanh toán chứa sự kiện đó hoàn tất. Một phiên có thể mất đến 24 giờ để hoàn tất và quy trình thanh toán của chúng tôi sẽ thực thi một lần mỗi ngày và chỉ báo cáo các phiên thanh toán chắc chắn đã hoàn tất (tức là có ít nhất 24 giờ).
Ví dụ:
Một thông báo được gửi vào ngày d và bắt đầu một phiên thanh toán, nhưng thông báo đó đã bỏ lỡ quá trình thực thi quy trình 1 giờ trước đó. Do đó, không có sự kiện hoạt động nào được báo cáo.
Khi quy trình chạy lại trên d+1, phiên mà thông báo bắt đầu chỉ diễn ra trong 23 giờ. Do đó, không có sự kiện hoạt động nào đối với thông báo này được báo cáo trên d+1.
Khi quy trình chạy lại trên d+2, phiên hoạt động đã hoàn tất nên sự kiện hoạt động sẽ được báo cáo cùng với phiên thanh toán.
Bộ nhớ và quyền truy cập
Các tệp dữ liệu được mã hoá khi lưu trữ và trong quá trình chuyển.
Để truy xuất tệp dữ liệu bằng SFTP, bạn cần cung cấp khoá công khai SFTP của mình. Để tạo khoá, hãy xem phần 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 có số cổng lớn (19321) để tăng cường tính bảo mật.
Bạn có thể dùng lệnh sau để truy cập vào các tệp dữ liệu của mình:
sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com
Google cung cấp tên người dùng 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.
Các tài khoản riêng biệt được cung cấp để 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 báo cáo nào được tạo, bạn sẽ thấy lỗi SFTP tương tự như remote readdir("/"): No such file or directory. Lỗi này như dự kiến.
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 tệp không được tạo. Hãy liên hệ theo địa chỉ rbm-support@google.com nếu bạn yêu cầu tạo tệp trống trong trường hợp này để đơn giản hoá quá trình xử lý.
Làm mới và giữ chân người dùng
Mỗi tệp dữ liệu thể hiện mức sử dụng nền tảng trong một ngày theo giờ UTC. Các bản ghi của một ngày nhất định sẽ được tạo một lần và được tổng kết trong vòng 2 ngày (48 giờ) sau khi ngày đó kết thúc. Nếu tải các tệp này vào kho dữ liệu, bạn có thể cập nhật các chỉ số của tháng hiện tại.
Tệp sẽ không được tạo nếu không có hoạt động nào cần tính đến.
Ngày trong tên của mỗi tệp là ngày mà tệp được tạo. Bản ghi trong tệp sẽ bao gồm ngày UTC 2 ngày trước ngày tệp.
Quá trình xuất tệp sẽ diễn ra trong khoảng từ 2 đến 4 giờ sáng (theo giờ PST).
Các tệp dữ liệu được lưu giữ trong tối đa 30 ngày trước khi bị xoá.
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ác sự kiện có thể lập hoá đơn được tính toán từ các thông báo cơ bản bằng cách sử dụng các đơn vị thanh toán được đề xuất. Các sự kiện có thể lập hoá đơn chứa thông tin bí mật, nhưng không có thông tin nhận dạng cá nhân (PII) của người dùng (ví dụ: không có 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).
Chỉ những nhân viên hỗ trợ đã ra mắt mới tạo sự kiện thanh toán. Hoạt động từ khi chưa ra mắt hoặc chưa ra mắt sẽ không xuất hiện trong báo cáo thanh toán.
Báo cáo thanh toán giả định rằng các sự kiện được lập hoá đơn khi gửi tin nhắn, chứ không phải khi tin nhắn được gửi. Việc thông báo chưa được gửi hoặc bị thu hồi trước khi gửi sẽ không kích hoạt sự kiện thanh toán.
Mỗi nhân viên hỗ trợ RBM có một Danh mục thanh toán, do nhà phát triển nhân viên hỗ trợ thiết lập trước khi gửi nhân viên hỗ trợ để ra mắt. Danh mục thanh toán xác định liệu thông báo mà nhân viên hỗ trợ gửi có rời rạc hay không hay có thể được kết hợp vào các sự kiện thanh toán trò chuyện hay không.
Có 5 loại sự kiện có thể lập hoá đơn:
| Sự kiện | Định nghĩa |
|---|---|
| Thông báo cơ bản | Thông báo giữa ứng dụng với người (A2P)
Chỉ dành cho tác nhân trò chuyện: nếu tin nhắn P2A được gửi dưới dạng tin nhắn phản hồi cho tin nhắn A2P trong vòng 24 giờ tiếp theo, thì Tin nhắn cơ bản sẽ trở thành một phần của cuộc trò chuyện A2P; nếu không, phiên hoạt động sẽ chấm dứt. Tin nhắn cơ bản luôn được gửi từ một nhân viên hỗ trợ đến người dùng. |
| Thông báo đơn lẻ | Thông báo giữa ứng dụng với người (A2P)
Chỉ dành cho tác nhân trò chuyện: nếu một tin nhắn P2A được gửi trong vòng 24 giờ tiếp theo, thì Tin nhắn duy nhất sẽ trở thành một phần của cuộc trò chuyện A2P; nếu không, phiên trò chuyện sẽ chấm dứt. Một Tin nhắn duy nhất luôn được gửi từ một nhân viên hỗ trợ đến người dùng. |
| Cuộc trò chuyện A2P | Chỉ áp dụng cho các nhân viên hỗ trợ trò chuyện: Cuộc trò chuyện A2P được bắt đầu khi tin nhắn P2A được gửi đi trong vòng 24 giờ kể từ Tin nhắn duy nhất A2P hoặc Tin nhắn cơ bản A2P. Xin lưu ý rằng nếu một thông báo P2A được gửi đi trong vòng 24 giờ kể từ khi có nhiều thông báo A2P được gửi đi, thì chỉ thông báo A2P xuất hiện ngay trước thông báo P2A mới được dùng để tạo phiên trò chuyện. Tin nhắn A2P này, cùng với mọi tin nhắn được gửi trong vòng 24 giờ tới, là một phần của cuộc trò chuyện mới với A2P. |
| Cuộc trò chuyện P2A | Chỉ áp dụng cho các nhân viên hỗ trợ trò chuyện: Cuộc trò chuyện P2A được bắt đầu khi không có phiên nào đang hoạt động (Tin nhắn đơn A2P, Cuộc trò chuyện A2P hoặc Cuộc trò chuyện P2A) và tin nhắn P2A được gửi đi và doanh nghiệp phản hồi trong vòng 24 giờ. |
| Thông báo P2A | Nhân viên hỗ trợ không trò chuyện: Thông báo P2A từ người dùng đến một nhân viên hỗ trợ có Danh mục thanh toán là Thông báo đơn hoặc Thông báo cơ bản.
Nhân viên hỗ trợ trò chuyện: Tin nhắn P2A được gửi từ người dùng tới một nhân viên hỗ trợ đang không có cuộc trò chuyện nào và nhân viên hỗ trợ không trả lời tin nhắn trả lời. |
Phạm vi áp dụng
Báo cáo sự kiện thanh toán có sẵn cho tất cả các nhà mạng có lưu lượng truy cập RBM trên mạng của họ.
Định dạng
Báo cáo sự kiện thanh toán sử dụng định dạng tên tệp YYYY/MM/DD/rbm_billable_events_YYYY-MM-DD.csv.
Ngày trong tên tệp là ngày tạo tệp. Các bản ghi trong tệp thường bao gồm hoạt động trong 2 ngày trước ngày này.
Các trường trong một bản ghi được phân tách bằng ký tự tab và mỗi dòng có một bản ghi.
Sẽ có một bản ghi cho mỗi sự kiện thanh toán, tức là 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 thanh toán.
Mỗi bản ghi trong báo cáo sự kiện có tính phí chứa thông tin sau cho từng sự kiện:
| Trường | Định dạng | Nội dung mô tả | Ví dụ: |
|---|---|---|---|
billing_event_id
|
string | 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. | |
type
|
string | Loại sự kiện:
|
single_message
|
agent_id
|
string | Mã nhận dạng của nhân viên hỗ trợ đã tham gia sự kiện. | rbm-welcome-bot@rbm.goog
|
agent_owner
|
string | Email của chủ sở hữu của nhân viên hỗ trợ đã tham gia sự kiện. Đây là bên đã đăng ký tác nhân RBM, trong hầu hết các trường hợp là đơn vị tập hợp, nhưng trong một số ít trường hợp, đó có thể là thương hiệu. Giá trị này được lấy từ trường "Tài khoản Google RBM" được cung cấp khi nhà phát triển đăng ký sử dụng RBM. | name@aggregator.com
|
billing_party
|
string | Bên lập hoá đơn cho các sự kiện.
|
carrier
|
max_duration_single_message
|
number | Khoảng thời gian (tính bằng giờ) để xác định một phiên tin nhắn của nhân viên hỗ trợ mà không nhận được phản hồi. | 24
|
max_duration_a2p_conversation
|
number | Thời lượng tối đa của một phiên A2P, tính bằng giờ. Được đo từ lần 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
|
number | Thời lượng tối đa của phiê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ờ UTC mà sự kiện bắt đầu ở định dạng ISO 8601, được làm tròn thành giờ gần nhất.
|
2019-07-25T08:00:00Z
|
duration
|
number | Thời lượng của 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
|
number | Số lượng tin nhắn bị chấm dứt trên thiết bị di động trong sự kiện. | 11
|
mo_messages
|
number | Số lượng thông báo bắt nguồn từ thiết bị di động trong sự kiện. | 9
|
size_kilobytes
|
number | Kích thước của mọi tệp đính kèm thư trong sự kiện, được làm tròn đến kilobyte gần nhất (1kB = 1024 byte). | 912
|
agent_name
|
string |
Nhân viên hỗ trợ đã tham gia sự kiện. |
XYZ Mobile USA
|
owner_name
|
string | Chủ sở hữu của nhân viên hỗ trợ đã tham gia sự kiện. Đây là bên đã đăng ký nhân viên hỗ trợ RBM. Trong hầu hết các trường hợp, đó là đơn vị tổng hợp, nhưng trong một số ít trường hợp, đó có thể là thương hiệu. Giá trị này được lấy từ "Tên hiển thị ưu tiên cho tài khoản đối tác" mà bạn cung cấp khi nhà phát triển đăng ký sử dụng RBM. | XYZ Mobile
|
Tệp mẫu
Bạn có thể tải xuống tệp báo cáo thanh toán mẫu.
Kích thước tệp thông thường
Một tệp báo cáo hằng ngày của một đối tác đang hoạt động có thể có khoảng 53.000 bản ghi với kích thước khoảng 8 MB.
Nhật ký hoạt động
Nhật ký hoạt động là nhật ký dữ liệu thô về hoạt động trên nền tảng RBM để kiểm tra các sự kiện có tính phí và tạo sự kiện tuỳ chỉnh.
Phạm vi áp dụng
Nhật ký hoạt động chỉ được cung cấp cho những nhà mạng có lưu lượng truy cập RBM trên mạng của họ và bật hoạt động RCS với Jibe Cloud theo Điều khoản dịch vụ (ToS) của riêng họ. Nếu sử dụng Jibe Cloud theo điều khoản dịch vụ (ToS) của Jibe, 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 dùng định dạng tên tệp YYYY/MM/DD/rbm_activity_YYYY-MM-DD.csv.
Ngày trong tên tệp là ngày tạo tệp. Các bản ghi trong tệp thường bao gồm hoạt động trong 2 ngày trước ngày này.
Các trường trong một bản ghi được phân tách bằng ký tự 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 từng sự kiện hoạt động.
| Trường | Định dạng | Nội dung mô tả | Ví dụ: |
|---|---|---|---|
activity_id
|
string | Giá trị nhận dạng của hoạt động. | |
billing_event_id
|
string | Mã nhận dạng cho sự kiện thanh toán mà hoạt động này diễn ra. Có thể để trống nếu hoạt động không liên kết với bất kỳ phiên nào, chẳng hạn như text_message mà không có delivery_receipt_event tương ứng.
| |
agent_id
|
string | Giá trị nhận dạng của nhân viên hỗ trợ. | welcome-bot@rbm.goog
|
user_id
|
string | MSISDN của người dùng. | 918369110173
|
direction
|
string | Hướng gửi thư:
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | Ngày/giờ UTC mà sự kiện được gửi đến nền tảng RBM. Xem ghi chú bên dưới. | 2019-07-25T00:29:07.033Z
|
type
|
string | Loại hoạt động:
|
text_message
|
size_bytes
|
string | Kích thước của các tệp được đính kèm vào hoạt động, tính bằng byte. | 912
|
Lưu ý về dấu thời gian
Dấu thời gian trong Nhật ký hoạt động ghi lại thời gian 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 vào Nhật ký hoạt động cho đến khi thông báo được gửi đi.
Ví dụ: nếu thư RBM được gửi đến người dùng lúc 13:00 thứ Tư và người nhận không kết nối mạng cho đến 9:00 Chủ Nhật, thì sự kiện đó sẽ xuất hiện trong Nhật ký hoạt động được tạo cho Chủ Nhật. Dấu thời gian của sự kiện trong Nhật ký hoạt động sẽ là 13:00 thứ Tư.