DataFast

Einführung

DataFast ist ein umsatzorientiertes Analysetool, das Ihnen hilft, herauszufinden, welche Marketingkanäle zahlende Kunden anziehen. Durch die Integration von Dodo Payments mit DataFast können Sie Einnahmen Ihren Traffic-Quellen zuordnen, wertvolle Kundensegmente identifizieren und datengestützte Entscheidungen zur Geschäftswachstum treffen.

Für diese Integration wird Ihr DataFast API-Schlüssel benötigt, den Sie in Ihrem DataFast-Dashboard erhalten können.

So funktioniert es

DataFast verfolgt Besucher über eine eindeutige Besucher-ID, die in einem Cookie gespeichert ist. Um Einnahmen Marketingkanälen zuzuordnen, müssen Sie:

Erfassen Sie die DataFast-Besucher-ID aus dem datafast_visitor_id-Cookie beim Erstellen von Checkout-Sitzungen
Speichern Sie die Besucher-ID in Ihren Zahlungs-Metadaten
Senden Sie Zahlungsdaten an DataFast, wenn Zahlungen erfolgreich sind, über deren Payment API

Dies ermöglicht es DataFast, erfolgreiche Zahlungen mit der ursprünglichen Traffic-Quelle abzugleichen, sodass Sie eine vollständige Einnahmenzuordnung erhalten.

Erste Schritte

Install DataFast Script

Installieren Sie zunächst das DataFast-Tracking-Skript auf Ihrer Website. Dadurch wird das datafast_visitor_id-Cookie erstellt, das Ihre Besucher verfolgt.Rufen Sie die DataFast-Dokumentation auf, um plattformspezifische Installationsanweisungen zu erhalten.

Get Your API Key

Melden Sie sich bei Ihrem DataFast-Dashboard an und rufen Sie Ihre Website-Einstellungen auf, um Ihren API-Schlüssel zu erhalten.

Halten Sie Ihren API-Schlüssel sicher und geben Sie ihn niemals im Client-Code preis.

Capture Visitor ID in Checkout

Erfassen Sie beim Erstellen einer Checkout-Sitzung die DataFast-Besucher-ID aus dem Cookie und fügen Sie sie Ihren Zahlungs-Metadaten hinzu.

Send Payment Data via Webhook

Konfigurieren Sie einen Webhook, um Zahlungsdaten an die Payment API von DataFast zu senden, wenn Zahlungen erfolgreich sind.

Done!

🎉 Umsatzdaten erscheinen nun in Ihrem DataFast-Dashboard mit vollständiger Zuordnung zu Marketingkanälen.

Implementierungsanleitung

Schritt 1: Besucher-ID zu Checkout-Metadaten hinzufügen

Beim Erstellen einer Checkout-Sitzung erfassen Sie die DataFast-Besucher-ID aus dem Cookie und fügen Sie sie Ihren Zahlungsmetadaten hinzu.

Die folgenden Beispiele verwenden POST /payments, das veraltet ist. Es funktioniert weiterhin für bestehende Integrationen, aber neue Integrationen sollten Checkout Sessions (POST /checkouts) verwenden — metadata wird auf dieselbe Weise übergeben.

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

Schritt 2: Zahlungsdaten an DataFast senden

Konfigurieren Sie einen Webhook-Endpunkt, um Zahlungsdaten an die Payment API von DataFast zu senden, wenn Zahlungen erfolgreich sind.

Open the Webhook Section

Navigieren Sie in Ihrem Dodo Payments-Dashboard zu Webhooks → + Add Endpoint und erweitern Sie das Dropdown-Menü für Integrationen.

Select DataFast

Wählen Sie die Integrationskarte DataFast aus.

Enter API Key

Geben Sie Ihren DataFast API Key in das Konfigurationsfeld ein.

Configure Transformation

Bearbeiten Sie den Transformationscode, um Zahlungsdaten für die Payment API von DataFast zu formatieren.

Test & Create

Testen Sie die Integration mit Beispiel-Payloads und klicken Sie auf Create, um sie zu aktivieren.

Beispiele für Transformationscode

Grundlegende Zahlungszuordnung

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

Umgang mit Währungen ohne Dezimalstellen

Einige Währungen (z. B. JPY) verwenden keine Dezimalstellen. Passen Sie die Betragsberechnung entsprechend an:

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

Abonnementzahlungen

Bei wiederkehrenden Abonnementzahlungen können Sie jede Zahlung verfolgen:

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

Best Practices

Besucher-ID frühzeitig erfassen: Speichern Sie die DataFast-Besucher-ID so früh wie möglich in Ihrem Checkout-Ablauf, um eine genaue Zuordnung sicherzustellen, auch wenn der Benutzer die Seite verlässt und später zurückkehrt.

Besucher-ID immer in Metadaten aufnehmen: Ohne die Besucher-ID kann DataFast keine Umsätze Marketingkanälen zuordnen
Währungen ohne Dezimalstellen verarbeiten: Einige Währungen (JPY, KRW usw.) verwenden keine Dezimalstellen – passen Sie die Betragsberechnung entsprechend an
Mit Beispielzahlungen testen: Überprüfen Sie vor dem Livegang, dass die Integration korrekt funktioniert
Ihr DataFast-Dashboard überwachen: Prüfen Sie, ob Zahlungen korrekt und mit der richtigen Zuordnung angezeigt werden
Webhook-Wiederholungen verwenden: Die Payment API von DataFast ist idempotent, daher sind Wiederholungen sicher, wenn ein Webhook fehlschlägt

Fehlerbehebung

Payments not appearing in DataFast

Überprüfen Sie, ob Ihr DataFast API Key korrekt und aktiv ist
Prüfen Sie, ob datafast_visitor_id erfasst und in den Zahlungsmetadaten gespeichert wird
Stellen Sie sicher, dass die Webhook-Transformation den Payload korrekt formatiert
Überprüfen Sie, ob der Webhook bei payment.succeeded-Ereignissen ausgelöst wird
Prüfen Sie das DataFast-Dashboard auf Fehlermeldungen oder API-Logs

Revenue attribution not working

Bestätigen Sie, dass das DataFast-Tracking-Skript auf Ihrer Website installiert ist und funktioniert
Überprüfen Sie, ob das Cookie datafast_visitor_id korrekt gesetzt wird
Prüfen Sie, ob die Besucher-IDs zwischen der Erstellung des Checkouts und dem Abschluss der Zahlung übereinstimmen
Stellen Sie sicher, dass Sie die Besucher-ID erfassen, bevor Sie die Checkout Session erstellen
Lesen Sie die Dokumentation zur Payment API von DataFast, um weitere Informationen zu erhalten

Transformation errors

Überprüfen Sie, ob die JSON-Struktur dem Format der Payment API von DataFast entspricht
Prüfen Sie, ob alle erforderlichen Felder (amount, currency, transaction_id, datafast_visitor_id) vorhanden sind
Stellen Sie sicher, dass der Betrag korrekt umgerechnet wird (bei den meisten Währungen durch 100 teilen, außer bei Währungen ohne Dezimalstellen)
Überprüfen Sie, ob die URL des API-Endpunkts korrekt ist: https://datafa.st/api/v1/payments
Testen Sie die Transformation mit Beispiel-Webhook-Payloads

Currency conversion issues

Senden Sie bei Währungen ohne Dezimalstellen (JPY, KRW, CLP, VND, UGX, MGA) den Betrag unverändert, ohne ihn durch 100 zu teilen
Teilen Sie bei allen anderen Währungen den Betrag durch 100, um ihn von Cent in die Basiseinheit umzurechnen
Überprüfen Sie nochmals, ob der Währungscode dem Format ISO 4217 entspricht (z. B. “USD”, “EUR”, “JPY”)

Zusätzliche Ressourcen

DataFast Documentation

Erfahren Sie mehr über die Payment API von DataFast und die Funktionen zur Umsatzzuordnung.

DataFast Dashboard

Öffnen Sie Ihr DataFast-Dashboard, um Umsatzanalysen und Zuordnungsdaten anzuzeigen.

Benötigen Sie Hilfe? Wenden Sie sich unter support@dodopayments.com an den Support von Dodo Payments, wenn Sie Unterstützung bei der Integration benötigen.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Einführung

So funktioniert es

Erste Schritte

Implementierungsanleitung

Schritt 1: Besucher-ID zu Checkout-Metadaten hinzufügen

Schritt 2: Zahlungsdaten an DataFast senden

Beispiele für Transformationscode

Grundlegende Zahlungszuordnung

Umgang mit Währungen ohne Dezimalstellen

Abonnementzahlungen

Best Practices

Fehlerbehebung

Zusätzliche Ressourcen

DataFast Documentation

DataFast Dashboard

​Einführung

​So funktioniert es

​Erste Schritte

​Implementierungsanleitung

​Schritt 1: Besucher-ID zu Checkout-Metadaten hinzufügen

​Schritt 2: Zahlungsdaten an DataFast senden

​Beispiele für Transformationscode

​Grundlegende Zahlungszuordnung

​Umgang mit Währungen ohne Dezimalstellen

​Abonnementzahlungen

​Best Practices

​Fehlerbehebung

​Zusätzliche Ressourcen

DataFast Documentation

DataFast Dashboard

Einführung

So funktioniert es

Erste Schritte

Implementierungsanleitung

Schritt 1: Besucher-ID zu Checkout-Metadaten hinzufügen

Schritt 2: Zahlungsdaten an DataFast senden

Beispiele für Transformationscode

Grundlegende Zahlungszuordnung

Umgang mit Währungen ohne Dezimalstellen

Abonnementzahlungen

Best Practices

Fehlerbehebung

Zusätzliche Ressourcen