Hướng dẫn tích hợp thanh toán dựa trên mức sử dụng

​

Tạo một đồng hồ đo

• 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

​

Liên kết đồng hồ đo trong một sản phẩm

• 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

​

Gửi sự kiện sử dụng

​

Cấu trúc sự kiện

​

Ví dụ API sự kiện sử dụng

const response = await fetch('https://test.dodopayments.com/events/ingest', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.DODO_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    events: [
      {
        event_id: "api_call_1234",
        customer_id: "cus_atXa1lklCRRzMicTqfiw2", 
        event_name: "api.call",
        timestamp: new Date().toISOString(),
        metadata: {
          endpoint: "/v1/orders",
          method: "POST",
          response_size: 1024
        }
      }
    ]
  })
});

​

Phân tích thanh toán dựa trên mức sử dụng

​

Phân tích tổng quan

​

Chỉ số hoạt động

​

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

• 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

​

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

​

Hiểu các loại tổng hợp

​

Ví dụ thực tế về triển khai

{
  "events": [
    {"event_id": "call_1", "customer_id": "cus_123", "event_name": "api.call"},
    {"event_id": "call_2", "customer_id": "cus_123", "event_name": "api.call"},
    {"event_id": "call_3", "customer_id": "cus_123", "event_name": "api.call"}
  ]
}

{
  "events": [
    {
      "event_id": "transfer_1",
      "customer_id": "cus_123", 
      "event_name": "data.transfer",
      "metadata": {"bytes": 1073741824}
    },
    {
      "event_id": "transfer_2",
      "customer_id": "cus_123",
      "event_name": "data.transfer", 
      "metadata": {"bytes": 536870912}
    }
  ]
}

{
  "events": [
    {
      "event_id": "peak_1",
      "customer_id": "cus_123",
      "event_name": "concurrent.users", 
      "metadata": {"count": 15}
    },
    {
      "event_id": "peak_2",
      "customer_id": "cus_123",
      "event_name": "concurrent.users",
      "metadata": {"count": 23}
    },
    {
      "event_id": "peak_3",
      "customer_id": "cus_123",
      "event_name": "concurrent.users",
      "metadata": {"count": 18}
    }
  ]
}

​

Ví dụ về lọc sự kiện

{
  "event_id": "call_1",
  "customer_id": "cus_123",
  "event_name": "api.call",
  "metadata": {
    "endpoint": "/v1/orders",
    "method": "POST"
  }
}

{
  "event_id": "upload_1",
  "customer_id": "cus_123", 
  "event_name": "file.upload",
  "metadata": {
    "file_size": 5242880,
    "file_type": "image"
  }
}

{
  "event_id": "call_1",
  "customer_id": "cus_123",
  "event_name": "api.call",
  "metadata": {
    "plan_type": "premium",
    "hour": 14,
    "endpoint": "/v1/analytics"
  }
}

​

Khắc phục sự cố

​

Các vấn đề phổ biến

• 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

1. Xác minh giao hàng sự kiện trong tab phân tích Sự kiện
2. 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
3. Xác thực ID khách hàng và xác thực API
4. 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