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 में शामिल करें।

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: Sale Data Dub को भेजें

Payments सफल होने पर sale data Dub’s Track API को भेजने के लिए 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’s Track Sale API के लिए payment data format करने हेतु transformation code edit करें।

Test & Create

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

Transformation Code Examples

Basic Sale Tracking

Payments सफल होने पर sales ट्रैक करें:

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 ट्रैक करें

Initial subscriptions और recurring payments दोनों को ट्रैक करें:

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 ट्रैक करें

Accurate revenue tracking के लिए Dub को केवल pre-tax amount भेजें:

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 ट्रैक करें

अलग-अलग प्रकार की 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 ट्रैक करना पसंद करते हैं, तो successful payment के बाद Dub’s 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 करें: Accurate attribution सुनिश्चित करने के लिए अपने checkout flow में Dub click ID को जितनी जल्दी संभव हो store करें, भले ही user page से चले जाए और बाद में वापस आए।

Metadata में हमेशा click ID शामिल करें: Click ID के बिना Dub revenue को आपके links से attribute नहीं कर सकता
External IDs का लगातार उपयोग करें: Accurate customer-level analytics के लिए वही customer ID pass करें जिसका उपयोग आप अपने system में करते हैं
Organic traffic को सही ढंग से handle करें: जब click ID न हो, तो अनावश्यक API calls से बचने के लिए webhook.cancel = true set करें
Sample payments के साथ test करें: Live जाने से पहले verify करें कि integration सही ढंग से काम कर रहा है
अपने Dub dashboard की निगरानी करें: जाँचें कि उचित attribution के साथ sales सही ढंग से दिखाई दे रही हैं

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

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

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

Sales not appearing in Dub

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

Revenue attribution not working

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

Transformation errors

Validate करें कि JSON structure Dub’s Track Sale API format से match करता है
जाँचें कि सभी required fields (clickId, externalId, amount) मौजूद हैं
सुनिश्चित करें कि amount cents में है (integer, decimal नहीं)
Verify करें कि 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 के लिए renewals पर duplicates रोकने हेतु timestamps या billing period जोड़ें

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

Dub Conversions Documentation

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

Dub Track Sale API

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

Dub Dashboard

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

Webhook Events Guide

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

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

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

परिचय

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

आवश्यकताएँ

शुरुआत करना

Implementation Guide

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

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

Transformation Code Examples

Basic Sale Tracking

Subscription Sales ट्रैक करें

Tax Exclusion के साथ Sales ट्रैक करें

Custom Event Names के साथ Sales ट्रैक करें

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

सर्वोत्तम अभ्यास

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

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

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

Dub Conversions Documentation

Dub Track Sale API

Dub Dashboard

Webhook Events Guide

​परिचय

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

​आवश्यकताएँ

​शुरुआत करना

​Implementation Guide

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

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

​Transformation Code Examples

​Basic Sale Tracking

​Subscription Sales ट्रैक करें

​Tax Exclusion के साथ Sales ट्रैक करें

​Custom Event Names के साथ Sales ट्रैक करें

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

​सर्वोत्तम अभ्यास

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

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

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

Dub Conversions Documentation

Dub Track Sale API

Dub Dashboard

Webhook Events Guide

परिचय

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

आवश्यकताएँ

शुरुआत करना

Implementation Guide

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

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

Transformation Code Examples

Basic Sale Tracking

Subscription Sales ट्रैक करें

Tax Exclusion के साथ Sales ट्रैक करें

Custom Event Names के साथ Sales ट्रैक करें

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

सर्वोत्तम अभ्यास

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

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

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