सेगमेंट

परिचय

Segment integration Dodo Payments events को Segment के HTTP Tracking API में Track और Identify calls के रूप में भेजता है। इसके बाद Segment payment, subscription और customer data को आपके workspace से जुड़े analytics, marketing और warehouse tools तक भेजता है। इसके catalog में 300+ destinations उपलब्ध हैं।

इस integration के लिए आपके Segment workspace में मौजूद HTTP API source की Write Key आवश्यक है। आपको Dodo Payments dashboard में Developer → Webhooks का access भी चाहिए।

प्रारंभ करना

Open the Webhook Section

Dodo Payments डैशबोर्ड में, Developer → Webhooks पर जाएँ और Add endpoint पर क्लिक करें।

Integration ड्रॉपडाउन में Segment चयनित होने वाला Add endpoint डायलॉग और Segment कनेक्ट करने के तरीके के चरण

Select Segment

Integration में Segment चुनें। Dashboard Endpoint URL और Segment के लिए transformation code अपने-आप भर देता है।

Enter Write Key

Segment में Connections → Sources पर जाएँ और कोई HTTP API source खोलें या बनाएँ। Source की settings से Write Key कॉपी करें और उसे API key में paste करें।

Select Events

Subscribed events में केवल वे events चुनें जिन्हें आपका transformation handle करता है। इस page के examples payment.succeeded, subscription.active और subscription.cancelled का उपयोग करते हैं।

Configure Transformation

Transformation code के अंतर्गत, Segment के Track या Identify API के लिए events को format करने हेतु handler को edit करें। examples से शुरुआत करें।

Test & Create

Test this code के अंतर्गत कोई event type चुनें और Segment को call का preview देखने के लिए Simulate पर क्लिक करें। इसके बाद Create endpoint पर क्लिक करें।

Switch to Basic Authentication

Dodo Payments API key value को bearer token के रूप में भेजता है, लेकिन Segment का HTTP API Basic authentication के माध्यम से Write Key या body में मौजूद writeKey field स्वीकार करता है। Endpoint बनाने के तुरंत बाद उसका Advanced tab खोलें। Custom headers के अंतर्गत, छिपी हुई Authorization row में एक नई value दर्ज करें: Basic, एक space, और अंत में colon जोड़कर अपनी Write Key का Base64 encoding। फिर Save पर क्लिक करें। उदाहरण के लिए, echo -n 'YOUR_WRITE_KEY:' | base64 encoded value print करता है।

Done

अब Subscribed events Segment तक पहुँचते हैं, जो उन्हें आपके connected destinations तक forward करता है।

Transformation Code Examples

हर handler webhook.url को Segment API endpoint पर set करता है और webhook.payload को call से replace करता है। Dodo Payments amounts currency की smallest unit में होते हैं, इसलिए examples उन्हें 100 से divide करते हैं। JPY और KRW जैसी zero-decimal currencies के लिए amount को 그대로 उपयोग करें।

Track Payment Events

Payment सफल होने पर एक Payment Completed event record करें:

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

Track Subscription Lifecycle

Subscription Started और Subscription Cancelled events record करें:

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

Identify Customer Properties

हर successful payment के बाद customer के traits update करें। प्रत्येक Identify call भेजी गई values के अनुसार traits set करती है, इसलिए ये traits latest payment को describe करते हैं:

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

अपने integration में consistent event names का उपयोग करें, जैसे Payment Completed में Segment का object और action format।
Analytics और segmentation के लिए आवश्यक properties शामिल करें।
event के timestamp से timestamp set करें, ताकि Segment event के पहुँचने के समय के बजाय उसके घटित होने का समय record करे।
Dodo Payments customer_id को userId के रूप में उपयोग करें, ताकि किसी customer के लिए प्रत्येक call उसी Segment user से attach हो।

Troubleshooting

Events Not Appearing in Segment

जाँचें कि Write Key किसी HTTP API source से संबंधित है और Authorization header Basic authentication का उपयोग करता है।
Segment अधिकांश requests के लिए 200 लौटाता है, जिनमें वे requests भी शामिल हैं जिन्हें वह स्वीकार नहीं करता। इसलिए Dodo Payments logs में successful delivery दिखना इस बात का प्रमाण नहीं है कि event पहुँच गया। Segment में source का Debugger जाँचें।
जाँचें कि event names Segment की naming conventions का पालन करते हैं।
जाँचें कि प्रत्येक call userId set करता है। Segment उस call को reject करता है जिसमें न तो userId हो और न ही anonymousId।
HTTP API के लिए Segment की rate limits जाँचें। Segment प्रत्येक workspace के लिए 1,000 requests per second से कम रहने की सलाह देता है।
यदि आपका workspace Segment के EU region का उपयोग करता है, तो इसके बजाय calls को https://events.eu1.segmentapis.com/v1/track और https://events.eu1.segmentapis.com/v1/identify पर भेजें।

Transformation Errors

जाँचें कि payload Segment के API format से मेल खाता है।
जाँचें कि सभी required fields मौजूद हैं। Track के लिए event आवश्यक है, और Track तथा Identify दोनों के लिए userId या anonymousId आवश्यक है।
जाँचें कि event names objects के बजाय strings हैं।

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

परिचय

प्रारंभ करना

Transformation Code Examples

Track Payment Events

Track Subscription Lifecycle

Identify Customer Properties

Tips

Troubleshooting

​परिचय

​प्रारंभ करना

​Transformation Code Examples

​Track Payment Events

​Track Subscription Lifecycle

​Identify Customer Properties

​Tips

​Troubleshooting

परिचय

प्रारंभ करना

Transformation Code Examples

Track Payment Events

Track Subscription Lifecycle

Identify Customer Properties

Tips

Troubleshooting