Dub

परिचय

Dub एक शक्तिशाली लिंक प्रबंधन प्लेटफ़ॉर्म है, जो आपको शॉर्ट लिंक बनाने, साझा करने और ट्रैक करने में सहायता करता है। Dodo Payments को Dub के साथ integrate करके, ग्राहक द्वारा खरीदारी पूरी करने पर sale conversion events को स्वचालित रूप से ट्रैक किया जा सकता है। इससे आप अपने marketing campaigns और referral programs के ROI को माप सकते हैं। Dub में “sale” event तब रिकॉर्ड होता है, जब कोई ग्राहक:

One-time payment पूरा करता है
Paid plan की subscription लेता है
Recurring subscription payment करता है

इस integration के लिए conversion tracking enabled वाला Dub account आवश्यक है।

Affiliate Program Integration: यह integration affiliate referrals और commissions को ट्रैक करने के लिए Dub Partners के साथ भी सहज रूप से काम करता है। अपने affiliate links से sales को attribute करने और partner performance मापने के लिए Dub’s conversion tracking का उपयोग करें। Affiliate programs सेट अप करने के बारे में हमारी Affiliates feature guide में अधिक जानें।

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

Dub एक unique click ID (dub_id) के माध्यम से visitors को ट्रैक करता है, जो users द्वारा आपके Dub short links पर क्लिक करने पर cookie में store होती है। Sales को अपने links से attribute करने के लिए आपको यह करना होगा:

Checkout sessions बनाते समय dub_id cookie से Dub’s click ID capture करें
Click ID को store करें और customer’s external ID के साथ अपने payment metadata में जोड़ें
Payments सफल होने पर उनके Track API का उपयोग करके sale data Dub को भेजें

इससे Dub successful sales को original link click से match कर पाता है और आपको complete conversion attribution मिलता है।

आवश्यकताएँ

इस integration को सेट अप करने से पहले सुनिश्चित करें कि आपके पास ये मौजूद हैं:

Workspace वाला Dub account
आपके links के लिए conversion tracking enabled
आपकी Dub API key (आपके Dub dashboard में Settings → API Keys के अंतर्गत उपलब्ध)

शुरुआत करना

Enable Conversion Tracking in Dub

अपने Dub dashboard में, जिन links के लिए sales ट्रैक करनी हैं उनके लिए conversion tracking enable करें। इससे ग्राहक द्वारा खरीदारी पूरी करने पर Dub sale events रिकॉर्ड कर सकेगा।

Conversion tracking enable करने के बारे में Dub documentation में अधिक जानें।

Get Your Dub API Key

अपने Dub dashboard पर जाएँ → Settings → API Keys और conversions.write scope वाली नई API key बनाएँ।

अपनी API key को सुरक्षित रखें और इसे client-side code में कभी expose न करें।

Capture Click ID in Checkout

Checkout session बनाते समय cookie से Dub click ID capture करें और इसे अपने payment metadata में जोड़ें।

Send Sale Data via Webhook

Payments सफल होने पर sale data Dub’s Track API को भेजने के लिए webhook configure करें।

Done!

अब sale conversion events आपके Dub analytics dashboard में आपके links के complete attribution के साथ दिखाई देंगे।

Implementation Guide

चरण 1: Checkout Metadata में Click ID और Customer ID जोड़ें

Checkout session बनाते समय cookie से Dub click ID capture करें और उसे अपने customer’s external ID के साथ payment metadata में शामिल करें।

नीचे दिए गए उदाहरण POST /payments का उपयोग करते हैं, जो deprecated है। यह मौजूदा integrations के लिए अभी भी काम करता है, लेकिन नए integrations को Checkout Sessions (POST /checkouts) का उपयोग करना चाहिए — metadata को भी इसी तरह पास किया जाता है।

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_cart: [{ product_id: productId, quantity: 1 }],
    metadata: {
      dub_click_id: dubClickId,           // Store Dub click ID
      dub_external_id: customerId,        // Store your customer's unique ID
    },
  });

  return payment;
}

const express = require('express');
const DodoPayments = require('dodopayments').default;
const router = express.Router();

const client = new DodoPayments();

router.post('/create-checkout', async (req, res) => {
  // Capture Dub click ID from cookie
  const dubClickId = req.cookies?.dub_id;

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

  res.json({ payment });
});

from fastapi import FastAPI, Request
from dodopayments import DodoPayments

app = FastAPI()
client = DodoPayments()

@app.post("/create-checkout")
async def create_checkout(request: Request):
    # Capture Dub click ID from cookie
    dub_click_id = request.cookies.get("dub_id")

    body = await request.json()

    payment = client.payments.create(
        billing={
            "city": "New York",
            "country": "US",
            "state": "NY",
            "street": "123 Main St",
            "zipcode": "10001",
        },
        customer={
            "email": body["email"],
            "name": body["name"],
        },
        product_cart=[{"product_id": body["product_id"], "quantity": 1}],
        metadata={
            "dub_click_id": dub_click_id,          # Store Dub click ID
            "dub_external_id": body["customer_id"], # Store your customer's unique ID
        },
    )

    return {"payment": payment}

package main

import (
    "context"

    "github.com/dodopayments/dodopayments-go"
)

func createCheckout(dubClickId, customerId, productId string) (*dodopayments.PaymentNewResponse, error) {
    client := dodopayments.NewClient()

    payment, err := client.Payments.New(context.Background(), dodopayments.PaymentNewParams{
        Billing: dodopayments.F(dodopayments.BillingAddressParam{
            City:    dodopayments.F("New York"),
            Country: dodopayments.F(dodopayments.CountryCodeUs),
            State:   dodopayments.F("NY"),
            Street:  dodopayments.F("123 Main St"),
            Zipcode: dodopayments.F("10001"),
        }),
        Customer: dodopayments.F[dodopayments.CustomerRequestUnionParam](
            dodopayments.NewCustomerParam{
                Email: dodopayments.F("customer@example.com"),
                Name:  dodopayments.F("John Doe"),
            },
        ),
        ProductCart: dodopayments.F([]dodopayments.OneTimeProductCartItemParam{{
            ProductID: dodopayments.F(productId),
            Quantity:  dodopayments.F(int64(1)),
        }}),
        Metadata: dodopayments.F(map[string]string{
            "dub_click_id":    dubClickId, // Store Dub click ID
            "dub_external_id": customerId, // Store your customer's unique ID
        }),
    })

    return payment, err
}

चरण 2: Dub को Sale Data भेजें

भुगतान सफल होने पर Dub के Track API को sale data भेजने के लिए एक webhook endpoint configure करें।

Open the Webhook Section

अपने Dodo Payments dashboard में Webhooks → + Add Endpoint पर जाएँ और integrations dropdown को expand करें।

Select Dub

Dub integration card चुनें।

Enter API Key

configuration field में अपनी Dub API Key दर्ज करें।

Configure Transformation

Dub के Track Sale API के लिए payment data को format करने हेतु transformation code को edit करें।

Test & Create

sample payloads के साथ test करें और integration को activate करने के लिए Create पर क्लिक करें।

Transformation Code के उदाहरण

Basic Sale Tracking

भुगतान सफल होने पर sales को track करें:

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 Sales को Track करें

प्रारंभिक subscriptions और recurring payments, दोनों को track करें:

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

Tax Exclusion के साथ Sales को Track करें

सटीक revenue tracking के लिए Dub को केवल tax से पहले की राशि भेजें:

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 Event Names के साथ Sales को Track करें

अलग-अलग प्रकार की sales को categorize करने के लिए custom event names का उपयोग करें:

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

विकल्प: Client-Side Implementation

यदि आप webhooks का उपयोग करने के बजाय अपने server से sales track करना पसंद करते हैं, तो सफल payment के बाद Dub के Track API को सीधे call कर सकते हैं:

'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,
  });
}

const { Dub } = require('dub');

const dub = new Dub();

async function trackSale(payment) {
  if (payment.metadata?.dub_click_id) {
    await dub.track.sale({
      clickId: payment.metadata.dub_click_id,
      externalId: payment.metadata.dub_external_id,
      amount: payment.total_amount,
      currency: payment.currency,
      paymentProcessor: 'dodo',
      invoiceId: payment.payment_id,
    });
  }
}

सर्वोत्तम प्रक्रियाएँ

click ID को जल्दी capture करें: सटीक attribution सुनिश्चित करने के लिए checkout flow में जितनी जल्दी संभव हो Dub click ID को store करें, भले ही user page से दूर चला जाए और बाद में वापस आए।

metadata में click ID हमेशा शामिल करें: click ID के बिना Dub आपके links से revenue को attribute नहीं कर सकता
external IDs का लगातार उपयोग करें: सटीक customer-level analytics के लिए वही customer ID पास करें जिसका उपयोग आप अपने system में करते हैं
organic traffic को उचित रूप से handle करें: जब click ID न हो, तो अनावश्यक API calls से बचने के लिए webhook.cancel = true सेट करें
sample payments के साथ test करें: live होने से पहले सत्यापित करें कि integration सही ढंग से काम कर रहा है
अपने Dub dashboard की निगरानी करें: जाँचें कि sales उचित attribution के साथ सही ढंग से दिखाई दे रही हैं

महत्वपूर्ण टिप्पणियाँ

Amount format: Dub को amounts cents में चाहिए (उदाहरण के लिए, $10.00 = 1000)
Currency: ISO 4217 currency codes (USD, EUR, GBP आदि) का उपयोग करें
Free trials: $0 payments को sales के रूप में track नहीं किया जाता
Refunds: सटीक revenue reporting के लिए आवश्यकता होने पर refunds को अलग से track करने पर विचार करें

Troubleshooting

Sales not appearing in Dub

सत्यापित करें कि आपकी Dub API key सही है और उसमें conversions.write scope है
जाँचें कि dub_click_id को capture करके payment metadata में store किया जा रहा है
सुनिश्चित करें कि webhook transformation payload को सही ढंग से format कर रहा है
सत्यापित करें कि webhook payment.succeeded events पर trigger हो रहा है
पुष्टि करें कि आपके Dub links के लिए conversion tracking enabled है

Revenue attribution not working

पुष्टि करें कि users checkout से पहले आपके Dub short links पर क्लिक कर रहे हैं
सत्यापित करें कि dub_id cookie आपके domain पर सही ढंग से set हो रही है
जाँचें कि checkout creation और payment completion के बीच click IDs मेल खाते हैं
सुनिश्चित करें कि checkout session बनाने से पहले आप click ID capture कर रहे हैं

Transformation errors

JSON structure को validate करें कि वह Dub के Track Sale API format से मेल खाता है
जाँचें कि सभी required fields (clickId, externalId, amount) मौजूद हैं
सुनिश्चित करें कि amount cents में है (integer, decimal नहीं)
सत्यापित करें कि API endpoint URL सही है: https://api.dub.co/track/sale
sample webhook payloads के साथ transformation को test करें

Duplicate sales being tracked

सुनिश्चित करें कि आप केवल payment.succeeded events पर tracking कर रहे हैं, payment.processing पर नहीं
प्रत्येक sale के लिए unique invoiceId values का उपयोग करें
subscriptions के लिए duplicates को रोकने हेतु renewals पर timestamps या billing period जोड़ें

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

Dub Conversions Documentation

Dub की conversion tracking और analytics features के बारे में अधिक जानें।

Dub Track Sale API

Dub के Track Sale endpoint के लिए complete API reference देखें।

Dub Dashboard

conversion analytics और attribution data देखने के लिए अपने Dub dashboard पर जाएँ।

Webhook Events Guide

सभी उपलब्ध Dodo Payments webhook events के बारे में जानें।

मदद चाहिए? integration में सहायता के लिए Dodo Payments support से support@dodopayments.com पर संपर्क करें।

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

परिचय

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

आवश्यकताएँ

शुरुआत करना

Implementation Guide

चरण 1: Checkout Metadata में Click ID और Customer ID जोड़ें

चरण 2: Dub को Sale Data भेजें

Transformation Code के उदाहरण

Basic Sale Tracking

Subscription Sales को Track करें

Tax Exclusion के साथ Sales को Track करें

Custom Event Names के साथ Sales को Track करें

विकल्प: Client-Side Implementation

सर्वोत्तम प्रक्रियाएँ

महत्वपूर्ण टिप्पणियाँ

Troubleshooting

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

Dub Conversions Documentation

Dub Track Sale API

Dub Dashboard

Webhook Events Guide

​परिचय

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

​आवश्यकताएँ

​शुरुआत करना

​Implementation Guide

​चरण 1: Checkout Metadata में Click ID और Customer ID जोड़ें

​चरण 2: Dub को Sale Data भेजें

​Transformation Code के उदाहरण

​Basic Sale Tracking

​Subscription Sales को Track करें

​Tax Exclusion के साथ Sales को Track करें

​Custom Event Names के साथ Sales को Track करें

​विकल्प: Client-Side Implementation

​सर्वोत्तम प्रक्रियाएँ

​महत्वपूर्ण टिप्पणियाँ

​Troubleshooting

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

Dub Conversions Documentation

Dub Track Sale API

Dub Dashboard

Webhook Events Guide

परिचय

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

आवश्यकताएँ

शुरुआत करना

Implementation Guide

चरण 1: Checkout Metadata में Click ID और Customer ID जोड़ें

चरण 2: Dub को Sale Data भेजें

Transformation Code के उदाहरण

Basic Sale Tracking

Subscription Sales को Track करें

Tax Exclusion के साथ Sales को Track करें

Custom Event Names के साथ Sales को Track करें

विकल्प: Client-Side Implementation

सर्वोत्तम प्रक्रियाएँ

महत्वपूर्ण टिप्पणियाँ

Troubleshooting

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