Trang này mô tả các tệp dữ liệu mà RCS cho Doanh nghiệp tạo ra để hỗ trợ nhà mạng trong việc thanh toán và kiểm tra. Hãy tham khảo Câu hỏi thường gặp về thông tin thanh toán để biết câu trả lời cho các câu hỏi thường gặp về mô hình thanh toán RCS cho Doanh nghiệp.
| 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ó tính phí giữa các tác nhân đã khởi chạy và người dùng. | Tất cả nhà mạng đang tích cực triển khai RCS cho doanh nghiệp. |
| Nhật ký hoạt động | Nhật ký dữ liệu thô về hoạt động của RCS dành cho doanh nghiệp, bao gồm cả các sự kiện có tính phí. | Những nhà mạng đang tích cực vận hành RCS cho doanh nghiệp 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 RCS cho Doanh nghiệp theo Giờ phối hợp quốc tế (UTC). Các tệp được tạo hằng ngày. 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 đàm thoại, 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 lúc 11:00 UTC ngày 5 tháng 5, thì báo cáo đó sẽ chứa dữ liệu từ 11:00 UTC ngày 4 tháng 5 đến 11:00 UTC ngày 5 tháng 5.
Đối với các tác nhân đàm thoại, 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 lúc 11:00 UTC ngày 5 tháng 5, thì báo cáo đó có thể chứa dữ liệu từ 11:00 UTC ngày 3 tháng 5 đến 11:00 UTC ngày 4 tháng 5.
Lý do dẫn đến sự chậm trễ này là do hoạt động RCS cho doanh nghiệp của các nhân viên hỗ trợ trò chuyện được liên kết với 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 RCS for Business 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ề nhân viên hỗ trợ trò chuyện, hãy tham khảo bài viết Danh mục tính phí cho nhân viên hỗ trợ.
Đ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.
Lưu giữ: Các tệp được lưu trữ tối đa 63 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á khi lưu trữ và trong quá trình truyền.
Để truy xuất tệp dữ liệu bằng Giao thức truyền tệp bảo mật (SFTP), hãy cung cấp khoá công khai SFTP của bạn. Để 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 thực hiện trên một số cổng cao (19321) để tăng cường bảo mật.
Bạn có thể sử dụng lệnh sau đây để 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 tài khoản ở 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 biệt để truy cập vào các loại báo cáo.
Khả năng cung cấp tệp
Nếu chưa có tệp dữ liệu nào được tạo, bạn sẽ thấy một lỗi SFTP tương tự như remote readdir("/"): No such file or directory. Đây là điều bình thường.
Hệ thống sẽ không tạo tệp nếu không có lưu lượng truy cập RCS cho doanh nghiệp để 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 để đơn giản hoá quy trình, hãy liên hệ với 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 về sự kiện thanh toán, được tính 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ả những nhà mạng đang tích cực vận hành RCS cho Doanh nghiệp đề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 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 cho nhân viên hỗ trợ đó dựa trên cách nhân viên hỗ trợ sẽ tương tác với người dùng. Danh mục tính phí 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 tính phí cho nhân viên hỗ trợ đối với 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ề các trường hợp sử dụng | Phương thức thanh toán |
|---|---|---|---|
Không liên quan đến hoạt động trò chuyện (Bao gồm các danh mục Tin nhắn cơ bản và Tin nhắn đơn lẻ. Lưu ý: Hiện tại, hai danh mục này không còn khác nhau nữa. Một tác nhân thuộc một trong hai danh mục sẽ được tính phí là tác nhân không đàm thoại.) |
Những tác nhân chủ yếu gửi tin nhắn một chiều. |
|
Tính phí cho mỗi tin nhắn được gửi đến người dùng. |
| Cuộc trò chuyện | Các trợ lý ảo được thiết kế để trao đổi qua lại với người dùng. |
|
Tính phí theo mỗi 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 lần trả lời đầu tiên), nhân viên hỗ trợ và người dùng có thể trao đổi bao nhiêu tin nhắn tuỳ ý và nhân viên hỗ trợ sẽ bị tính phí cố định cho cuộc trò chuyện. Tính phí theo từng tin nhắn: Nếu gửi một tin nhắn mà người dùng không trả lời trong vòng 24 giờ, thì tác nhân sẽ bị tính phí cho từng tin nhắn, tương tự như một tác nhân không đàm thoại. |
Sơ đồ sau đây minh hoạ ví dụ về một phiên tính phí A2P cho các tác nhân đàm thoại:
Nhân viên hỗ trợ trò chuyện và nhân viên hỗ trợ không trò chuyện
Có hai danh mục thanh toán chính: đàm thoại và không đàm thoại. Danh mục không đàm thoại bao gồm danh mục Tin nhắn cơ bản và Tin nhắn đơn lẻ, có chức năng giống nhau. Một tác nhân thuộc một trong hai danh mục này sẽ được tính phí là tác nhân không đàm thoại.
Điểm khác biệt chính trong các danh mục thanh toán là giữa các tác nhân đàm thoại và không đàm thoại:
Các tác nhân không đàm thoại sẽ bị 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 trợ lý ảo không cần phản hồi thường xuyên.
Các tác nhân đàm thoại được tính phí 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
Năm 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 tin nhắn A2P và P2A.
- A2P (Ứng dụng đến người dùng): Do doanh nghiệp 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 tác nhân không đàm thoại và đàm thoại.
| Sự kiện | Mô tả | Nhân viên hỗ trợ không 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ó độ dài từ 160 ký tự trở xuống. Nếu văn bản có chứa 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à đối tác không phải trả thêm phí. | 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 đó, tin nhắn sẽ trở thành một phần của a2p_conversation.
|
single_message
|
Tin nhắn A2P có nội dung đa dạng hoặc chỉ 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 đó, tin nhắn sẽ trở thành một phần của a2p_conversation.
|
a2p_conversation (do doanh nghiệp bắt đầu)
|
Được bắt đầu khi người dùng trả lời một tin nhắn A2P trong vòng 24 giờ kể từ khi nhận được tin nhắn đó, bên ngoài một cuộc trò chuyện hiện có. | Không có. Các tác nhân không đàm thoại sẽ không bao giờ tạo 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, thì chỉ tin nhắn A2P ngay trước tin nhắn P2A đượ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 gửi trong vòng 24 giờ tới đều thuộc a2p_conversation.
|
p2a_conversation (do người dùng tiến hành)
|
Đượ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 đó, bên ngoài một cuộc trò chuyện hiện có. | Không có. Các tác nhân không đàm thoại sẽ không bao giờ tạo 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, thì chỉ tin nhắn P2A ngay trước tin nhắn A2P đượ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 gửi trong vòng 24 giờ tiếp theo đều thuộc p2a_conversation.
|
p2a_message
|
Tin nhắn P2A thuộc mọi loại. | Luôn được coi là một sự kiện thanh toán riêng lẻ, bất kể nhân viên 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 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 các 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 nhân viên hỗ trợ (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 tác nhân không đàm thoại. Các tác nhân trong những danh mục tính phí này không tạo ra các sự kiện tính phí dựa trên cuộc trò chuyện (
a2p_conversationshoặcp2a_conversations). Thay vào đó, chúng tạo ra các sự kiện tính phí riêng lẻbasic_message,single_messagevàp2a_message.
Tạo báo cáo thanh toán
Chỉ những tác nhân có lưu lượng truy cập không phải của người kiểm thử mới tạo ra các sự kiện thanh toán. Hoạt động của số điện thoại kiểm thử 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 gửi, chứ không phải khi tin nhắn được gửi. Một thư không được gửi hoặc một thư bị huỷ trước khi gử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 duy nhất. 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 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 những thông tin sau 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 sự kiện đó được tạo. | 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 thanh toán 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 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 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 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
|
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ờ theo giờ UTC mà sự kiện bắt đầu ở định dạng ISO 8601 được làm tròn đến giờ gần nhất.
Tin nhắn A2P
Thông báo P2A
|
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 do thiết bị di động gửi (P2A) trong sự kiện. | 9
|
size_kilobytes
|
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 (1 kB = 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 mẫu về sự kiện thanh toán
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
Quy mô của báo cáo hằng ngày từ một đối tác RCS cho Doanh nghiệp đang hoạt động phụ thuộc vào mức độ hoạt động mà đối tác đó đã tạo trên mạng của nhà mạng. Ví dụ: nếu có 53.000 bản ghi trong báo cáo, thì tệp sẽ 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 RCS cho doanh nghiệp. Bạn có thể dùng các nhật ký này để kiểm tra sự kiện thanh toán và tạo sự kiện tuỳ chỉnh.
Lưu ý: Nhật ký hoạt động chỉ bao gồm lưu lượng truy cập từ số điện thoại không phải của người kiểm thử.
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à số điện thoại di động của người đăng ký, nên nhật ký này chỉ có sẵn khi nhà mạng 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 RCS cho doanh nghiệp trên mạng và bật hoạt động RCS bằng RCS của Google 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 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 cho từng hoạt động:
| Trường | Định dạng | Mô tả | Ví dụ: |
|---|---|---|---|
activity_id
|
chuỗi | Giá trị nhận dạng riêng biệ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 liên kết với một sự kiện thanh toán, chẳng hạn như text_message mà không có delivery_receipt_event tương ứng.
|
91yeb201-7c3b-412b-98d2-b0a0f7abe536
|
agent_id
|
chuỗi | Giá trị nhận dạng riêng biệt của nhân viên. | 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ờ sự kiện được gửi đến nền tảng RCS for Business ở đị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 được đí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 cho Doanh nghiệp. Đối với những sự kiện gử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 gửi.
Ví dụ: nếu một tin nhắn RCS cho doanh nghiệp được gửi cho người dùng vào lúc 13:00 thứ Tư và người nhận không truy cập 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, nhưng dấu thời gian sẽ là 13:00 thứ Tư.