Báo cáo thanh toán của đối tác

Các đối tác sẽ nhận được báo cáo thanh toán tóm tắt, trong đó cung cấp số lượng tổng hợp hằng ngày của các sự kiện có tính phí, được nhóm theo nhân viên hỗ trợ, loại sự kiện và hãng vận chuyển. Đây là thông tin tóm tắt cấp cao về tất cả lưu lượng truy cập có tính phí, cung cấp cho bạn thông tin phân tích có giá trị và thông tin cần thiết về dữ liệu lưu lượng truy cập.

Tạo và truy cập vào tệp

Báo cáo được tạo hằng ngày ở định dạng CSV và được phân phối bằng Dịch vụ SFTP của Google.

Quyền truy cập SFTP

Quyền truy cập vào các báo cáo này được bảo vệ bằng cặp khoá công khai/riêng tư. Thông tin đăng nhập SFTP đảm bảo quyền truy cập an toàn và riêng biệt.

Cách lấy quyền truy cập SFTP

Để nhận báo cáo thanh toán, trước tiên, bạn phải thiết lập thông tin đăng nhập SFTP:

1. Tạo cặp khoá SSH: Làm theo hướng dẫn để tạo cặp khoá Secure Shell (SSH) cho tài khoản đăng SFTP.
2. Bắt đầu tham gia: Nếu bạn muốn nhận báo cáo đối tác, hãy liên hệ với người đại diện doanh nghiệp của Google hoặc người liên hệ chính của bạn tại Google. Họ sẽ hướng dẫn bạn quy trình thiết lập và đăng ký ban đầu cho tài khoản đối tác để báo cáo thông tin thanh toán.
3. Gửi khoá công khai: Cung cấp khoá công khai (tệp PUB) cho người liên hệ của bạn tại Google. Sau đó, Google sẽ cung cấp tài khoản cho bạn, chỉ định <partner_id> duy nhất cho bạn và thông báo cho bạn khi bạn có thể truy cập.

4. Truy cập vào máy chủ: Sau khi nhận được thông báo, bạn có thể truy cập vào báo cáo của mình trên máy chủ SFTP tại partnerupload.google.com bằng cổng 19321. Sử dụng lệnh sau để kết nối:

   sftp -i <path_to_private_key> -P 19321 rbmreports-partner-<partner_id>@partnerupload.google.com
   

Quy ước đặt tên tệp

Tất cả báo cáo của hãng vận chuyển đều được chia theo từng hãng vận chuyển.

Cấu trúc đặt tên thư mục và tệp như sau:

rbmreports-partner-<partner_id>/
  <YYYY>/<MM>/<DD>/
     summary_<short_carrier_id>/
        summary_<short_carrier_id>_<YYYY-MM-DD>.csv
     ...
     <prefix>_<short_carrier_id>/
        <prefix>_<short_carrier_id>_<YYYY-MM-DD>.csv

<prefix> xác định loại báo cáo cụ thể được gửi.

Các tiền tố tiêu chuẩn bao gồm:

Loại báo cáo	Tiền tố tên tệp
Báo cáo tóm tắt	summary

Bạn có thể tuỳ ý thêm một tiền tố tên tệp tuỳ chỉnh khác nếu có nhiều báo cáo cho cùng một hãng vận chuyển và đối tác (ví dụ: trong quá trình di chuyển định dạng). Bạn phải luôn quét đệ quy tất cả các tệp trong thư mục có ngày.

Cấu trúc báo cáo CSV

Các phần sau đây xác định các trường, định dạng dữ liệu và định nghĩa cột được dùng trong báo cáo thanh toán của đối tác.

Nếu bạn có câu hỏi khác, hãy liên hệ với nhà mạng.

Định dạng báo cáo tóm tắt

Trường	Định dạng	Nội dung mô tả	Ví dụ
type	chuỗi	Loại sự kiện thanh toán	a2p_session
agent_id	chuỗi	Mã nhận dạng duy nhất của nhân viên hỗ trợ	[e-mail]
agent_name	chuỗi	Tên của nhân viên đã tham gia sự kiện	ACME Brand
carrier_id	chuỗi	Mã nhận dạng nhà mạng cho lưu lượng truy cập	super-carrier
carrier_name	chuỗi	Tên nhà cung cấp dịch vụ	Super Carrier
carrier_country	chuỗi	Mã quốc gia ISO 3166-1 alpha-2	US
start_date	chuỗi	Ngày bắt đầu sự kiện (định dạng YYYY-MM-DD)	2026-05-07
billing_date	chuỗi	Ngày tạo báo cáo thanh toán	2026-05-08
event_count	số	Số lượng sự kiện được tổng hợp theo loại (TỔNG)	150
segment_count*	số	Số phân khúc được tính cho các sự kiện theo mô hình thanh toán ở Hoa Kỳ (SUM) *Chỉ ở Hoa Kỳ	5