Trang này mô tả các tệp dữ liệu mà RCS for Business tạo ra để hỗ trợ nhà mạng trong việc thanh toán và kiểm tra.
| Tệp | Mô tả | Người có quyền truy cập |
|---|---|---|
| Báo cáo thanh toán | Báo cáo tổng hợp về các sự kiện có 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 đ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ó tính phí. | Những nhà mạng đang tích cực vận hành RCS for Business 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ọ. |
RCS for Business sử dụng hai mô hình thanh toán: mô hình thanh toán tiêu chuẩn cho lưu lượng truy cập bên ngoài Hoa Kỳ và mô hình thanh toán ở Hoa Kỳ cho lưu lượng truy cập ở Hoa Kỳ. Thông tin riêng biệt cho mô hình tiêu chuẩn hoặc mô hình ở Hoa Kỳ (ví dụ: các phân loại sự kiện có tính phí hoặc trường báo cáo khác nhau) được ghi chú rõ ràng.
- Để biết thông tin chi tiết về mô hình thanh toán tiêu chuẩn và bản tóm tắt về sự khác biệt giữa các mô hình thanh toán, hãy tham khảo phần Câu hỏi thường gặp về việc thanh toán.
- Để biết thông tin chi tiết về các phân loại thanh toán tại Hoa Kỳ, hãy tham khảo hướng dẫn về mô hình thanh toán tại Hoa Kỳ.
Tạo tệp
Mỗi tệp dữ liệu biểu thị một ngày sử dụng RCS for Business theo Giờ chuẩn Thái Bình Dương (PST). Các tệp đượ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 tất 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 ngày tệp được tạo. Ví dụ: báo cáo được tạo vào ngày 5 tháng 5 sẽ 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 đà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ụ: báo cáo được tạo vào ngày 5 tháng 5 sẽ bao gồm dữ liệu trong 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 dẫn đến sự chậm trễ này là vì hoạt động RCS for Business của các nhân viên hỗ trợ trò chuyện được liên kết với các phiên hoạt động. Các phiên này có thể mất đến 24 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 có tính phí. Để 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: Theo mặc định, 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 sử dụng, hãy liên hệ với rbm-support@google.com.
- Đặ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ể 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 để 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 tệp trống để đơn giản hoá quy trì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 về các sự kiện có tính phí, đượ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 thanh toán.
Báo cáo thanh toán chứa thông tin 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 đã 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 tác nhân, chủ sở hữu sẽ đặt danh mục thanh toán cho tác nhân dựa trên cách tác nhân sẽ 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 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 | 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. |
| Trò chuyện | Các tác nhân đượ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ợ đàm thoại và nhân viên hỗ trợ không đàm thoại
Có 2 danh mục thanh toán chính: đàm thoại và 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 tác nhân tham gia vào các cuộc trò chuyện nhiều lượt với người dùng.
Sự kiện có thể lập hóa đơn
Có 5 loại sự kiện có thể tính phí được ghi lại trong báo cáo thanh toán. Các sự kiện này bao gồm 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 (Mobile Terminated): Tin nhắn do doanh nghiệp gửi.
- P2A (Người dùng đến ứng dụng) là MO (Mobile Originated): Một thông báo hoặc hành động do người dùng bắt đầu.
Bảng sau đây mô tả từng sự kiện có tính phí khi áp dụng cho các tác nhân không đàm thoại và đàm thoại.
| Sự kiện | Mô tả | Tác nhân không liên quan đến hoạt động trò chuyện | Nhân viên hỗ trợ đàm thoại |
|---|---|---|---|
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 riêng lẻ có tính phí, bất kể người dùng có trả lời hay không. | Được coi là một sự kiện riêng lẻ có tính phí, 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 riêng lẻ có tính phí, bất kể người dùng có trả lời hay không. | Được coi là một sự kiện riêng lẻ có tính phí, 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 tin nhắn A2P trong vòng 24 giờ kể từ khi nhận được tin nhắ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 riêng lẻ có tính phí, bất kể tác nhân có trả lời hay không. | Được coi là một sự kiện có tính phí riêng lẻ, trừ phi nhân viên hỗ trợ trả lời trong vòng 24 giờ. |
Danh mục thanh toán so với sự kiện có thể lập hoá đơn
Sự khác biệt giữa danh mục thanh toán của trợ lý và sự kiện có tính phí là yếu tố then chốt để hiểu cách trợ lý của bạn được tính phí.
- Danh mục thanh toán là một phân loại cố định mà bạn chọn khi tạo tác nhân. Tham số này xác định phương thức tính phí cho tác nhân của bạn: theo mỗi tin nhắn (Tác nhân không đàm thoại) hoặc theo mỗi cuộc trò chuyện (Tác nhân đàm thoại).
- Sự kiện có tính phí là những lượt tương tác giữa một tác nhân doanh nghiệp RCS for Business và người dùng được theo dõi cho mục đích thanh toán (ví dụ:
basic_message,single_message,a2p_conversation).
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 có thể lập hoá đơ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 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 có 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 có tính phí. Các trường trong một bản ghi được phân tách bằng ký tự tab. Ví dụ: 2 cuộc trò chuyện A2P có cùng một nhân viên hỗ trợ sẽ tạo ra 2 sự kiện riêng biệt có tính phí và 2 bản ghi trong báo cáo 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 có tính phí.
| Trường | Định dạng | Nội dung mô tả | Ví dụ: |
|---|---|---|---|
billing_event_id
|
chuỗi | Mã nhận dạng được tạo để phân biệt sự kiện có thể lập hoá đơn. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
|
type
|
chuỗi | Loại sự kiện:
Mô hình thanh toán tiêu chuẩn Mô hình thanh toán ở Hoa Kỳ |
single_message
|
agent_id
|
chuỗi | Giá trị nhận dạng riêng biệt của nhân viê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.
Giá trị này là 0 cho mọi sự kiện không phải là sự kiện trò chuyện. |
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 tác nhân được tạo. | XYZ Mobile
|
segment_count
|
số | Chỉ áp dụng mô hình thanh toán ở Hoa Kỳ
Số lượng phân khúc được tính cho sự kiện |
5
|
Báo cáo thanh toán mẫu
Bạn có thể tải báo cáo mẫu xuống:
- Báo cáo thanh toán cho mô hình thanh toán tiêu chuẩn
- Báo cáo thanh toán cho mô hình thanh toán tại Hoa Kỳ
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à họ đã 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 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ó tính phí 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à 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 đ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 RCS for Business trên mạng của mình 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 | Nội dung 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 riêng biệt của sự kiện có thể tính phí đượ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 có tính phí, 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 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 đượ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 for Business đượ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ư.