DataFast

Introdução

O DataFast é uma ferramenta de análise focada em receita que ajuda você a descobrir quais canais de marketing geram clientes pagantes. Ao integrar o Dodo Payments com o DataFast, você pode atribuir receita às suas fontes de tráfego, identificar segmentos de clientes de alto valor e tomar decisões baseadas em dados para crescer seu negócio.

Esta integração exige sua chave de API do DataFast, que você pode obter no seu painel do DataFast.

Como Funciona

O DataFast rastreia visitantes através de um ID de visitante único armazenado em um cookie. Para atribuir receita a canais de marketing, você precisa:

Capture o ID do visitante do DataFast do cookie datafast_visitor_id ao criar sessões de checkout
Armazene o ID do visitante nos metadados do pagamento
Envie os dados do pagamento ao DataFast quando os pagamentos forem bem-sucedidos usando a API de Pagamentos deles

Isso permite que o DataFast associe pagamentos bem-sucedidos à fonte de tráfego original, fornecendo a você uma atribuição de receita completa.

Começando

Install DataFast Script

Primeiro, instale o script de rastreamento do DataFast no seu site. Isso cria o cookie datafast_visitor_id que rastreia os visitantes.Consulte a documentação do DataFast para obter instruções de instalação específicas da sua plataforma.

Get Your API Key

Faça login no seu painel do DataFast e navegue até as configurações do seu site para obter sua chave de API.

Mantenha sua chave de API segura e nunca a exponha em código do lado do cliente.

Capture Visitor ID in Checkout

Ao criar uma sessão de checkout, capture o ID do visitante do DataFast do cookie e adicione-o aos metadados do pagamento.

Send Payment Data via Webhook

Configure um webhook para enviar dados de pagamento à API de Pagamentos do DataFast quando os pagamentos forem bem-sucedidos.

Done!

🎉 Os dados de receita agora aparecerão no seu painel do DataFast com atribuição completa aos canais de marketing.

Guia de Implementação

Passo 1: Adicionar ID do Visitante aos Metadados do Checkout

Ao criar uma sessão de checkout, capture o ID do visitante do DataFast do cookie e inclua-o em seus metadados de pagamento.

Os exemplos abaixo usam POST /payments, que está obsoleto. Ele ainda funciona para integrações existentes, mas novas integrações devem usar Checkout Sessions (POST /checkouts) — metadata é enviado da mesma forma.

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

Etapa 2: Envie os dados de pagamento para o DataFast

Configure um endpoint de webhook para enviar dados de pagamento à Payment API do DataFast quando os pagamentos forem concluídos com sucesso.

Open the Webhook Section

No dashboard do Dodo Payments, acesse Webhooks → + Add Endpoint e expanda o menu suspenso de integrações.

Select DataFast

Selecione o cartão de integração do DataFast.

Enter API Key

Informe sua DataFast API Key no campo de configuração.

Configure Transformation

Edite o código de transformação para formatar os dados de pagamento para a Payment API do DataFast.

Test & Create

Teste com payloads de exemplo e clique em Create para ativar a integração.

Exemplos de código de transformação

Atribuição básica de pagamento

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

Como lidar com moedas sem casas decimais

Algumas moedas (como JPY) não usam casas decimais. Ajuste o cálculo do valor de acordo com isso:

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

Pagamentos de assinaturas

Para pagamentos recorrentes de assinaturas, você pode acompanhar cada pagamento:

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

Práticas recomendadas

Capture o visitor ID antecipadamente: Armazene o visitor ID do DataFast o mais cedo possível no fluxo de checkout para garantir uma atribuição precisa, mesmo que o usuário saia e retorne mais tarde.

Sempre inclua o visitor ID nos metadados: Sem o visitor ID, o DataFast não consegue atribuir a receita aos canais de marketing
Lide com moedas sem casas decimais: Algumas moedas (JPY, KRW etc.) não usam casas decimais — ajuste o cálculo do valor de acordo com isso
Teste com pagamentos de exemplo: Verifique se a integração funciona corretamente antes de entrar em produção
Monitore seu dashboard do DataFast: Verifique se os pagamentos estão sendo exibidos corretamente com a atribuição adequada
Use novas tentativas de webhook: A Payment API do DataFast é idempotente, portanto, novas tentativas são seguras se um webhook falhar

Solução de problemas

Payments not appearing in DataFast

Verifique se sua DataFast API key está correta e ativa
Verifique se datafast_visitor_id está sendo capturado e armazenado nos metadados do pagamento
Certifique-se de que a transformação do webhook está formatando o payload corretamente
Verifique se o webhook está sendo acionado em eventos payment.succeeded
Verifique o dashboard do DataFast para identificar mensagens de erro ou registros da API

Revenue attribution not working

Confirme se o script de rastreamento do DataFast está instalado e funcionando no seu site
Verifique se o cookie datafast_visitor_id está sendo definido corretamente
Verifique se os visitor IDs correspondem entre a criação do checkout e a conclusão do pagamento
Certifique-se de capturar o visitor ID antes de criar a sessão de checkout
Consulte a documentação da Payment API do DataFast para obter orientações adicionais

Transformation errors

Valide se a estrutura JSON corresponde ao formato da Payment API do DataFast
Verifique se todos os campos obrigatórios (amount, currency, transaction_id, datafast_visitor_id) estão presentes
Certifique-se de que o valor foi convertido corretamente (divida por 100 para a maioria das moedas, exceto as moedas sem casas decimais)
Verifique se a URL do endpoint da API está correta: https://datafa.st/api/v1/payments
Teste a transformação com payloads de webhook de exemplo

Currency conversion issues

Para moedas sem casas decimais (JPY, KRW, CLP, VND, UGX, MGA), envie o valor como está, sem dividi-lo por 100
Para todas as outras moedas, divida o valor por 100 para convertê-lo de centavos para a unidade básica
Verifique novamente se o código da moeda corresponde ao formato ISO 4217 (por exemplo, “USD”, “EUR”, “JPY”)

Recursos adicionais

DataFast Documentation

Saiba mais sobre a Payment API do DataFast e os recursos de atribuição de receita.

DataFast Dashboard

Acesse seu dashboard do DataFast para visualizar análises de receita e dados de atribuição.

Precisa de ajuda? Entre em contato com o suporte do Dodo Payments pelo endereço support@dodopayments.com para obter assistência com a integração.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Introdução

Como Funciona

Começando

Guia de Implementação

Passo 1: Adicionar ID do Visitante aos Metadados do Checkout

Etapa 2: Envie os dados de pagamento para o DataFast

Exemplos de código de transformação

Atribuição básica de pagamento

Como lidar com moedas sem casas decimais

Pagamentos de assinaturas

Práticas recomendadas

Solução de problemas

Recursos adicionais

DataFast Documentation

DataFast Dashboard

​Introdução

​Como Funciona

​Começando

​Guia de Implementação

​Passo 1: Adicionar ID do Visitante aos Metadados do Checkout

​Etapa 2: Envie os dados de pagamento para o DataFast

​Exemplos de código de transformação

​Atribuição básica de pagamento

​Como lidar com moedas sem casas decimais

​Pagamentos de assinaturas

​Práticas recomendadas

​Solução de problemas

​Recursos adicionais

DataFast Documentation

DataFast Dashboard

Introdução

Como Funciona

Começando

Guia de Implementação

Passo 1: Adicionar ID do Visitante aos Metadados do Checkout

Etapa 2: Envie os dados de pagamento para o DataFast

Exemplos de código de transformação

Atribuição básica de pagamento

Como lidar com moedas sem casas decimais

Pagamentos de assinaturas

Práticas recomendadas

Solução de problemas

Recursos adicionais