DataFast

Pendahuluan

DataFast adalah alat analitik yang mengutamakan pendapatan yang membantu Anda menemukan saluran pemasaran mana yang mengarahkan pelanggan yang membayar. Dengan mengintegrasikan Dodo Payments dengan DataFast, Anda dapat mengatributkan pendapatan ke sumber lalu lintas Anda, mengidentifikasi segmen pelanggan bernilai tinggi, dan membuat keputusan berbasis data untuk mengembangkan bisnis Anda.

Integrasi ini membutuhkan Kunci API DataFast Anda, yang dapat Anda peroleh dari dashboard DataFast.

Cara Kerjanya

DataFast melacak pengunjung melalui ID pengunjung unik yang disimpan dalam cookie. Untuk mengatributkan pendapatan ke saluran pemasaran, Anda perlu:

Ambil ID pengunjung DataFast dari cookie datafast_visitor_id saat membuat sesi checkout
Simpan ID pengunjung di metadata pembayaran Anda
Kirim data pembayaran ke DataFast saat pembayaran berhasil melalui API Pembayaran mereka

Ini memungkinkan DataFast untuk mencocokkan pembayaran yang berhasil dengan sumber lalu lintas asli, memberikan Anda atribusi pendapatan yang lengkap.

Memulai

Install DataFast Script

Pertama, pasang skrip pelacakan DataFast di situs web Anda. Ini akan membuat cookie datafast_visitor_id yang melacak pengunjung Anda.Kunjungi dokumentasi DataFast untuk petunjuk instalasi sesuai platform Anda.

Get Your API Key

Masuk ke dashboard DataFast Anda dan buka pengaturan situs web untuk mendapatkan kunci API Anda.

Jaga kunci API Anda tetap aman dan jangan pernah mengeksposnya di kode sisi klien.

Capture Visitor ID in Checkout

Saat membuat sesi checkout, ambil ID pengunjung DataFast dari cookie dan tambahkan ke metadata pembayaran Anda.

Send Payment Data via Webhook

Konfigurasikan webhook untuk mengirim data pembayaran ke API Pembayaran DataFast saat pembayaran berhasil.

Done!

🎉 Data pendapatan kini akan muncul di dashboard DataFast Anda dengan atribusi penuh ke saluran pemasaran.

Panduan Implementasi

Langkah 1: Tambahkan ID Pengunjung ke Metadata Checkout

Saat membuat sesi checkout, tangkap ID pengunjung DataFast dari cookie dan sertakan dalam metadata pembayaran Anda.

Contoh-contoh di bawah menggunakan POST /payments, yang sudah deprecated. Ini masih berfungsi untuk integrasi yang sudah ada, tetapi integrasi baru sebaiknya menggunakan Checkout Sessions (POST /checkouts) — metadata diteruskan dengan cara yang sama.

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

Langkah 2: Kirim Data Pembayaran ke DataFast

Konfigurasikan endpoint webhook untuk mengirim data pembayaran ke Payment API DataFast saat pembayaran berhasil.

Open the Webhook Section

Di dashboard Dodo Payments, buka Webhooks → + Add Endpoint, lalu perluas dropdown integrasi.

Select DataFast

Pilih kartu integrasi DataFast.

Enter API Key

Masukkan DataFast API Key Anda di kolom konfigurasi.

Configure Transformation

Edit kode transformasi untuk memformat data pembayaran untuk Payment API DataFast.

Test & Create

Uji dengan payload sampel dan klik Create untuk mengaktifkan integrasi.

Contoh Kode Transformasi

Atribusi Pembayaran Dasar

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

Menangani Mata Uang Tanpa Desimal

Beberapa mata uang (seperti JPY) tidak menggunakan tempat desimal. Sesuaikan penghitungan jumlahnya sebagaimana mestinya:

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

Pembayaran Langganan

Untuk pembayaran langganan berulang, Anda dapat melacak setiap pembayaran:

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

Praktik Terbaik

Catat visitor ID lebih awal: Simpan visitor ID DataFast sesegera mungkin dalam alur checkout Anda untuk memastikan atribusi yang akurat, meskipun pengguna meninggalkan halaman lalu kembali lagi nanti.

Selalu sertakan visitor ID dalam metadata: Tanpa visitor ID, DataFast tidak dapat mengatribusikan pendapatan ke channel pemasaran
Tangani mata uang tanpa desimal: Beberapa mata uang (JPY, KRW, dan lainnya) tidak menggunakan tempat desimal—sesuaikan penghitungan jumlahnya
Uji dengan pembayaran sampel: Pastikan integrasi berfungsi dengan benar sebelum digunakan di production
Pantau dashboard DataFast Anda: Periksa apakah pembayaran muncul dengan benar dan memiliki atribusi yang sesuai
Gunakan webhook retries: Payment API DataFast bersifat idempotent, sehingga retry aman dilakukan jika webhook gagal

Pemecahan Masalah

Payments not appearing in DataFast

Pastikan DataFast API key Anda benar dan aktif
Periksa apakah datafast_visitor_id telah diambil dan disimpan dalam metadata pembayaran
Pastikan transformasi webhook memformat payload dengan benar
Pastikan webhook terpicu pada event payment.succeeded
Periksa dashboard DataFast untuk melihat pesan error atau log API

Revenue attribution not working

Pastikan tracking script DataFast terpasang dan berfungsi di situs web Anda
Pastikan cookie datafast_visitor_id disetel dengan benar
Periksa apakah visitor ID cocok antara pembuatan checkout dan penyelesaian pembayaran
Pastikan Anda mengambil visitor ID sebelum membuat checkout session
Tinjau dokumentasi Payment API DataFast untuk panduan tambahan

Transformation errors

Validasi bahwa struktur JSON sesuai dengan format Payment API DataFast
Pastikan semua field yang diperlukan (amount, currency, transaction_id, datafast_visitor_id) tersedia
Pastikan amount dikonversi dengan benar (bagi dengan 100 untuk sebagian besar mata uang, kecuali mata uang tanpa desimal)
Pastikan URL endpoint API sudah benar: https://datafa.st/api/v1/payments
Uji transformasi dengan payload webhook sampel

Currency conversion issues

Untuk mata uang tanpa desimal (JPY, KRW, CLP, VND, UGX, MGA), kirim amount apa adanya tanpa membaginya dengan 100
Untuk semua mata uang lainnya, bagi amount dengan 100 untuk mengonversinya dari sen ke unit dasar
Periksa kembali apakah kode mata uang sesuai dengan format ISO 4217 (misalnya, “USD”, “EUR”, “JPY”)

Sumber Daya Tambahan

DataFast Documentation

Pelajari lebih lanjut tentang Payment API DataFast dan fitur atribusi pendapatannya.

DataFast Dashboard

Akses dashboard DataFast Anda untuk melihat analitik pendapatan dan data atribusi.

Butuh bantuan? Hubungi dukungan Dodo Payments di support@dodopayments.com untuk mendapatkan bantuan terkait integrasi.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pendahuluan

Cara Kerjanya

Memulai

Panduan Implementasi

Langkah 1: Tambahkan ID Pengunjung ke Metadata Checkout

Langkah 2: Kirim Data Pembayaran ke DataFast

Contoh Kode Transformasi

Atribusi Pembayaran Dasar

Menangani Mata Uang Tanpa Desimal

Pembayaran Langganan

Praktik Terbaik

Pemecahan Masalah

Sumber Daya Tambahan

DataFast Documentation

DataFast Dashboard

​Pendahuluan

​Cara Kerjanya

​Memulai

​Panduan Implementasi

​Langkah 1: Tambahkan ID Pengunjung ke Metadata Checkout

​Langkah 2: Kirim Data Pembayaran ke DataFast

​Contoh Kode Transformasi

​Atribusi Pembayaran Dasar

​Menangani Mata Uang Tanpa Desimal

​Pembayaran Langganan

​Praktik Terbaik

​Pemecahan Masalah

​Sumber Daya Tambahan

DataFast Documentation

DataFast Dashboard

Pendahuluan

Cara Kerjanya

Memulai

Panduan Implementasi

Langkah 1: Tambahkan ID Pengunjung ke Metadata Checkout

Langkah 2: Kirim Data Pembayaran ke DataFast

Contoh Kode Transformasi

Atribusi Pembayaran Dasar

Menangani Mata Uang Tanpa Desimal

Pembayaran Langganan

Praktik Terbaik

Pemecahan Masalah

Sumber Daya Tambahan