Chuyển đến nội dung chính

Giới thiệu

Theo dõi các sự kiện thanh toán trong Segment để hỗ trợ phân tích, tự động hóa tiếp thị và nền tảng dữ liệu khách hàng của bạn. Gửi các sự kiện thanh toán, đăng ký và vòng đời khách hàng đến hơn 300 công cụ hạ nguồn một cách tự động.
Tích hợp này yêu cầu một Segment Write Key từ workspace Segment của bạn.

Bắt đầu

1

Open the Webhook Section

Trong bảng điều khiển Dodo Payments của bạn, điều hướng đến Webhooks → + Add Endpoint và mở rộng trình đơn thả xuống tích hợp.
Thêm Endpoint và menu thả xuống tích hợp
2

Select Segment

Chọn thẻ tích hợp Segment.
3

Enter Write Key

Cung cấp Segment Write Key của bạn trong phần cấu hình.
4

Configure Transformation

Chỉnh sửa mã biến đổi để định dạng sự kiện cho API Track của Segment.
5

Test & Create

Kiểm tra bằng các payload mẫu và nhấp Create để kích hoạt đồng bộ.
6

Done!

🎉 Các sự kiện thanh toán giờ sẽ được theo dõi trong Segment và gửi tới các công cụ kết nối của bạn.

Ví dụ Mã Biến đổi

Theo dõi Sự kiện Thanh toán

track_payments.js
function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://api.segment.io/v1/track";
    webhook.payload = {
      userId: p.customer.customer_id,
      event: "Payment Completed",
      properties: {
        amount: (p.total_amount / 100).toFixed(2),
        currency: p.currency || "USD",
        payment_method: p.payment_method || "unknown",
        payment_id: p.payment_id,
        customer_email: p.customer.email,
        customer_name: p.customer.name
      },
      timestamp: webhook.payload.timestamp
    };
  }
  return webhook;
}

Theo dõi Vòng đời Đăng ký

track_subscriptions.js
function handler(webhook) {
  const s = webhook.payload.data;
  switch (webhook.eventType) {
    case "subscription.active":
      webhook.url = "https://api.segment.io/v1/track";
      webhook.payload = {
        userId: s.customer.customer_id,
        event: "Subscription Started",
        properties: {
          subscription_id: s.subscription_id,
          product_id: s.product_id,
          amount: (s.recurring_pre_tax_amount / 100).toFixed(2),
          frequency: s.payment_frequency_interval,
          next_billing: s.next_billing_date,
          customer_email: s.customer.email
        },
        timestamp: webhook.payload.timestamp
      };
      break;
    case "subscription.cancelled":
      webhook.url = "https://api.segment.io/v1/track";
      webhook.payload = {
        userId: s.customer.customer_id,
        event: "Subscription Cancelled",
        properties: {
          subscription_id: s.subscription_id,
          product_id: s.product_id,
          cancelled_at: s.cancelled_at,
          cancel_at_next_billing: s.cancel_at_next_billing_date,
          customer_email: s.customer.email
        },
        timestamp: webhook.payload.timestamp
      };
      break;
  }
  return webhook;
}

Xác định Thuộc tính Khách hàng

identify_customer.js
function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://api.segment.io/v1/identify";
    webhook.payload = {
      userId: p.customer.customer_id,
      traits: {
        email: p.customer.email,
        name: p.customer.name,
        total_spent: (p.total_amount / 100).toFixed(2),
        payment_method: p.payment_method || "unknown",
        last_payment_date: webhook.payload.timestamp,
        customer_since: webhook.payload.timestamp
      }
    };
  }
  return webhook;
}

Mẹo

  • Sử dụng tên sự kiện nhất quán trong toàn bộ tích hợp của bạn
  • Bao gồm các thuộc tính liên quan cho phân tích và phân khúc
  • Đặt dấu thời gian chính xác để theo dõi sự kiện chính xác
  • Sử dụng ID khách hàng làm userId để xác định người dùng chính xác

Khắc phục sự cố

  • Xác minh Write Key là đúng và đang hoạt động
  • Kiểm tra tên sự kiện có tuân theo quy ước đặt tên của Segment không
  • Đảm bảo userId được thiết lập đúng để xác định người dùng
  • Xem lại giới hạn tỷ lệ API của Segment
  • Xác nhận cấu trúc JSON khớp định dạng API của Segment
  • Kiểm tra tất cả các trường bắt buộc đã có mặt
  • Đảm bảo tên sự kiện là chuỗi, không phải đối tượng