DataFast

Introduction

DataFast est un outil d’analyse axé sur les revenus qui vous aide à découvrir quels canaux marketing génèrent des clients payants. En intégrant Dodo Payments avec DataFast, vous pouvez attribuer des revenus à vos sources de trafic, identifier des segments de clients à forte valeur et prendre des décisions basées sur les données pour développer votre entreprise.

Cette intégration nécessite votre clé API DataFast, que vous pouvez obtenir depuis votre tableau de bord DataFast.

Comment ça fonctionne

DataFast suit les visiteurs grâce à un identifiant unique de visiteur stocké dans un cookie. Pour attribuer des revenus aux canaux marketing, vous devez :

Capturez l’identifiant visiteur de DataFast à partir du cookie datafast_visitor_id lors de la création des sessions de paiement
Stockez l’ID visiteur dans vos métadonnées de paiement
Envoyez les données de paiement à DataFast lorsque les paiements aboutissent en utilisant leur API Payment

Cela permet à DataFast de faire correspondre les paiements réussis avec la source de trafic d’origine, vous offrant une attribution complète des revenus.

Prise en main

Install DataFast Script

Commencez par installer le script de suivi DataFast sur votre site web. Cela crée le cookie datafast_visitor_id qui suit vos visiteurs.Consultez la documentation DataFast pour des instructions d’installation spécifiques à votre plateforme.

Get Your API Key

Connectez-vous à votre tableau de bord DataFast et accédez aux paramètres de votre site web pour obtenir votre clé API.

Gardez votre clé API sécurisée et ne l’exposez jamais dans du code côté client.

Capture Visitor ID in Checkout

Lors de la création d’une session de paiement, capturez l’ID visiteur DataFast depuis le cookie et ajoutez-le à vos métadonnées de paiement.

Send Payment Data via Webhook

Configurez un webhook pour envoyer les données de paiement à l’API Payment de DataFast lorsque les paiements réussissent.

Done!

🎉 Les données de revenu apparaîtront désormais dans votre tableau de bord DataFast avec l’attribution complète aux canaux marketing.

Guide d’implémentation

Étape 1 : Ajouter l’identifiant de visiteur aux métadonnées de paiement

Lors de la création d’une session de paiement, capturez l’identifiant de visiteur DataFast depuis le cookie et incluez-le dans vos métadonnées de paiement.

Les exemples ci-dessous utilisent POST /payments, qui est obsolète. Il fonctionne toujours pour les intégrations existantes, mais les nouvelles intégrations doivent utiliser Checkout Sessions (POST /checkouts) — metadata lui est transmis de la même manière.

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

export async function createCheckout(productId: string) {
  // Capture DataFast visitor ID from cookie
  const datafastVisitorId = 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();

router.post('/create-checkout', async (req, res) => {
  // Capture DataFast visitor ID from cookie
  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

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

Étape 2 : Envoyer les données de paiement à DataFast

Configurez un endpoint webhook pour envoyer les données de paiement à la Payment API de DataFast lorsque les paiements sont réussis.

Open the Webhook Section

Dans votre tableau de bord Dodo Payments, accédez à Webhooks → + Add Endpoint et développez le menu déroulant des intégrations.

Select DataFast

Sélectionnez la carte d’intégration DataFast.

Enter API Key

Saisissez votre clé API DataFast dans le champ de configuration.

Configure Transformation

Modifiez le code de transformation afin de formater les données de paiement pour la Payment API de DataFast.

Test & Create

Testez avec des charges utiles d’exemple, puis cliquez sur Create pour activer l’intégration.

Exemples de code de transformation

Attribution de paiement de base

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

Gérer les devises sans décimales

Certaines devises (comme le JPY) n’utilisent pas de décimales. Ajustez le calcul du montant en conséquence :

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: JPY, KRW, CLP, etc.
      const zeroDecimalCurrencies = ['JPY', 'KRW', 'CLP', 'VND', 'UGX', 'MGA'];
      const isZeroDecimal = zeroDecimalCurrencies.includes(payment.currency);
      
      webhook.payload = {
        amount: isZeroDecimal 
          ? payment.total_amount // Use amount as-is for zero decimal currencies
          : payment.total_amount / 100, // Convert from cents for other currencies
        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;
}

Paiements d’abonnement

Pour les paiements d’abonnement récurrents, vous pouvez suivre chaque paiement :

subscription_payment.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const payment = webhook.payload.data;
    
    // Check if this is a subscription payment
    const isSubscription = payment.subscription_id !== null;
    
    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,
        // Optional: Add subscription context
        ...(isSubscription && {
          subscription_id: payment.subscription_id,
        }),
      };
    } else {
      // Cancel dispatch if no visitor ID (prevents unnecessary API calls)
      webhook.cancel = true;
    }
  }
  return webhook;
}

Bonnes pratiques

Capturez l’identifiant du visiteur rapidement : Enregistrez l’identifiant du visiteur DataFast dès que possible dans votre parcours de paiement afin de garantir une attribution précise, même si l’utilisateur quitte votre site et revient plus tard.

Incluez toujours l’identifiant du visiteur dans les métadonnées : Sans cet identifiant, DataFast ne peut pas attribuer les revenus aux canaux marketing
Gérez les devises sans décimales : Certaines devises (JPY, KRW, etc.) n’utilisent pas de décimales — ajustez le calcul du montant en conséquence
Testez avec des paiements d’exemple : Vérifiez que l’intégration fonctionne correctement avant sa mise en production
Surveillez votre tableau de bord DataFast : Vérifiez que les paiements apparaissent correctement avec une attribution appropriée
Utilisez les nouvelles tentatives des webhooks : La Payment API de DataFast est idempotente, les nouvelles tentatives sont donc sûres en cas d’échec d’un webhook

Résolution des problèmes

Payments not appearing in DataFast

Vérifiez que votre clé API DataFast est correcte et active
Vérifiez que datafast_visitor_id est bien capturé et enregistré dans les métadonnées du paiement
Assurez-vous que la transformation du webhook formate correctement la charge utile
Vérifiez que le webhook se déclenche lors des événements payment.succeeded
Consultez le tableau de bord DataFast pour voir les éventuels messages d’erreur ou journaux d’API

Revenue attribution not working

Confirmez que le script de suivi DataFast est installé et fonctionne sur votre site web
Vérifiez que le cookie datafast_visitor_id est correctement défini
Vérifiez que les identifiants des visiteurs correspondent entre la création du checkout et la finalisation du paiement
Assurez-vous de capturer l’identifiant du visiteur avant de créer la session de checkout
Consultez la documentation de la Payment API de DataFast pour obtenir des conseils supplémentaires

Transformation errors

Vérifiez que la structure JSON correspond au format de la Payment API de DataFast
Vérifiez que tous les champs obligatoires (amount, currency, transaction_id, datafast_visitor_id) sont présents
Assurez-vous que le montant est correctement converti (divisez par 100 pour la plupart des devises, sauf les devises sans décimales)
Vérifiez que l’URL de l’endpoint API est correcte : https://datafa.st/api/v1/payments
Testez la transformation avec des charges utiles webhook d’exemple

Currency conversion issues

Pour les devises sans décimales (JPY, KRW, CLP, VND, UGX, MGA), envoyez le montant tel quel sans le diviser par 100
Pour toutes les autres devises, divisez le montant par 100 afin de le convertir de centimes vers l’unité de base
Vérifiez à nouveau que le code devise respecte le format ISO 4217 (par ex. « USD », « EUR », « JPY »)

Ressources supplémentaires

DataFast Documentation

Découvrez-en davantage sur la Payment API de DataFast et ses fonctionnalités d’attribution des revenus.

DataFast Dashboard

Accédez à votre tableau de bord DataFast pour consulter les analyses de revenus et les données d’attribution.

Besoin d’aide ? Contactez le support de Dodo Payments à l’adresse support@dodopayments.com pour obtenir de l’aide concernant l’intégration.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Introduction

Comment ça fonctionne

Prise en main

Guide d’implémentation

Étape 1 : Ajouter l’identifiant de visiteur aux métadonnées de paiement

Étape 2 : Envoyer les données de paiement à DataFast

Exemples de code de transformation

Attribution de paiement de base

Gérer les devises sans décimales

Paiements d’abonnement

Bonnes pratiques

Résolution des problèmes

Ressources supplémentaires

DataFast Documentation

DataFast Dashboard

​Introduction

​Comment ça fonctionne

​Prise en main

​Guide d’implémentation

​Étape 1 : Ajouter l’identifiant de visiteur aux métadonnées de paiement

​Étape 2 : Envoyer les données de paiement à DataFast

​Exemples de code de transformation

​Attribution de paiement de base

​Gérer les devises sans décimales

​Paiements d’abonnement

​Bonnes pratiques

​Résolution des problèmes

​Ressources supplémentaires

DataFast Documentation

DataFast Dashboard

Introduction

Comment ça fonctionne

Prise en main

Guide d’implémentation

Étape 1 : Ajouter l’identifiant de visiteur aux métadonnées de paiement

Étape 2 : Envoyer les données de paiement à DataFast

Exemples de code de transformation

Attribution de paiement de base

Gérer les devises sans décimales

Paiements d’abonnement

Bonnes pratiques

Résolution des problèmes

Ressources supplémentaires