मुख्य सामग्री पर जाएं

​
परिचय

Dub एक शक्तिशाली लिंक प्रबंधन प्लेटफ़ॉर्म है जो आपको छोटे लिंक बनाने, साझा करने और ट्रैक करने में मदद करता है। Dodo Payments के साथ Dub को एकीकृत करके, आप स्वचालित रूप से बिक्री रूपांतरण घटनाओं को ट्रैक कर सकते हैं जब ग्राहक खरीदारी पूरी करते हैं, जिससे आप अपने मार्केटिंग अभियानों और रेफरल कार्यक्रमों की ROI को माप सकते हैं। Dub में “बिक्री” घटना तब दर्ज की जाती है जब ग्राहक:
  • एक बार का भुगतान पूरा करता है
  • एक भुगतान योजना की सदस्यता लेता है
  • एक आवर्ती सदस्यता भुगतान करता है
इस एकीकरण के लिए आपके लिंक पर रूपांतरण ट्रैकिंग सक्षम Dub खाता की आवश्यकता है।
एफिलिएट प्रोग्राम इंटीग्रेशन: यह इंटीग्रेशन Dub Partners के साथ भी बिना किसी रुकावट के काम करता है ताकि एफिलिएट रेफरल और कमीशन को ट्रैक किया जा सके। बिक्री को आपके एफिलिएट लिंक से जोड़ने और भागीदारों के प्रदर्शन को मापने के लिए Dub के रूपांतरण ट्रैकिंग का उपयोग करें। हमारे एफिलिएट फीचर गाइड में एफिलिएट प्रोग्राम सेटअप करने के बारे में अधिक जानें।

​
यह कैसे काम करता है

Dub उपयोगकर्ताओं द्वारा आपके Dub शॉर्ट लिंक पर क्लिक करने पर एक अनूठी क्लिक आईडी (dub_id) को कुकी में संग्रहीत करता है। आपकी लिंक के लिए बिक्री को जोड़ने के लिए, आपको:
  1. चेकआउट सत्र बनाते समय Dub की क्लिक आईडी को dub_id कुकी से कैप्चर करें
  2. क्लिक आईडी को ग्राहक की बाहरी आईडी के साथ अपने भुगतान मेटाडेटा में स्टोर करें
  3. भुगतान सफल होने पर Dub को बिक्री डेटा भेजें उनके ट्रैक एपीआई का उपयोग करके
यह Dub को सफल बिक्री को मूल लिंक क्लिक से मिलाने की अनुमति देता है, जिससे आपको पूर्ण रूपांतरण एट्रिब्यूशन मिलता है।

​
पूर्वापेक्षाएँ

इस इंटीग्रेशन को सेटअप करने से पहले सुनिश्चित करें कि आपके पास:
  1. एक Dub खाता जिसमें एक कार्यक्षेत्र हो
  2. आपके लिंक के लिए रूपांतरण ट्रैकिंग सक्षम हो
  3. आपका Dub एपीआई कुंजी (आपके Dub डैशबोर्ड में सेटिंग्स → एपीआई कुंजी के तहत उपलब्ध)

​
शुरू करना

1

Dub में रूपांतरण ट्रैकिंग सक्षम करें

अपने Dub डैशबोर्ड में, उन लिंक के लिए रूपांतरण ट्रैकिंग सक्षम करें जिनके लिए आप बिक्री को ट्रैक करना चाहते हैं। यह Dub को ग्राहकों द्वारा खरीदारी पूरी करने पर बिक्री घटनाओं को रिकॉर्ड करने की अनुमति देता है।
Dub दस्तावेज़ीकरण में रूपांतरण ट्रैकिंग सक्षम करने के बारे में अधिक जानें।
2

अपना Dub एपीआई कुंजी प्राप्त करें

अपने Dub डैशबोर्ड → सेटिंग्स → एपीआई कुंजी पर जाएं और conversions.write स्कोप के साथ एक नया एपीआई कुंजी बनाएं।
अपनी एपीआई कुंजी को सुरक्षित रखें और इसे कभी भी क्लाइंट-साइड कोड में उजागर न करें।
3

चेकआउट में क्लिक आईडी कैप्चर करें

चेकआउट सत्र बनाते समय, कुकी से Dub क्लिक आईडी को कैप्चर करें और इसे अपने भुगतान मेटाडेटा में जोड़ें।
4

Webhook के माध्यम से बिक्री डेटा भेजें

भुगतान सफल होने पर Dub के ट्रैक एपीआई को बिक्री डेटा भेजने के लिए एक वेबहुक कॉन्फ़िगर करें।
5

हो गया!

बिक्री रूपांतरण घटनाएँ अब आपके Dub एनालिटिक्स डैशबोर्ड में आपके लिंक के लिए पूर्ण एट्रिब्यूशन के साथ दिखाई देंगी।

​
कार्यान्वयन गाइड

​
चरण 1: चेकआउट मेटाडेटा में क्लिक आईडी और ग्राहक आईडी जोड़ें

चेकआउट सत्र बनाते समय, कुकी से Dub क्लिक आईडी को कैप्चर करें और इसे अपने ग्राहक की बाहरी आईडी के साथ अपने भुगतान मेटाडेटा में शामिल करें। 
import { cookies } from 'next/headers';
import DodoPayments from 'dodopayments';

const client = new DodoPayments();

export async function createCheckout(productId: string, customerId: string) {
  // Capture Dub click ID from cookie
  const dubClickId = cookies().get('dub_id')?.value;

  const payment = await client.payments.create({
    billing: {
      city: 'New York',
      country: 'US',
      state: 'NY',
      street: '123 Main St',
      zipcode: '10001',
    },
    customer: {
      email: 'customer@example.com',
      name: 'John Doe',
    },
    product_id: productId,
    metadata: {
      dub_click_id: dubClickId,           // Store Dub click ID
      dub_external_id: customerId,        // Store your customer's unique ID
    },
  });

  return payment;
}

​
चरण 2: Dub को बिक्री डेटा भेजें

भुगतान सफल होने पर Dub के ट्रैक एपीआई को बिक्री डेटा भेजने के लिए एक वेबहुक एंडपॉइंट कॉन्फ़िगर करें।
1

Webhook अनुभाग खोलें

अपने Dodo Payments डैशबोर्ड में, Webhooks → + Add Endpoint पर जाएं और इंटीग्रेशन ड्रॉपडाउन का विस्तार करें।
एंडपॉइंट जोड़ें और इंटीग्रेशन ड्रॉपडाउन
2

Dub का चयन करें

Dub इंटीग्रेशन कार्ड चुनें।
3

एपीआई कुंजी दर्ज करें

कॉन्फ़िगरेशन फ़ील्ड में अपनी Dub एपीआई कुंजी प्रदान करें।
एपीआई कुंजी जोड़ें
4

रूपांतरण कॉन्फ़िगर करें

Dub के ट्रैक बिक्री एपीआई के लिए भुगतान डेटा को प्रारूपित करने के लिए रूपांतरण कोड को संपादित करें।
5

परीक्षण और बनाएँ

नमूना पेलोड के साथ परीक्षण करें और इंटीग्रेशन को सक्रिय करने के लिए Create पर क्लिक करें।

​
रूपांतरण कोड उदाहरण

​
बुनियादी बिक्री ट्रैकिंग

भुगतान सफल होने पर बिक्री को ट्रैक करें:
basic_sale.js
function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const payment = webhook.payload.data;

    // Only send to Dub if click ID exists in metadata
    if (payment.metadata && payment.metadata.dub_click_id) {
      webhook.payload = {
        clickId: payment.metadata.dub_click_id,
        externalId: payment.metadata.dub_external_id || payment.customer.customer_id,
        amount: payment.total_amount, // Ensure the amount is in cents
        currency: payment.currency || "USD",
        paymentProcessor: "dodo",
        invoiceId: payment.payment_id,
        metadata: {
          customer_email: payment.customer.email,
          customer_name: payment.customer.name,
          product_id: payment.product_cart ? payment.product_cart.map(product => product.product_id).join(', ') : undefined,
        },
      };
    } else {
      // Cancel dispatch if no click ID (organic traffic)
      webhook.cancel = true;
    }
  }
  return webhook;
}

​
सदस्यता बिक्री को ट्रैक करें

प्रारंभिक सदस्यताओं और आवर्ती भुगतानों दोनों को ट्रैक करें:
subscription_sale.js
function handler(webhook) {
  const data = webhook.payload.data;

  // Track initial subscription activation
  if (webhook.eventType === "subscription.active") {
    if (data.metadata && data.metadata.dub_click_id) {
      webhook.payload = {
        clickId: data.metadata.dub_click_id,
        externalId: data.metadata.dub_external_id || data.customer.customer_id,
        amount: data.recurring_pre_tax_amount, // Amount in cents
        currency: data.currency || "USD",
        paymentProcessor: "dodo",
        invoiceId: data.subscription_id,
        eventName: "Subscription Started",
        metadata: {
          subscription_id: data.subscription_id,
          product_id: data.product_id,
          billing_interval: data.payment_frequency_interval,
          customer_email: data.customer.email,
        },
      };
    } else {
      // Cancel dispatch if no click ID (organic traffic)
      webhook.cancel = true;
    }
  }

  // Track recurring subscription payments
  if (webhook.eventType === "subscription.renewed") {
    if (data.metadata && data.metadata.dub_click_id) {
      webhook.payload = {
        clickId: data.metadata.dub_click_id,
        externalId: data.metadata.dub_external_id || data.customer.customer_id,
        amount: data.recurring_pre_tax_amount,
        currency: data.currency || "USD",
        paymentProcessor: "dodo",
        invoiceId: `${data.subscription_id}_${Date.now()}`,
        eventName: "Subscription Renewed",
        metadata: {
          subscription_id: data.subscription_id,
          product_id: data.product_id,
          customer_email: data.customer.email,
        },
      };
    } else {
      // Cancel dispatch if no click ID (organic traffic)
      webhook.cancel = true;
    }
  }

  return webhook;
}

​
कर छूट के साथ बिक्री को ट्रैक करें

सटीक राजस्व ट्रैकिंग के लिए केवल पूर्व-कर राशि को Dub को भेजें:
sale_without_tax.js
function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const payment = webhook.payload.data;

    if (payment.metadata && payment.metadata.dub_click_id) {
      // Calculate pre-tax amount (total minus tax)
      const preTaxAmount = payment.total_amount - (payment.tax || 0);

      webhook.payload = {
        clickId: payment.metadata.dub_click_id,
        externalId: payment.metadata.dub_external_id || payment.customer.customer_id,
        amount: preTaxAmount, // Pre-tax amount in cents
        currency: payment.currency || "USD",
        paymentProcessor: "dodo",
        invoiceId: payment.payment_id,
        metadata: {
          total_amount: payment.total_amount,
          tax_amount: payment.tax || 0,
          customer_email: payment.customer.email,
        },
      };
    } else {
      // Cancel dispatch if no click ID (organic traffic)
      webhook.cancel = true;
    }
  }
  return webhook;
}

​
कस्टम इवेंट नामों के साथ बिक्री को ट्रैक करें

विभिन्न प्रकार की बिक्री को वर्गीकृत करने के लिए कस्टम इवेंट नामों का उपयोग करें:
custom_events.js
function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const payment = webhook.payload.data;

    if (payment.metadata && payment.metadata.dub_click_id) {
      // Determine event name based on payment type
      let eventName = "Purchase";
      if (payment.subscription_id) {
        eventName = "Subscription Purchase";
      } else if (payment.metadata && payment.metadata.is_upgrade) {
        eventName = "Plan Upgrade";
      }

      webhook.payload = {
        clickId: payment.metadata.dub_click_id,
        externalId: payment.metadata.dub_external_id || payment.customer.customer_id,
        amount: payment.total_amount,
        currency: payment.currency || "USD",
        paymentProcessor: "dodo",
        invoiceId: payment.payment_id,
        eventName: eventName,
        metadata: {
          product_id: payment.product_cart ? payment.product_cart.map(product => product.product_id).join(', ') : undefined,
          customer_email: payment.customer.email,
        },
      };
    } else {
      // Cancel dispatch if no click ID (organic traffic)
      webhook.cancel = true;
    }
  }
  return webhook;
}

​
वैकल्पिक: क्लाइंट-साइड कार्यान्वयन

यदि आप वेबहुक का उपयोग करने के बजाय अपने सर्वर से बिक्री को ट्रैक करना पसंद करते हैं, तो आप सफल भुगतान के बाद सीधे Dub के ट्रैक एपीआई को कॉल कर सकते हैं: 
'use server';

import { Dub } from 'dub';

const dub = new Dub();

export async function trackSale(
  paymentId: string,
  clickId: string,
  customerId: string,
  amount: number,
  currency: string
) {
  await dub.track.sale({
    clickId: clickId,
    externalId: customerId,
    amount: amount,
    currency: currency,
    paymentProcessor: 'dodo',
    invoiceId: paymentId,
  });
}

​
सर्वोत्तम प्रथाएँ

क्लिक आईडी को जल्दी कैप्चर करें: सुनिश्चित करें कि सटीक एट्रिब्यूशन के लिए अपने चेकआउट प्रवाह में Dub क्लिक आईडी को यथाशीघ्र स्टोर करें, भले ही उपयोगकर्ता दूर navigates और बाद में लौटे।
  • हमेशा मेटाडेटा में क्लिक आईडी शामिल करें: बिना क्लिक आईडी के, Dub आपके लिंक पर राजस्व को एट्रिब्यूट नहीं कर सकता
  • बाहरी आईडी का लगातार उपयोग करें: सटीक ग्राहक-स्तरीय एनालिटिक्स के लिए अपने सिस्टम में उपयोग की जाने वाली वही ग्राहक आईडी पास करें
  • जैविक ट्रैफ़िक को सही ढंग से संभालें: जब कोई क्लिक आईडी न हो तो webhook.cancel = true सेट करें ताकि अनावश्यक एपीआई कॉल से बचा जा सके
  • नमूना भुगतानों के साथ परीक्षण करें: सुनिश्चित करें कि इंटीग्रेशन सही ढंग से काम कर रहा है इससे पहले कि आप लाइव जाएं
  • अपने Dub डैशबोर्ड की निगरानी करें: जांचें कि बिक्री सही ढंग से उचित एट्रिब्यूशन के साथ दिखाई दे रही है

​
महत्वपूर्ण नोट्स

  • राशि प्रारूप: Dub सेंट में राशियों की अपेक्षा करता है (जैसे, $10.00 = 1000)
  • मुद्रा: ISO 4217 मुद्रा कोड का उपयोग करें (USD, EUR, GBP, आदि)
  • फ्री ट्रायल: $0 भुगतान को बिक्री के रूप में ट्रैक नहीं किया जाता है
  • रिफंड: यदि आवश्यक हो तो सटीक राजस्व रिपोर्टिंग के लिए रिफंड को अलग से ट्रैक करने पर विचार करें

​
समस्या निवारण

  • सुनिश्चित करें कि आपकी Dub एपीआई कुंजी सही है और इसमें conversions.write स्कोप है
  • जांचें कि dub_click_id को कैप्चर और भुगतान मेटाडेटा में स्टोर किया जा रहा है
  • सुनिश्चित करें कि वेबहुक रूपांतरण सही ढंग से पेलोड को प्रारूपित कर रहा है
  • सुनिश्चित करें कि वेबहुक payment.succeeded घटनाओं पर ट्रिगर हो रहा है
  • पुष्टि करें कि आपके Dub लिंक के लिए रूपांतरण ट्रैकिंग सक्षम है
  • पुष्टि करें कि उपयोगकर्ता चेकआउट से पहले आपके Dub शॉर्ट लिंक पर क्लिक कर रहे हैं
  • सुनिश्चित करें कि dub_id कुकी आपके डोमेन पर सही ढंग से सेट की जा रही है
  • जांचें कि चेकआउट निर्माण और भुगतान पूर्णता के बीच क्लिक आईडी मेल खाती है
  • सुनिश्चित करें कि आप चेकआउट सत्र बनाने से पहले क्लिक आईडी को कैप्चर कर रहे हैं
  • सुनिश्चित करें कि JSON संरचना Dub के ट्रैक बिक्री एपीआई प्रारूप से मेल खाती है
  • जांचें कि सभी आवश्यक फ़ील्ड (clickId, externalId, amount) मौजूद हैं
  • सुनिश्चित करें कि राशि सेंट में है (पूर्णांक, दशमलव नहीं)
  • सुनिश्चित करें कि एपीआई एंडपॉइंट यूआरएल सही है: https://api.dub.co/track/sale
  • नमूना वेबहुक पेलोड के साथ रूपांतरण का परीक्षण करें
  • सुनिश्चित करें कि आप केवल payment.succeeded घटनाओं पर ट्रैक कर रहे हैं, न कि payment.processing
  • प्रत्येक बिक्री के लिए अद्वितीय invoiceId मानों का उपयोग करें
  • सदस्यताओं के लिए, नवीनीकरण पर डुप्लिकेट से बचने के लिए टाइमस्टैम्प या बिलिंग अवधि जोड़ें

​
अतिरिक्त संसाधन

Dub रूपांतरण दस्तावेज़ीकरण

Dub के रूपांतरण ट्रैकिंग और एनालिटिक्स सुविधाओं के बारे में अधिक जानें।

Dub ट्रैक बिक्री एपीआई

Dub के ट्रैक बिक्री एंडपॉइंट के लिए पूर्ण एपीआई संदर्भ देखें।

Dub डैशबोर्ड

रूपांतरण एनालिटिक्स और एट्रिब्यूशन डेटा देखने के लिए अपने Dub डैशबोर्ड तक पहुँचें।

Webhook घटनाओं का गाइड

सभी उपलब्ध Dodo Payments वेबहुक घटनाओं के बारे में जानें।
क्या आपको मदद चाहिए? इंटीग्रेशन के साथ सहायता के लिए Dodo Payments समर्थन से support@dodopayments.com पर संपर्क करें।