API Reference - Events Ingestion
API Reference - Meters Creation
Tạo một đồng hồ đo
Các đồng hồ đo xác định cách các sự kiện sử dụng của bạn được tổng hợp và đo lường cho mục đích thanh toán. Trước khi tạo một đồng hồ đo, hãy lập kế hoạch chiến lược theo dõi mức sử dụng của bạn:- Xác định các sự kiện sử dụng mà bạn muốn theo dõi
- Xác định cách các sự kiện nên được tổng hợp (đếm, tổng, v.v.)
- Định nghĩa bất kỳ yêu cầu lọc nào cho các trường hợp sử dụng cụ thể
Quy trình tạo đồng hồ đo từng bước
Theo dõi hướng dẫn toàn diện này để thiết lập đồng hồ đo sử dụng của bạn:Configure Basic Information
Configure Aggregation Settings
- Count
- Sum
- Max
- Last
Configure Event Filtering (Optional)
- AND Logic
- OR Logic
user_tier = "premium" AND endpoint = "/api/v2/users"Add Condition
Configure Property Key
Select Comparator
equals- Khớp chính xácnot_equals- Bộ lọc loại trừgreater_than- So sánh sốgreater_than_or_equals- So sánh số (bao gồm)less_than- So sánh sốless_than_or_equals- So sánh số (bao gồm)contains- Chuỗi chứa chuỗi condoes_not_contain- Bộ lọc loại trừ chuỗi
Set Comparison Value
Add Groups
Create Meter
Liên kết đồng hồ đo trong một sản phẩm
Khi bạn đã tạo đồng hồ đo của mình, bạn cần liên kết nó với một sản phẩm để kích hoạt thanh toán dựa trên mức sử dụng. Quy trình này kết nối dữ liệu sử dụng của đồng hồ đo với các quy tắc định giá cho việc thanh toán của khách hàng. Liên kết các đồng hồ đo với các sản phẩm thiết lập kết nối giữa theo dõi mức sử dụng và thanh toán:- Các sản phẩm xác định các quy tắc định giá và hành vi thanh toán
- Các đồng hồ đo cung cấp dữ liệu sử dụng cho các phép tính thanh toán
- Nhiều đồng hồ đo có thể được liên kết với một sản phẩm duy nhất cho các kịch bản thanh toán phức tạp
Quy trình cấu hình sản phẩm
Biến dữ liệu sử dụng của bạn thành các khoản phí có thể tính bằng cách cấu hình đúng cài đặt sản phẩm của bạn:Choose Usage-Based Billing Product Type
Select Associated Meter
Add Your Meter
- Nhấp vào Thêm đồng hồ đo để xem các đồng hồ đo có sẵn
- Chọn đồng hồ đo bạn đã tạo từ danh sách thả xuống
- Đồng hồ đo đã chọn sẽ xuất hiện trong cấu hình sản phẩm của bạn
Configure Price Per Unit
$0.50 cho mỗi đơn vị có nghĩa là:- 1.000 đơn vị tiêu thụ = 1.000 × $0.50 = 500.00 được tính phí
- 500 đơn vị tiêu thụ = 500 × $0.50 = 250.00 được tính phí
- 100 đơn vị tiêu thụ = 100 × $0.50 = 50.00 được tính phí
Set Free Threshold (Optional)
- Ngưỡng miễn phí: 100 đơn vị
- Giá mỗi đơn vị: $0.50
- Khách hàng sử dụng: 250 đơn vị
- Phép tính: (250 - 100) × 75.00** được tính phí
Save Configuration
- Các sự kiện sử dụng gửi tới đồng hồ đo sẽ được theo dõi và tổng hợp
- Các phép tính thanh toán sẽ tự động áp dụng quy tắc định giá của bạn
- Khách hàng sẽ bị tính phí dựa trên mức tiêu thụ thực tế trong mỗi chu kỳ thanh toán
Gửi sự kiện sử dụng
Khi đồng hồ đo của bạn đã được cấu hình, bạn có thể bắt đầu gửi các sự kiện sử dụng từ ứng dụng của mình để theo dõi mức sử dụng của khách hàng.Cấu trúc sự kiện
Mỗi sự kiện sử dụng phải bao gồm các trường bắt buộc sau:Ví dụ API sự kiện sử dụng
Gửi các sự kiện sử dụng đến các đồng hồ đo đã cấu hình của bạn bằng cách sử dụng API Sự kiện:Phân tích thanh toán dựa trên mức sử dụng
Theo dõi và phân tích dữ liệu thanh toán dựa trên mức sử dụng của bạn với bảng điều khiển phân tích toàn diện. Theo dõi các mẫu tiêu thụ của khách hàng, hiệu suất đồng hồ đo và xu hướng thanh toán để tối ưu hóa chiến lược định giá của bạn và hiểu hành vi sử dụng.Phân tích tổng quan
Tab Tổng quan cung cấp cái nhìn tổng quát về hiệu suất thanh toán dựa trên mức sử dụng của bạn:Chỉ số hoạt động
Theo dõi các thống kê sử dụng chính trong các khoảng thời gian khác nhau:Biểu đồ số lượng đồng hồ đo

- Hình ảnh theo chuỗi thời gian: Theo dõi các mẫu sử dụng qua các ngày, tuần hoặc tháng
- Hỗ trợ nhiều đồng hồ đo: Xem dữ liệu từ các đồng hồ đo khác nhau cùng một lúc
- Phân tích xu hướng: Xác định các đỉnh sử dụng, các mẫu và quỹ đạo tăng trưởng
Phân tích sự kiện

Hiển thị thông tin sự kiện
Bảng sự kiện cung cấp cái nhìn rõ ràng về từng sự kiện sử dụng với các cột sau:- Tên sự kiện: Hành động hoặc kích hoạt cụ thể đã tạo ra sự kiện sử dụng
- ID sự kiện: Định danh duy nhất cho mỗi phiên bản sự kiện
- ID khách hàng: Khách hàng liên quan đến sự kiện
- Thời gian: Khi sự kiện xảy ra
Phân tích khách hàng
Tab Khách hàng cung cấp cái nhìn chi tiết về dữ liệu sử dụng của khách hàng với các thông tin sau:Các cột dữ liệu có sẵn
Các tính năng của bảng
- Lọc cột: Sử dụng tính năng “Chỉnh sửa cột” để hiển thị/ẩn các cột dữ liệu cụ thể
- Cập nhật theo thời gian thực: Dữ liệu sử dụng phản ánh các chỉ số tiêu thụ hiện tại nhất
Ví dụ về tổng hợp
Dưới đây là các ví dụ thực tế về cách các loại tổng hợp khác nhau hoạt động:Hiểu các loại tổng hợp
Các loại tổng hợp khác nhau phục vụ cho các kịch bản thanh toán khác nhau. Chọn loại phù hợp dựa trên cách bạn muốn đo lường và tính phí cho mức sử dụng.Ví dụ thực tế về triển khai
Các ví dụ này minh họa các ứng dụng thực tế của mỗi loại tổng hợp với các sự kiện mẫu và kết quả mong đợi.Count Aggregation - API Calls
Count Aggregation - API Calls
- Event Name:
api.call - Aggregation Type: Count
- Measurement Unit:
calls
Sum Aggregation - Data Transfer
Sum Aggregation - Data Transfer
- Event Name:
data.transfer - Aggregation Type: Sum
- Over Property:
bytes - Measurement Unit:
GB
Max Aggregation - Peak Concurrent Users
Max Aggregation - Peak Concurrent Users
- Event Name:
concurrent.users - Aggregation Type: Max
- Over Property:
count - Measurement Unit:
users
Ví dụ về lọc sự kiện
- Filter by API Endpoint
- Filter by Value Range
- Complex Multi-Condition Filters
- Property:
endpoint - Comparator:
equals - Value:
/v1/orders
Khắc phục sự cố
Giải quyết các vấn đề phổ biến với việc triển khai thanh toán dựa trên mức sử dụng và đảm bảo theo dõi và thanh toán chính xác.Các vấn đề phổ biến
Hầu hết các vấn đề thanh toán dựa trên mức sử dụng rơi vào các loại sau:- Vấn đề giao hàng và xử lý sự kiện
- Vấn đề cấu hình đồng hồ đo
- Lỗi kiểu dữ liệu và định dạng
- Vấn đề ID khách hàng và xác thực
Các bước gỡ lỗi
Khi khắc phục sự cố thanh toán dựa trên mức sử dụng:- Xác minh giao hàng sự kiện trong tab phân tích Sự kiện
- Kiểm tra cấu hình đồng hồ đo khớp với cấu trúc sự kiện của bạn
- Xác thực ID khách hàng và xác thực API
- Xem xét các điều kiện lọc và cài đặt tổng hợp
Giải pháp và sửa chữa
Events not showing in meter
Events not showing in meter
- Tên sự kiện không khớp chính xác với cấu hình đồng hồ đo
- Điều kiện lọc sự kiện đang loại bỏ các sự kiện của bạn
- ID khách hàng không tồn tại trong tài khoản Dodo Payments của bạn
- Dấu thời gian sự kiện nằm ngoài chu kỳ thanh toán hiện tại
- Kiểm tra lại cách viết và phân biệt hoa thường của tên sự kiện
- Xem lại và kiểm tra các điều kiện lọc của bạn
- Xác nhận ID khách hàng hợp lệ và còn hoạt động
- Kiểm tra dấu thời gian sự kiện là gần đây và được định dạng đúng
Aggregation not working as expected
Aggregation not working as expected
- Tên thuộc tính Over Property không khớp với khóa siêu dữ liệu sự kiện
- Giá trị siêu dữ liệu có kiểu dữ liệu sai (chuỗi so với số)
- Thiếu các thuộc tính siêu dữ liệu bắt buộc
- Đảm bảo khóa siêu dữ liệu khớp chính xác với thiết lập Over Property
- Chuyển chuỗi số sang số thực trong sự kiện của bạn
- Bao gồm tất cả các thuộc tính bắt buộc trong mỗi sự kiện
Filtering not working
Filtering not working
- Tên thuộc tính bộ lọc không khớp với siêu dữ liệu sự kiện
- Toán tử sai cho kiểu dữ liệu (chuỗi so với số)
- Phân biệt chữ hoa chữ thường khi so sánh chuỗi
- Kiểm tra kỹ tên thuộc tính để đảm bảo khớp chính xác
- Sử dụng toán tử phù hợp với kiểu dữ liệu của bạn
- Cân nhắc vấn đề phân biệt hoa thường khi lọc chuỗi