DataFast

परिचय

DataFast एक revenue-first analytics tool है, जो दिखाता है कि कौन से marketing channels paying customers ला रहे हैं। जब आप अपने Dodo Payments transactions को DataFast में भेजते हैं, तो यह revenue को प्रत्येक customer के original traffic source से जोड़ता है, जिससे आप देख सकते हैं कि कौन से channels और customer segments सबसे अधिक revenue generate करते हैं।

इस integration के लिए आपकी DataFast API key आवश्यक है, जिसे आप अपने DataFast dashboard में बनाते हैं।

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

DataFast प्रत्येक visitor की पहचान datafast_visitor_id cookie में stored ID से करता है। Revenue को marketing channels से जोड़ने के लिए:

DataFast की visitor ID capture करें: checkout बनाते समय datafast_visitor_id cookie से visitor ID प्राप्त करें।
Visitor ID store करें: visitor ID को payment के metadata में store करें।
Payment DataFast को भेजें: payment सफल होने पर उसके Payment API के माध्यम से payment भेजें।

DataFast प्रत्येक successful payment को visitor के original traffic source से match करता है और revenue को उस channel से attribute करता है।

प्रारंभ करना

Install DataFast Script

अपनी website पर DataFast tracking script install करें। यह script datafast_visitor_id cookie set करती है, जो प्रत्येक visitor की पहचान करती है।अपने platform के installation instructions के लिए DataFast documentation देखें।

Get Your API Key

अपने DataFast dashboard में अपनी website की settings खोलें, API पर जाएँ और Create API Key पर click करें।

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

Capture Visitor ID in Checkout

Checkout बनाते समय cookie से DataFast visitor ID पढ़ें और इसे payment के metadata में add करें। Step 1 देखें।

Send Payment Data via Webhook

एक webhook endpoint बनाएँ, जो प्रत्येक successful payment को DataFast के Payment API पर भेजे। Step 2 देखें।

Done

Revenue आपके DataFast dashboard में दिखाई देता है और उस marketing channel से attributed होता है, जो प्रत्येक customer को लेकर आया।

Implementation Guide

Step 1: Checkout Metadata में Visitor ID जोड़ें

Checkout बनाते समय cookie से DataFast visitor ID पढ़ें और इसे payment के metadata में शामिल करें।

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

import { cookies } from 'next/headers';
import { dodopayments } from '@/lib/dodopayments';

export async function createCheckout(productId: string) {
  // Capture DataFast visitor ID from cookie (cookies() is async in Next.js 15 and later)
  const datafastVisitorId = (await cookies()).get('datafast_visitor_id')?.value;

  const payment = await dodopayments.payments.create({
    product_cart: [{ product_id: productId, quantity: 1 }],
    // ... other payment configuration
    metadata: {
      datafast_visitor_id: datafastVisitorId ?? '', // Store visitor ID in metadata
    },
  });

  return payment;
}

const express = require('express');
const router = express.Router();

// dodopayments is your initialized Dodo Payments client
router.post('/create-checkout', async (req, res) => {
  // Capture DataFast visitor ID from cookie (req.cookies requires the cookie-parser middleware)
  const datafastVisitorId = req.cookies?.datafast_visitor_id;

  const payment = await dodopayments.payments.create({
    product_cart: [{ product_id: req.body.productId, quantity: 1 }],
    // ... other payment configuration
    metadata: {
      datafast_visitor_id: datafastVisitorId, // Store visitor ID in metadata
    },
  });

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

// Capture DataFast visitor ID from cookie
const datafastVisitorId = getCookie('datafast_visitor_id'); // Use your framework's cookie method

// dodopayments is your initialized Dodo Payments client, and productId is the product to sell
const payment = await dodopayments.payments.create({
  product_cart: [{ product_id: productId, quantity: 1 }],
  // ... other payment configuration
  metadata: {
    datafast_visitor_id: datafastVisitorId, // Store visitor ID in metadata
  },
});

Step 2: Payment Data DataFast को भेजें

एक webhook endpoint बनाएँ, जो successful payments को DataFast के Payment API पर भेजे।

Open the Webhook Section

Dodo Payments dashboard में Developer → Webhooks पर जाएँ और Add endpoint पर क्लिक करें।

DataFast को Integration dropdown में चुनकर Add endpoint संवाद

Select DataFast

Integration में DataFast चुनें।

Enter API Key

API key में अपनी DataFast API key पेस्ट करें। Dodo Payments इसे हर delivery के Authorization header में भेजता है।

DataFast endpoint URL भरा हुआ और API key field

Check the URL and Events

यदि Endpoint URL खाली है, तो https://datafa.st/api/v1/payments दर्ज करें। Subscribed events में payment.succeeded चुनें।

Configure Transformation

Transformation code के अंतर्गत, DataFast के Payment API के लिए payment data को format करने हेतु handler को संपादित करें। examples से शुरुआत करें।

Test & Create

Test this code के अंतर्गत, sample payload के विरुद्ध handler चलाने के लिए Simulate पर क्लिक करें। फिर Create endpoint पर क्लिक करें।

Transformation Code के उदाहरण

हर handler payment.succeeded पर चलता है। जब payment का metadata visitor ID के बिना होता है, तो यह webhook.cancel = true सेट करता है, इसलिए DataFast को कोई request नहीं भेजी जाती। रद्द की गई delivery webhook logs में फिर भी successful दिखाई देती है। DataFast का Payment API amount को major currency units में लेता है, उदाहरण के लिए 29.99। Dodo Payments total_amount को smallest currency unit में भेजता है, जैसे USD के लिए cents, इसलिए examples इसे convert करते हैं।

Basic Payment Attribution

basic_payment.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const payment = webhook.payload.data;
    
    // Only send to DataFast if visitor ID exists in metadata
    if (payment.metadata && payment.metadata.datafast_visitor_id) {
      webhook.payload = {
        amount: payment.total_amount / 100, // Convert from cents to dollars
        currency: payment.currency,
        transaction_id: payment.payment_id,
        datafast_visitor_id: payment.metadata.datafast_visitor_id,
      };
    } else {
      // Cancel dispatch if no visitor ID (prevents unnecessary API calls)
      webhook.cancel = true;
    }
  }
  return webhook;
}

Zero Decimal Currencies को संभालना

JPY जैसी zero-decimal currencies में कोई minor unit नहीं होता, इसलिए total_amount पहले से ही major units में होता है। KWD जैसी three-decimal currencies में प्रत्येक major unit के 1,000 minor units होते हैं। यह example प्रत्येक स्थिति के लिए amount को convert करता है और उन currencies का उपयोग करता है जिन्हें Dodo Payments zero-decimal और three-decimal मानता है:

zero_decimal.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const payment = webhook.payload.data;
    
    if (payment.metadata && payment.metadata.datafast_visitor_id) {
      // Zero-decimal currencies: the smallest unit is the major unit
      const zeroDecimalCurrencies = ['BIF', 'CLP', 'DJF', 'GNF', 'JPY', 'KMF', 'KRW', 'MGA', 'PYG', 'RWF', 'UGX', 'VND', 'VUV', 'XAF', 'XOF', 'XPF'];
      // Three-decimal currencies: 1 major unit = 1000 minor units
      const threeDecimalCurrencies = ['BHD', 'IQD', 'JOD', 'KWD', 'LYD', 'OMR', 'TND'];
      const isZeroDecimal = zeroDecimalCurrencies.includes(payment.currency);
      const isThreeDecimal = threeDecimalCurrencies.includes(payment.currency);
      
      webhook.payload = {
        amount: isZeroDecimal 
          ? payment.total_amount // Use amount as-is for zero decimal currencies
          : payment.total_amount / (isThreeDecimal ? 1000 : 100), // Convert from minor units
        currency: payment.currency,
        transaction_id: payment.payment_id,
        datafast_visitor_id: payment.metadata.datafast_visitor_id,
      };
    } else {
      // Cancel dispatch if no visitor ID (prevents unnecessary API calls)
      webhook.cancel = true;
    }
  }
  return webhook;
}

Subscription Payments

Subscription payments भी payment.succeeded trigger करते हैं, जिसमें subscription_id सेट होता है। यह handler हर subscription payment को DataFast को भेजता है और renewals पर renewal: true सेट करता है, ताकि DataFast renewal और first payment के बीच अंतर कर सके। Renewal को off-session charge किया जाता है, इसलिए उसके payload में subscription_id सेट होता है और checkout_session_id को null पर सेट किया जाता है। Checkout Session के माध्यम से बनाए गए subscription का first payment में checkout_session_id सेट होता है। Renewal payments में subscription का metadata होता है, इसलिए renewals को attribute करने के लिए subscription के metadata में datafast_visitor_id रखें।

subscription_payment.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const payment = webhook.payload.data;
    
    // A renewal belongs to a subscription and isn't paid through a checkout session
    const isRenewal = Boolean(payment.subscription_id) && !payment.checkout_session_id;
    
    if (payment.metadata && payment.metadata.datafast_visitor_id) {
      webhook.payload = {
        amount: payment.total_amount / 100,
        currency: payment.currency,
        transaction_id: payment.payment_id,
        datafast_visitor_id: payment.metadata.datafast_visitor_id,
        renewal: isRenewal,
      };
    } else {
      // Cancel dispatch if no visitor ID (prevents unnecessary API calls)
      webhook.cancel = true;
    }
  }
  return webhook;
}

Best Practices

Visitor ID जल्दी capture करें: अपने checkout flow में DataFast visitor ID को जितना जल्दी हो सके store करें, ताकि customer के जाने और बाद में लौटने पर भी attribution सटीक रहे।

Visitor ID को metadata में शामिल करें: Visitor ID के बिना DataFast revenue को marketing channels से attribute नहीं कर सकता।
Zero-decimal currencies को संभालें: JPY और KRW जैसी कुछ currencies में decimal places नहीं होते। उनके लिए और KWD जैसी three-decimal currencies के लिए amount conversion समायोजित करें।
Sample payments के साथ test करें: handler को Test this code के साथ चलाएँ और live होने से पहले पुष्टि करें कि integration काम करता है।
अपने DataFast dashboard की निगरानी करें: जाँचें कि payments अपेक्षित attribution के साथ दिखाई दे रहे हैं।
Webhook retries पर निर्भर रहें: DataFast ऐसे payment को skip करता है जिसका transaction_id वह पहले ही record कर चुका है, इसलिए retried delivery duplicate नहीं बनाती।

Troubleshooting

Payments Not Appearing in DataFast

पुष्टि करें कि आपकी DataFast API key सही और active है।
जाँचें कि datafast_visitor_id capture करके payment metadata में store किया गया है।
जाँचें कि webhook transformation payload को सही तरह format करता है।
पुष्टि करें कि endpoint payment.succeeded के लिए subscribed है।
Error messages या API logs के लिए DataFast dashboard देखें।
DataFast की response देखने के लिए Developer → Webhooks के Logs tab में endpoint के delivery attempts खोलें। बिना visitor ID वाला payment canceled हो जाता है और successful दिखाई देता है।

Revenue Attribution Not Working

पुष्टि करें कि DataFast tracking script आपकी website पर installed और running है।
सत्यापित करें कि datafast_visitor_id cookie set है।
जाँचें कि payment metadata में visitor ID, DataFast द्वारा visit के लिए record की गई ID से match करता है।
Checkout बनाने से पहले visitor ID capture करें।
अधिक guidance के लिए DataFast की Payment API documentation देखें।

Transformation Errors

जाँचें कि payload DataFast के Payment API format से match करता है।
जाँचें कि सभी required fields मौजूद हैं: amount, currency, और transaction_id। Attribution के लिए datafast_visitor_id शामिल करें।
Amount conversion जाँचें: अधिकांश currencies के लिए 100 से, three-decimal currencies के लिए 1,000 से divide करें और zero-decimal currencies के लिए divide न करें।
सत्यापित करें कि endpoint URL https://datafa.st/api/v1/payments है।
Sample webhook payloads के साथ transformation का test करें।

Currency Conversion Issues

Zero-decimal currencies (BIF, CLP, DJF, GNF, JPY, KMF, KRW, MGA, PYG, RWF, UGX, VND, VUV, XAF, XOF, और XPF) के लिए amount को जैसा है वैसा ही भेजें।
Three-decimal currencies (BHD, IQD, JOD, KWD, LYD, OMR, और TND) के लिए amount को 1,000 से divide करें।
अन्य सभी currencies के लिए smallest unit से major unit में convert करने हेतु amount को 100 से divide करें।
जाँचें कि currency code ISO 4217 format का उपयोग करता है, उदाहरण के लिए USD, EUR, या JPY।

Additional Resources

DataFast Documentation

DataFast के Payment API और revenue attribution के बारे में पढ़ें।

DataFast Dashboard

अपने DataFast dashboard में revenue analytics और attribution data देखें।

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

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

परिचय

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

प्रारंभ करना

Implementation Guide

Step 1: Checkout Metadata में Visitor ID जोड़ें

Step 2: Payment Data DataFast को भेजें

Transformation Code के उदाहरण

Basic Payment Attribution

Zero Decimal Currencies को संभालना

Subscription Payments

Best Practices

Troubleshooting

Additional Resources

DataFast Documentation

DataFast Dashboard

​परिचय

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

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

​Implementation Guide

​Step 1: Checkout Metadata में Visitor ID जोड़ें

​Step 2: Payment Data DataFast को भेजें

​Transformation Code के उदाहरण

​Basic Payment Attribution

​Zero Decimal Currencies को संभालना

​Subscription Payments

​Best Practices

​Troubleshooting

​Additional Resources

DataFast Documentation

DataFast Dashboard

परिचय

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

प्रारंभ करना

Implementation Guide

Step 1: Checkout Metadata में Visitor ID जोड़ें

Step 2: Payment Data DataFast को भेजें

Transformation Code के उदाहरण

Basic Payment Attribution

Zero Decimal Currencies को संभालना

Subscription Payments

Best Practices

Troubleshooting

Additional Resources