Segment

Pendahuluan

Integrasi Segment mengirim event Dodo Payments ke HTTP Tracking API milik Segment sebagai panggilan Track dan Identify. Segment kemudian meneruskan data pembayaran, subscription, dan customer ke alat analitik, marketing, dan warehouse yang terhubung ke workspace Anda, dari katalog yang berisi lebih dari 300 destination.

Integrasi ini memerlukan Write Key dari source HTTP API di workspace Segment Anda. Anda juga memerlukan akses ke Developer → Webhooks di dashboard Dodo Payments.

Memulai

Open the Webhook Section

Di dashboard Dodo Payments, buka Developer → Webhooks dan klik Add endpoint.

Add endpoint dialog with Segment selected in the Integration dropdown and the How to connect Segment steps

Select Segment

Di Integration, pilih Segment. Dashboard akan mengisi Endpoint URL dan kode transformasi untuk Segment.

Enter Write Key

Di Segment, buka Connections → Sources, lalu buka atau buat source HTTP API. Salin Write Key dari pengaturan source dan tempelkan ke API key.

Select Events

Di Subscribed events, pilih hanya event yang ditangani oleh transformasi Anda. Contoh di halaman ini menggunakan payment.succeeded, subscription.active, dan subscription.cancelled.

Configure Transformation

Di bawah Transformation code, edit handler untuk memformat event untuk Track atau Identify API milik Segment. Mulai dari contoh.

Test & Create

Di bawah Test this code, pilih jenis event dan klik Simulate untuk melihat pratinjau panggilan ke Segment. Lalu klik Create endpoint.

Switch to Basic Authentication

Dodo Payments mengirim nilai API key sebagai bearer token, tetapi HTTP API Segment menerima Write Key melalui autentikasi Basic atau field writeKey di body. Tepat setelah membuat endpoint, buka tab Advanced. Di bawah Custom headers, masukkan nilai baru pada baris Authorization yang tersembunyi: Basic, spasi, lalu encoding Base64 dari Write Key Anda dengan titik dua di akhir. Kemudian klik Save. Sebagai contoh, echo -n 'YOUR_WRITE_KEY:' | base64 mencetak nilai yang telah dienkode.

Done

Event yang telah disubscribe kini sampai ke Segment, yang meneruskannya ke destination yang terhubung.

Contoh Kode Transformasi

Setiap handler menetapkan webhook.url ke endpoint API Segment dan mengganti webhook.payload dengan panggilan tersebut. Jumlah Dodo Payments menggunakan unit mata uang terkecil, sehingga contoh-contoh ini membaginya dengan 100. Untuk mata uang tanpa desimal seperti JPY dan KRW, gunakan jumlah tersebut apa adanya.

Melacak Event Pembayaran

Catat event Payment Completed saat pembayaran berhasil:

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;
}

Melacak Siklus Hidup Subscription

Catat event Subscription Started dan Subscription Cancelled:

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;
}

Mengidentifikasi Properti Customer

Perbarui traits customer setelah setiap pembayaran berhasil. Setiap panggilan Identify menetapkan traits ke nilai yang dikirimnya, sehingga traits ini menjelaskan pembayaran terbaru:

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,
        last_payment_amount: (p.total_amount / 100).toFixed(2),
        payment_method: p.payment_method || "unknown",
        last_payment_date: webhook.payload.timestamp
      }
    };
  }
  return webhook;
}

Tips

Gunakan nama event yang konsisten di seluruh integrasi Anda, seperti format object dan action milik Segment dalam Payment Completed.
Sertakan properti yang Anda perlukan untuk analitik dan segmentasi.
Tetapkan timestamp dari timestamp milik event, sehingga Segment mencatat kapan event terjadi, bukan kapan event tersebut tiba.
Gunakan customer_id Dodo Payments sebagai userId, sehingga setiap panggilan untuk customer terhubung ke user Segment yang sama.

Pemecahan Masalah

Events Not Appearing in Segment

Pastikan Write Key berasal dari source HTTP API dan header Authorization menggunakan autentikasi Basic.
Segment mengembalikan 200 untuk sebagian besar request, termasuk request yang tidak diterimanya, sehingga pengiriman yang berhasil di log Dodo Payments tidak membuktikan bahwa event telah tiba. Periksa Debugger source di Segment.
Pastikan nama event mengikuti konvensi penamaan Segment.
Pastikan setiap panggilan menetapkan userId. Segment menolak panggilan yang tidak memiliki userId maupun anonymousId.
Periksa rate limit Segment untuk HTTP API. Segment menyarankan agar jumlah request tetap di bawah 1.000 request per detik untuk setiap workspace.
Jika workspace Anda menggunakan region EU Segment, kirim panggilan ke https://events.eu1.segmentapis.com/v1/track dan https://events.eu1.segmentapis.com/v1/identify.

Transformation Errors

Pastikan payload sesuai dengan format API Segment.
Pastikan semua field wajib tersedia. Track memerlukan event, sedangkan Track dan Identify memerlukan userId atau anonymousId.
Pastikan nama event berupa string, bukan object.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Pendahuluan

Memulai

Contoh Kode Transformasi

Melacak Event Pembayaran

Melacak Siklus Hidup Subscription

Mengidentifikasi Properti Customer

Tips

Pemecahan Masalah

​Pendahuluan

​Memulai

​Contoh Kode Transformasi

​Melacak Event Pembayaran

​Melacak Siklus Hidup Subscription

​Mengidentifikasi Properti Customer

​Tips

​Pemecahan Masalah

Pendahuluan

Memulai

Contoh Kode Transformasi

Melacak Event Pembayaran

Melacak Siklus Hidup Subscription

Mengidentifikasi Properti Customer

Tips

Pemecahan Masalah