Trang này mô tả các tập tin dữ liệu mà RCS for Business tạo ra để hỗ trợ các công ty bảo hiểm trong việc lập hóa đơn và kiểm toán.
| Tài liệu | Sự miêu tả | Ai có quyền truy cập |
|---|---|---|
| Báo cáo thanh toán | Báo cáo tổng hợp các sự kiện tính phí giữa các tác nhân đã được khởi chạy và người dùng. | Tất cả các hãng vận tải hiện đang tích cực vận hành RCS for Business. |
| Nhật ký hoạt động | Nhật ký dữ liệu thô về hoạt động của RCS for Business, bao gồm cả các sự kiện có thể lập hóa đơn. | Các nhà mạng đang tích cực vận hành RCS for Business và vận hành Dịch vụ Google RCS theo Điều khoản dịch vụ (ToS) riêng của họ. |
RCS for Business sử dụng mô hình thanh toán tiêu chuẩn cho lưu lượng truy cập ngoài Hoa Kỳ. Để biết thêm chi tiết, vui lòng tham khảo Câu hỏi thường gặp về thanh toán .
Tạo tập tin
Mỗi tập dữ liệu thể hiện hoạt động sử dụng RCS for Business trong một ngày theo múi giờ Thái Bình Dương (PST). Các tập dữ liệu được tạo hàng ngày và phản ánh hoạt động trong khoảng thời gian 24 giờ trước đó (từ nửa đêm đến nửa đêm). Quá trình tạo có thể mất vài giờ và thời gian hoàn thành có thể khác nhau.
- Đối với các tác nhân không có khả năng hội thoại , các tệp này chứa dữ liệu từ khoảng thời gian 24 giờ ngay trước ngày tệp được tạo. Ví dụ, một báo cáo được tạo vào ngày 5 tháng 5 bao gồm dữ liệu từ 00:00 ngày 4 tháng 5 đến 00:00 ngày 5 tháng 5. Thời gian được chỉ định là theo múi giờ PST.
Đối với các tác nhân hội thoại , các tệp này chứa dữ liệu từ khoảng thời gian 24 giờ, tức là từ 1-2 ngày trước thời điểm tạo tệp. Ví dụ, một báo cáo được tạo vào ngày 5 tháng 5 bao gồm dữ liệu từ khoảng thời gian 24 giờ của ngày 2 tháng 5 hoặc ngày 3 tháng 5. Thời gian được chỉ định là theo múi giờ PST.
Lý do của sự chậm trễ là hoạt động RCS for Business dành cho các trợ lý hội thoại được liên kết với các phiên, có thể mất đến 24 giờ để hoàn tất. Sự chậm trễ này cho phép RCS for Business ghi lại tất cả các tin nhắn trong một cuộc hội thoại trước khi tính toán sự kiện có thể lập hóa đơn. Để biết thêm thông tin về trợ lý hội thoại, hãy tham khảo mục Danh mục lập hóa đơn của trợ lý .
Những điểm chính:
- Không có hoạt động : Theo mặc định, sẽ không có tệp nào được tạo 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. Tuy nhiên, bạn có thể chọn nhận các tệp trống nếu cần. Để chọn tham gia, hãy liên hệ với rbm-support@google.com.
- Lưu ý khi đặt tên : Ngày tháng trong tên tập tin là ngày tạo tập tin, không phải ngày tháng của dữ liệu bên trong.
- Thời gian lưu trữ : Các tệp được lưu trữ tối đa 63 ngày trước khi bị xóa.
Bạn có thể sử dụng các tệp này để cập nhật kho dữ liệu của mình với các số liệu sử dụng nền tảng mới nhất.
Lưu trữ và truy cập tệp
Các tập tin dữ liệu được mã hóa khi lưu trữ và trong quá trình truyền tải.
Để truy xuất các tập tin dữ liệu bằng Giao thức truyền tải tập tin an toàn (SFTP), hãy cung cấp khóa công khai SFTP của bạn. Để tạo khóa, hãy xem Tạo cặp khóa Shell an toàn (SSH) cho hộp thư SFTP .
Máy chủ SFTP là partnerupload.google.com và kết nối được thực hiện trên cổng có số hiệu cao (19321) để tăng cường bảo mật.
Bạn có thể sử dụng lệnh sau để truy cập 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.
Mỗi người dùng được cung cấp một tài khoản riêng để truy cập các loại báo cáo khác nhau.
Tính khả dụng 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 , điều này là bình thường.
Tệp sẽ không được tạo nếu không có lưu lượng truy cập RCS for Business nào để báo cáo. Điều này có nghĩa là có thể có một số ngày không có tệp nào được tạo. Nếu bạn cần các tệp trống để tối ưu hóa quy trình của mình, hãy liên hệ với nhóm hỗ trợ RCS for Business .
Báo cáo thanh toán
Báo cáo thanh toán là bản ghi các sự kiện có thể lập hóa đơn , được tính toán dựa trên hạng mục thanh toán của đại lý và loại tin nhắn mà đại lý gửi. Báo cáo thanh toán có sẵn cho tất cả các nhà mạng đang sử dụng RCS for Business.
Báo cáo thanh toán chứa thông tin bảo mật, nhưng không chứa Thông tin nhận dạng cá nhân (PII) của người dùng, chẳng hạn như MSISDN, MSISDN được mã hóa hoặc bất kỳ mã định danh duy nhất nào của người dùng.
Danh mục thanh toán của đại lý
Khi tạo một agent, chủ sở hữu sẽ thiết lập hạng mục thanh toán dựa trên cách agent tương tác với người dùng. Hạng mục thanh toán không giới hạn số lượng hoặc loại tin nhắn mà agent có thể gửi. Tuy nhiên, nó sẽ xác định cách agent bị tính phí cho các tin nhắn đó. Hai hạng mục thanh toán chính được mô tả trong bảng sau.
| Danh mục thanh toán | Loại tác nhân | Ví dụ về các trường hợp sử dụng | Phương thức thanh toán |
|---|---|---|---|
| Không phải hội thoại | Các tác nhân chủ yếu gửi tin nhắn một chiều. |
| Tính phí dựa trên mỗi tin nhắn được gửi đến người dùng. |
| Đàm thoại | Các tác nhân được thiết kế để trao đổi thông tin qua lại với người dùng. |
| Tính phí theo từng 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ờ, một cuộc trò chuyện sẽ bắt đầu. Trong khoảng thời gian diễn ra cuộc trò chuyện (24 giờ sau lần trả lời đầu tiên), nhân viên hỗ trợ và người dùng có thể trao đổi bất kỳ số lượng tin nhắn nào, và nhân viên hỗ trợ sẽ bị tính phí theo mức giá cố định cho cuộc trò chuyện đó. Tính phí theo từng tin nhắn : Nếu nhân viên hỗ trợ gửi tin nhắn mà người dùng không trả lời trong vòng 24 giờ, nhân viên đó sẽ bị tính phí cho tin nhắn đó, tương tự như nhân viên hỗ trợ không tham gia hội thoại. |
Sơ đồ sau đây minh họa một ví dụ về phiên thanh toán A2P dành cho các trợ lý hội thoại:
Tác nhân hội thoại so với tác nhân không hội thoại
Có hai loại tính phí chính: tính phí dựa trên hội thoại và tính phí không dựa trên hội thoại.
Điểm khác biệt chính trong các hạng mục tính phí nằm ở sự khác biệt giữa trợ lý hội thoại và trợ lý không hội thoại:
Các trợ lý ảo không tham gia hội thoại sẽ bị tính phí cho mỗi tin nhắn mà chúng gửi đến người dùng.
- Danh mục này phù hợp nhất cho những người môi giới không mong đợi nhận được phản hồi thường xuyên.
Các trợ lý hội thoại được tính phí theo mức giá cố định cho mỗi cuộc hội thoại , bao gồm tất cả các tin nhắn được trao đổi trong vòng 24 giờ.
- Danh mục này phù hợp nhất cho các nhân viên hỗ trợ tham gia vào các cuộc hội thoại nhiều lượt với người dùng.
Sự kiện có thể tính phí
Báo cáo thanh toán ghi lại năm loại sự kiện có thể lập hóa đơn. Các sự kiện này bao gồm các sự kiện MT và MO, được gọi là sự kiện A2P và P2A.
- A2P (Ứng dụng-đến-Người dùng) là MT (Kết thúc trên thiết bị di động) : Một tin nhắn được gửi bởi doanh nghiệp.
- P2A (Person-to-Application) là MO (Mobile Originated) : Một tin nhắn hoặc hành động được người dùng khởi xướng.
Bảng sau đây mô tả từng sự kiện tính phí áp dụng cho cả tác nhân không hội thoại và tác nhân hội thoại.
| Sự kiện | Sự miêu tả | Các tác nhân không tham gia hội thoại | Các tác nhân hội thoại |
|---|---|---|---|
basic_message | Tin nhắn A2P chỉ bao gồm 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ó gắn thẻ openGraph , tin nhắn 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 xử lý như một sự kiện riêng biệt có tính phí, bất kể người dùng có trả lời hay không. | Được xử lý như một sự kiện tính phí riêng lẻ, trừ khi người dùng trả lời trong vòng 24 giờ. Trong trường hợp đó, tin nhắn sẽ trở thành một phần của cuộc hội thoại a2p_conversation . |
single_message | Tin nhắn A2P có thể chứa nội dung phong phú hoặc chỉ là tin nhắn văn bản thuần túy với hơn 160 ký tự. | Luôn được xử lý như một sự kiện riêng biệt có tính phí, bất kể người dùng có trả lời hay không. | Được xử lý như một sự kiện tính phí riêng lẻ, trừ khi người dùng trả lời trong vòng 24 giờ. Trong trường hợp đó, tin nhắn sẽ trở thành một phần của cuộc hội thoại a2p_conversation . |
a2p_conversation (do doanh nghiệp khởi xướng) | Sự kiện này được khởi tạo khi người dùng phản hồi tin nhắn A2P trong vòng 24 giờ kể từ khi nhận được tin nhắn, ngoài phạm vi cuộc trò chuyện hiện có. | Không áp dụng. Các tác nhân không tham gia hội thoại không bao giờ tạo ra loại sự kiện này. | Nếu một tin nhắn P2A được gửi trong vòng 24 giờ sau nhiều tin nhắn A2P, chỉ tin nhắn A2P được gửi ngay trước tin nhắn P2A mới được sử dụng để bắt đầu cuộc hội thoại. Tin nhắn A2P này, và bất kỳ tin nhắn nào được gửi trong vòng 24 giờ tiếp theo, đều là một phần của cuộc a2p_conversation . |
p2a_conversation (do người dùng khởi xướng) | Sự kiện này được khởi tạo khi một nhân viên phản hồi tin nhắn P2A trong vòng 24 giờ kể từ khi nhận được tin nhắn đó, ngoài phạm vi cuộc trò chuyện hiện có. | Không áp dụng. Các tác nhân không tham gia hội thoại không bao giờ tạo ra loại sự kiện này. | Nếu một tin nhắn A2P được gửi trong vòng 24 giờ sau nhiều tin nhắn P2A, chỉ tin nhắn P2A được gửi ngay trước tin nhắn A2P mới được sử dụng để bắt đầu cuộc hội thoại. Tin nhắn P2A này, và bất kỳ tin nhắn nào được gửi trong vòng 24 giờ tiếp theo, đều là một phần của cuộc p2a_conversation . |
p2a_message | Tin nhắn P2A thuộc bất kỳ loại nào. | Luôn được xử lý như một sự kiện riêng biệt có tính phí, bất kể nhân viên có trả lời hay không. | Được xử lý như một sự kiện riêng lẻ cần lập hóa đơn, trừ khi đại lý phản hồi trong vòng 24 giờ. |
Các danh mục thanh toán so với các sự kiện có thể lập hóa đơn
Việc phân biệt giữa các hạng mục thanh toán cho đại lý và các sự kiện có thể lập hóa đơn là chìa khóa để hiểu cách thức đại lý của bạn được lập hóa đơn.
- Loại hình thanh toán là một phân loại cố định mà bạn chọn khi tạo nhân viên hỗ trợ. Nó xác định phương thức thanh toán cho nhân viên của bạn: theo tin nhắn (nhân viên không tham gia hội thoại) hoặc theo cuộc hội thoại (nhân viên tham gia hội thoại).
- Các sự kiện có thể tính phí là các tương tác giữa tác nhân RCS for Business và người dùng được theo dõi cho mục đích tính phí (ví dụ:
basic_message,single_message,a2p_conversation).
Tạo báo cáo thanh toán
Chỉ những cuộc gọi từ các số điện thoại không phải là số thử nghiệm mới tạo ra các sự kiện tính phí. Hoạt động từ các số điện thoại thử nghiệm không xuất hiện trong báo cáo thanh toán.
Các báo cáo này giả định rằng sự kiện được tính phí khi tin nhắn được gửi đi, chứ không phải khi tin nhắn được gửi. Tin nhắn không được gửi hoặc tin nhắn bị hủy trước khi gửi sẽ không kích hoạt sự kiện tính phí.
Định dạng báo cáo thanh toán
Báo cáo 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 tính phí riêng lẻ. Các trường trong một bản ghi được phân tách bằng dấu tab. Ví dụ, hai cuộc hội thoại A2P với cùng một nhân viên sẽ tạo ra hai sự kiện tính phí riêng biệt và hai bản ghi trong báo cáo thanh toán.
Mỗi mục trong báo cáo chứa các thông tin sau đây cho mỗi sự kiện có thể lập hóa đơn.
| Cánh đồng | Định dạng | Sự miêu tả | Ví dụ |
|---|---|---|---|
billing_event_id | sợi dây | Mã định danh được tạo ra để phân biệt sự kiện cần lập hóa đơn. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff |
type | sợi dây | Loại sự kiện:
| single_message |
agent_id | sợi dây | Mã định danh duy nhất cho đại lý đã tham gia sự kiện. | rbm-welcome-bot@rbm.goog |
agent_owner | sợi dây | Địa chỉ email của chủ sở hữu hiện tại của tài khoản đối tác nơi đại lý được tạo ra. | name@aggregator.com |
billing_party | sợi dây | Bên chịu trách nhiệm lập hóa đơn cho các sự kiện.
| carrier |
max_duration_single_message | con số | Thời gian tối đa (tính bằng giờ) cho phép người dùng phản hồ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 lại và tin nhắn được phân loại là sự kiện single_message . | 24 |
max_duration_a2p_conversation | con số | Thời lượng tối đa của một cuộc hội thoại A2P, tính bằng giờ. Được đo từ phản hồi đầu tiên của người dùng đối với tin nhắn ban đầu của nhân viên hỗ trợ. | 24 |
max_duration_p2a_conversation | con số | Thời lượng tối đa của một cuộc trò chuyện P2A, tính bằng giờ. Được đo 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 theo định dạng ISO 8601, được làm tròn đến giờ gần nhất. Tin nhắn A2P
Tin nhắn P2A
| 2019-07-25T08:00:00Z |
duration | con số | Thời lượng sự kiện, làm tròn đến phút gần nhất. Giá trị bằng 0 đối với bất kỳ sự kiện nào không liên quan đến hội thoại. | 45 |
mt_messages | con số | Số lượng tin nhắn kết thúc ở thiết bị di động (A2P) trong sự kiện. | 11 |
mo_messages | con số | Số lượng tin nhắn được gửi từ thiết bị di động (P2A) trong sự kiện. | 9 |
size_kilobytes | con số | Kích thước của tất cả các tệp đính kèm vào tin nhắn trong sự kiện, được làm tròn đến kilobyte gần nhất (1kB bằng 1024 byte). | 912 |
agent_name | sợi dây | Tên của người đại diện đã tham gia sự kiện. | XYZ Mobile USA |
owner_name | sợi dây | Tên của chủ sở hữu hiện tại của tài khoản đối tác nơi đại lý được tạo ra. | XYZ Mobile |
Mẫu báo cáo thanh toán
Bạn có thể tải xuống các mẫu báo cáo sau:
Kích thước tệp điển hình
Kích thước của báo cáo hàng ngày từ đối tác RCS for Business đang hoạt động phụ thuộc vào lượng hoạt động mà họ đã tạo ra trên mạng lưới của nhà mạng. Ví dụ, nếu có 53.000 bản ghi trong báo cáo, tệp sẽ có kích thước xấp xỉ 8Mb.
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 RCS for Business. Bạn có thể sử dụng các nhật ký này để kiểm tra các sự kiện có thể lập hóa đơn và tạo các sự kiện tùy 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 chúng chỉ khả dụng khi nhà mạng đang vận hành RCS theo Điều khoản Dịch vụ riêng của họ. Nếu bạn có lưu lượng RCS dành cho Doanh nghiệp trên mạng của mình và bật hoạt động RCS với Google RCS theo Điều khoản Dịch vụ của Google, 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 chứa một bản ghi.
Mỗi bản ghi trong nhật ký hoạt động chứa các trường sau cho mỗi hoạt động:
| Cánh đồng | Định dạng | Sự miêu tả | Ví dụ |
|---|---|---|---|
activity_id | sợi dây | Mã định danh duy nhất cho hoạt động. | b422e1d3-ac99-442a-853d-a875d5e61762 |
billing_event_id | sợi dây | Mã định danh duy nhất cho sự kiện có thể lập hóa đơn liên quan. Có thể để trống nếu hoạt động không được liên kết với sự kiện có thể lập hóa đơn, chẳng hạn như tin text_message mà không có delivery_receipt_event tương ứng. | 91yeb201-7c3b-412b-98d2-b0a0f7abe536 |
agent_id | sợi dây | Mã định danh duy nhất cho tác nhân. | welcome-bot@rbm.goog |
user_id | sợi dây | MSISDN của người dùng. | 918369110173 |
direction | sợi dây | Hướng gửi tin nhắn:
| MT |
time | YYYY-mm-ddTHH:MM:SS.SSSZ | Ngày và giờ sự kiện được gửi đến nền tảng RCS for Business theo định dạng UTC. Xem mục Dấu thời gian . | 2019-07-25T00:29:07.033Z |
type | sợi dây | Loại hoạt động:
| text_message |
size_bytes | sợi dây | 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 RCS for Business. Đối với các sự kiện gửi nội dung đến người dùng, sự kiện đó sẽ không được ghi lại trong nhật ký hoạt động cho đến khi tin nhắn được gửi đi.
Ví dụ, nếu một tin nhắn RCS for Business được gửi đến người dùng vào thứ Tư lúc 13:00, và người nhận ngoại tuyến cho đến Chủ nhật lúc 9:00, sự kiện sẽ xuất hiện trong nhật ký hoạt động được tạo cho Chủ nhật, nhưng dấu thời gian sẽ là thứ Tư, 13:00.