DataFast

소개

DataFast는 유료 고객을 유도하는 마케팅 채널을 발견하는 데 도움을 주는 수익 중심의 분석 도구입니다. Dodo Payments와 DataFast를 통합하면 트래픽 소스에 수익을 귀속시키고, 고가치 고객 세그먼트를 식별하며, 데이터 기반 결정을 통해 비즈니스를 성장시킬 수 있습니다.

이 통합을 사용하려면 DataFast API 키가 필요하며, DataFast 대시보드에서 얻을 수 있습니다.

작동 방식

DataFast는 쿠키에 저장된 고유 방문자 ID를 통해 방문자를 추적합니다. 마케팅 채널에 수익을 귀속시키려면 다음을 수행해야 합니다:

체크아웃 세션을 생성할 때 datafast_visitor_id 쿠키에서 DataFast 방문자 ID를 캡처합니다
결제 메타데이터에 방문자 ID를 저장합니다
결제가 성공하면 DataFast의 Payment API를 사용하여 결제 데이터를 DataFast로 전송합니다

이렇게 하면 DataFast가 성공적인 결제를 원래의 트래픽 소스와 일치시킬 수 있어 완전한 수익 귀속이 가능합니다.

시작하기

Install DataFast Script

먼저 웹사이트에 DataFast 추적 스크립트를 설치합니다. 이렇게 하면 방문자를 추적하는 datafast_visitor_id 쿠키가 생성됩니다.플랫폼별 설치 지침은 DataFast 문서를 참조하세요.

Get Your API Key

DataFast 대시보드에 로그인한 다음 웹사이트 설정으로 이동하여 API 키를 얻습니다.

API 키를 안전하게 보관하고 클라이언트 측 코드에 절대 노출하지 마세요.

Capture Visitor ID in Checkout

체크아웃 세션을 생성할 때 쿠키에서 DataFast 방문자 ID를 가져와 결제 메타데이터에 추가하세요.

Send Payment Data via Webhook

결제가 성공할 때 DataFast의 Payment API로 결제 데이터를 전송하도록 웹후크를 구성하세요.

Done!

🎉 이제 수익 데이터가 마케팅 채널에 대한 전체 귀속 정보와 함께 DataFast 대시보드에 표시됩니다.

구현 가이드

1단계: 체크아웃 메타데이터에 방문자 ID 추가

체크아웃 세션을 생성할 때 쿠키에서 DataFast 방문자 ID를 캡처하고 결제 메타데이터에 포함시킵니다.

아래 예시에서는 POST /payments를 사용하는데, 이는 deprecated입니다. 기존 통합에서는 여전히 작동하지만, 새 통합에서는 Checkout Sessions(POST /checkouts)을 사용해야 합니다. — metadata는 동일한 방식으로 전달됩니다.

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

2단계: DataFast로 결제 데이터 전송

결제가 성공하면 결제 데이터를 DataFast의 Payment API로 전송하도록 webhook endpoint를 구성합니다.

Open the Webhook Section

Dodo Payments 대시보드에서 Webhooks → + Add Endpoint로 이동한 다음 integrations 드롭다운을 펼칩니다.

Select DataFast

DataFast integration card를 선택합니다.

Enter API Key

구성 필드에 DataFast API Key를 입력합니다.

Configure Transformation

DataFast의 Payment API에 맞게 결제 데이터 형식을 지정하도록 transformation code를 편집합니다.

Test & Create

샘플 payload로 테스트한 다음 Create를 클릭하여 통합을 활성화합니다.

Transformation Code 예시

기본 결제 귀속

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

소수점 없는 통화 처리

일부 통화(예: JPY)는 소수점 단위를 사용하지 않습니다. 이에 따라 금액 계산을 조정하세요:

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

Subscription 결제

반복되는 subscription 결제의 경우 각 결제를 추적할 수 있습니다:

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

모범 사례

visitor ID를 일찍 캡처: 정확한 귀속을 보장하려면 checkout flow에서 가능한 한 빨리 DataFast visitor ID를 저장하세요. 사용자가 페이지를 떠났다가 나중에 다시 방문하는 경우에도 정확한 귀속을 유지할 수 있습니다.

항상 metadata에 visitor ID 포함: visitor ID가 없으면 DataFast가 수익을 marketing channel에 귀속할 수 없습니다
소수점 없는 통화 처리: 일부 통화(JPY, KRW 등)는 소수점 단위를 사용하지 않으므로 금액 계산을 그에 맞게 조정하세요
샘플 결제로 테스트: 운영을 시작하기 전에 통합이 올바르게 작동하는지 확인하세요
DataFast 대시보드 모니터링: 적절한 귀속과 함께 결제가 올바르게 표시되는지 확인하세요
webhook 재시도 사용: DataFast의 Payment API는 idempotent하므로 webhook이 실패해도 재시도해도 안전합니다

문제 해결

Payments not appearing in DataFast

DataFast API key가 올바르고 활성 상태인지 확인하세요
datafast_visitor_id가 캡처되어 payment metadata에 저장되는지 확인하세요
webhook transformation이 payload 형식을 올바르게 지정하는지 확인하세요
webhook이 payment.succeeded events에서 트리거되는지 확인하세요
DataFast 대시보드에서 오류 메시지나 API 로그를 확인하세요

Revenue attribution not working

DataFast tracking script가 웹사이트에 설치되어 정상적으로 작동하는지 확인하세요
datafast_visitor_id cookie가 올바르게 설정되는지 확인하세요
checkout creation과 payment completion 간 visitor ID가 일치하는지 확인하세요
checkout session을 생성하기 전에 visitor ID를 캡처하고 있는지 확인하세요
추가 지침은 DataFast의 Payment API documentation을 참조하세요

Transformation errors

JSON 구조가 DataFast의 Payment API 형식과 일치하는지 확인하세요
필요한 모든 필드(amount, currency, transaction_id, datafast_visitor_id)가 포함되어 있는지 확인하세요
amount가 올바르게 변환되는지 확인하세요(소수점 없는 통화를 제외한 대부분의 통화는 100으로 나눔)
API endpoint URL이 올바른지 확인하세요: https://datafa.st/api/v1/payments
샘플 webhook payload로 transformation을 테스트하세요

Currency conversion issues

소수점 없는 통화(JPY, KRW, CLP, VND, UGX, MGA)는 100으로 나누지 말고 금액을 그대로 전송하세요
그 외 모든 통화는 cents에서 기본 단위로 변환하기 위해 금액을 100으로 나누세요
통화 코드가 ISO 4217 형식(예: “USD”, “EUR”, “JPY”)과 일치하는지 다시 확인하세요

추가 리소스

DataFast Documentation

DataFast의 Payment API와 revenue attribution 기능에 대해 자세히 알아보세요.

DataFast Dashboard

DataFast 대시보드에 액세스하여 revenue analytics 및 attribution 데이터를 확인하세요.

도움이 필요하신가요? 통합과 관련한 지원이 필요하면 support@dodopayments.com으로 Dodo Payments 지원팀에 문의하세요.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

소개

작동 방식

시작하기

구현 가이드

1단계: 체크아웃 메타데이터에 방문자 ID 추가

2단계: DataFast로 결제 데이터 전송

Transformation Code 예시

기본 결제 귀속

소수점 없는 통화 처리

Subscription 결제

모범 사례

문제 해결

추가 리소스

DataFast Documentation

DataFast Dashboard

​소개

​작동 방식

​시작하기

​구현 가이드

​1단계: 체크아웃 메타데이터에 방문자 ID 추가

​2단계: DataFast로 결제 데이터 전송

​Transformation Code 예시

​기본 결제 귀속

​소수점 없는 통화 처리

​Subscription 결제

​모범 사례

​문제 해결

​추가 리소스

DataFast Documentation

DataFast Dashboard

소개

작동 방식

시작하기

구현 가이드

1단계: 체크아웃 메타데이터에 방문자 ID 추가

2단계: DataFast로 결제 데이터 전송

Transformation Code 예시

기본 결제 귀속

소수점 없는 통화 처리

Subscription 결제

모범 사례

문제 해결

추가 리소스