Attributionsanalyse

Uebersicht

Das Attributionsanalyse-Dashboard in TanStack Ship bietet umfassende Transparenz darueber, wie Ihre Marketingkanaele Konversionen und Umsatz steigern. Durch die Rueckverfolgung von Benutzerreisen zu ihren urspruenglichen UTM-Parametern — Quelle, Medium, Kampagne und Inhalt — zeigt das System, welche Kampagnen, Traffic-Quellen und Marketingkanaele die hoechste Kapitalrendite erzielen.

Als Teil der TanStack Ship Plattform verarbeitet das Attributionsanalysesystem Daten aus dem UTM-Tracking-Modul (Erfassung von Benutzerkontaktpunkten bei der Registrierung), dem Abrechnungssystem (Verfolgung konvertierender Abonnements) und dem Kurzlinksmodul (Messung der Klickdurchreich-Attribution). Diese einheitliche Sicht ermoeglicht datengesteuerte Marketingentscheidungen ueber alle Akquisitionskanaele hinweg.

Attributions-Pipeline

Das Attributionssystem fuehrt jede Konversion durch eine strukturierte Datenpipeline auf ihren Marketing-Ursprung zurueck:

Design-Philosophie

Das Attributionsanalysesystem folgt drei Kernprinzipien:

• Datengesteuerte Entscheidungsfindung — Jeder Marketing-KPI (attribuierte Konversionen, Umsatz, CPA, Konversionsrate) wird quantifiziert und visualisiert. Entscheidungen basieren auf messbaren Ergebnissen statt Intuition, was eine objektive Budgetverteilung ueber Kanaele hinweg ermoeglicht.
• Last-Touch mit First-Touch-Kontext — Das standardmaessige Last-Touch-Attributionsmodell schreibt die volle Gutschrift den aktuellsten UTM-Parametern vor der Konversion zu. First-Touch-Daten bleiben jedoch fuer den Kontext des urspruenglichen Akquisitionskanals erhalten.
• Transparente Messung — Die gesamte Attributionslogik ist deterministisch und pruefbar. Jede Konversion kann zu ihren Quellparametern zurueckverfolgt werden, was eine praezise ROI-Berechnung ermoeglicht und Black-Box-Marketinganalysen eliminiert. Im Gegensatz zu Triple Whale oder Mixpanel — die auf probabilistische Attributionsmodelle und externe Datenanreicherung setzen — verwendet unser System deterministische First-Party-Attribution auf Basis tatsaechlich erfasster UTM-Parameter an jedem Kontaktpunkt, sodass jede Kennzahl vollstaendig pruefbar ist.

Kernfunktionen

Attributions-Dashboard

Das Hauptanalyse-Dashboard unter /dashboard/admin/attribution-dashboard bietet eine umfassende Uebersicht ueber die Marketingleistung:

• KPI-Karten — Wichtige Leistungsindikatoren auf einen Blick, einschliesslich gesamter attribuierter Konversionen, attribuiertem Umsatz, durchschnittlicher Konversionsrate und Kosten pro Akquisition (CPA)
• Trenddiagramme — Liniendiagramme, die Attributionstrends ueber konfigurierbare Zeitraeume mit taeglicher, woechentlicher oder monatlicher Aggregation zeigen
• Quellenaufschlusselung — Traffic- und Konversionsverteilung nach UTM-Quelle (google, twitter, linkedin, facebook, direkt, E-Mail)
• Kampagnenrankings — Top-Leistungskampagnen nach Konversionsanzahl, gesamtem attribuiertem Umsatz und ROI-Prozentsatz
• Detaillierte Datentabelle — Granulare Attributionsdaten mit Multi-Spalten-Filterung, sortierbaren Spalten und CSV-Exportfunktion

Programmatischer Analysezugriff – Beispiel:

import { useQuery } from '@tanstack/react-query'

function AttributionMetrics() {
  const { data } = useQuery({
    queryKey: ['attribution-summary'],
    queryFn: () =>
      fetch('/api/attributions/summary').then((r) => r.json()) as Promise<{
        attributedConversions: number
        attributedRevenue: number
        avgConversionRate: number
        cpa: number
      }>,
  })

  return (
    <div className="rounded-lg border p-4">
      <h3 className="mb-3 font-semibold">Attributions-KPIs</h3>
      <dl className="grid grid-cols-2 gap-4">
        <div>
          <dt className="text-sm text-muted-foreground">Konversionen</dt>
          <dd className="text-xl font-bold">{data?.attributedConversions.toLocaleString() ?? '—'}</dd>
        </div>
        <div>
          <dt className="text-sm text-muted-foreground">Umsatz</dt>
          <dd className="text-xl font-bold">{data?.attributedRevenue.toLocaleString() ?? '—'} €</dd>
        </div>
        <div>
          <dt className="text-sm text-muted-foreground">Konv.-Rate</dt>
          <dd className="text-xl font-bold">{data?.avgConversionRate != null ? `${data.avgConversionRate}%` : '—'}</dd>
        </div>
        <div>
          <dt className="text-sm text-muted-foreground">CPA</dt>
          <dd className="text-xl font-bold">{data?.cpa.toFixed(2) ?? '—'} €</dd>
        </div>
      </dl>
    </div>
  )
}

Multi-Quellen-Attributionsberichterstattung

Attributionsdaten koennen ueber mehrere Dimensionen hinweg analysiert werden:

• UTM-Quelle — Identifizieren Sie, welche Traffic-Quellen (Suchmaschinen, Social-Media-Plattformen, Empfehlungsseiten) die wertvollsten Konversionen generieren
• UTM-Medium — Vergleichen Sie die Leistung ueber Traffic-Typen wie CPC (bezahlte Suche), Social (organische soziale Medien), E-Mail und Empfehlung
• UTM-Kampagne — Bewerten Sie die Leistung einzelner Kampagnen, um Budget auf die leistungsstaerksten Initiativen zu verteilen
• UTM-Content — Analysieren Sie spezifische Anzeigenvarianten oder Linkvarianten, um kreative Elemente auf granularer Ebene zu optimieren
• Querschnittsanalyse — Kombinieren Sie Dimensionen fuer tiefere Einblicke, wie Konversionsleistung nach Quelle × Kampagne oder Medium × Inhalt

Konversionsverfolgung ueber den Benutzerlebenszyklus

Das System verfolgt attribuierte Konversionen in jeder Phase der Benutzerreise:

• Benutzerregistrierung — Neue Benutzeranmeldungen werden den zum Zeitpunkt der Registrierung vorhandenen UTM-Parametern zugeschrieben
• Abonnementkaeufe — Wenn ein Benutzer einen kostenpflichtigen Plan abonniert, wird die Konversion der Akquisitionsquelle gutgeschrieben
• Gutschriftkaeufe — Der Kauf von Gutschriften wird als Konversionsereignis mit vollstaendigen Attributionsdetails verfolgt
• Konfigurierbare Ereignisse — Zusaetzliche Konversionsereignisse koennen definiert werden, um spezifische Geschaeftskennzahlen zu verfolgen

Jedes Konversionsereignis zeichnet die vollstaendige Attributionskette auf — urspruengliche UTM-Parameter, Benutzer-ID, Konversionstyp, Geldwert und Zeitstempel — und ermoeglicht eine genaue ROI-Berechnung pro Marketingkanal.

Trendanalyse und Leistungsvergleich

Visualisieren Sie, wie sich Attributionskennzahlen im Laufe der Zeit entwickeln, um Trends und Saisonalitaet zu identifizieren:

• Periodenvergleich — Vergleichen Sie Attributionskennzahlen zwischen zwei Datumsbereichen, um Wachstum oder Rueckgang zu messen
• Kohortenanalyse — Gruppieren Sie Konversionen nach Akquisitionszeitraum, um den langfristigen Wert pro Marketingkanal zu analysieren
• Saisonale Trenderkennung — Identifizieren Sie wiederkehrende Muster in der Kanalleistung, die mit saisonalen Ereignissen, Kampagnen und Feiertagen verbunden sind
• Benutzerdefinierte Datumsbereiche — Flexible Datumsfilterung mit Voreinstellungen fuer haeufige Zeitraeume (letzte 7 Tage, dieser Monat, letzter Monat, Quartal bis heute, Jahr bis heute)

Best Practices

Konsistente UTM-Benennungskonventionen

Etablieren und durchsetzen Sie eine konsistente UTM-Benennungskonvention ueber alle Marketinginitiativen hinweg. Standardisieren Sie Quellennamen (verwenden Sie google, nicht Google oder google.com), Medium-Klassifikationen (cpc, social, email, referral) und Kampagnenbenennungsmuster ({kanal}-{kampagne}-{datum}). Konsistenz stellt sicher, dass Attributionsdaten im Dashboard korrekt aggregiert werden, ohne fragmentierte Dimensionswerte.

Bewusstsein fuer Last-Touch-Attribution

Das System verwendet standardmaessig ein Last-Touch-Attributionsmodell, was bedeutet, dass die aktuellsten UTM-Parameter vor der Konversion die volle Gutschrift erhalten. Beachten Sie, dass dieses Modell Kanaele am unteren Ende des Trichters ueberbewerten und Markenbekanntheitsbemuehungen unterbewerten kann. Fuer ein vollstaendigeres Bild sollten Sie Attributionsdaten mit dem Kampagnen- und Angebotssystem abgleichen, um unterstuetzte Konversionen zu verstehen.

Kampagnenparameter-Hygiene

Fuegen Sie immer vollstaendige UTM-Parameter in Kampagnen-URLs ein. Eine Kampagne ohne utm_source und utm_medium wird als "direkt/keine" kategorisiert und von einer aussagekraeftigen Attributionsberichterstattung ausgeschlossen. Verwenden Sie den UTM-Builder des Kampagnenverwaltungssystems, um vollstaendige und konsistente Parametersaetze ueber alle Marketing-Links hinweg sicherzustellen.

Regelmaessige Leistungsueberpruefungen

Planen Sie regelmaessige Attributionsueberpruefungszyklen — woechentlich fuer aktive Kampagnen, monatlich fuer die strategische Planung. Verwenden Sie die Periodenvergleichsfunktion, um sowohl positive Trends (erfolgreiche Kanaloptimierungen) als auch negative Veraenderungen (nachlassende Kanalleistung oder Marktveraenderungen) zu identifizieren.

Haeufig gestellte Fragen

Wie erfasst das System UTM-Parameter? UTM-Parameter werden bei jedem Seitenaufruf ueber ein Client-Side-Skript unter src/lib/utm.ts aus URL-Abfragezeichenfolgen erfasst. Parameter bleiben mit einem standardmaessigen 30-Tage-Ablauf in Browser-Cookies erhalten und werden bei der Registrierung im Datenbankdatensatz des Benutzers gespeichert.

Welches Attributionsmodell verwendet das System? Das System verwendet standardmaessig ein Last-Touch-Attributionsmodell. Die aktuellsten UTM-Parameter, die vor einem Konversionsereignis erfasst wurden, erhalten die volle Gutschrift fuer diese Konversion. Benutzerdefinierte Attributionsmodelle koennen ueber die Attributionsdienstkonfiguration implementiert werden.

Kann ich Konversionen ueber Abonnements und Registrierungen hinaus verfolgen? Ja. Das System unterstuetzt konfigurierbare Konversionsereignisse. Sie koennen zusaetzliche Konversionstypen in der Attributionskonfiguration definieren, um spezifische Geschaeftskennzahlen wie Funktionsakzeptanz, Demo-Anfragen oder Content-Downloads zu verfolgen.

Wie weit reichen Attributionsdaten zurueck? Attributionsdaten werden auf unbestimmte Zeit in der Datenbank aufbewahrt. Das Dashboard unterstuetzt eine beliebige Datumsbereichsauswahl, sodass Sie historische Trends analysieren, Vorjahresvergleiche anstellen und langfristige Veraenderungen der Kanaleffektivitaet identifizieren koennen.

Wie behandelt das System direkten Traffic und unmarkierte Besuche? Besuche ohne UTM-Parameter werden als "direkt/keine" kategorisiert und separat verfolgt. Diese Besuche erscheinen im Dashboard als nicht zugewiesener Traffic und werden keinem Marketingkanal zugeschrieben, was Ihnen hilft, zwischen organischem und kampagnengesteuertem Wachstum zu unterscheiden.

Kann ich Attributionsdaten fuer externe Analysen exportieren? Ja. Das Dashboard enthaelt eine CSV-Exportfunktion, die gefilterte Attributionsdaten fuer externe Analysen in Tabellenkalkulationsanwendungen oder BI-Tools herunterlaedt.

Wie funktioniert die Berechnung der Kosten pro Akquisition (CPA)? Der CPA wird basierend auf konfigurierbaren Kostendaten berechnet, die pro Kampagne importiert werden koennen. Das System dividiert die gesamten Kampagnenausgaben durch attribuierte Konversionen, um CPA-Kennzahlen auf Kanal- und Kampagnenebene zu erzeugen.

Konfiguration

Das Attributionsanalyse-Dashboard ist unter /dashboard/admin/attribution-dashboard zugaenglich und erfordert:

• Aktives UTM-Tracking (standardmaessig im Root-Layout enthalten)
• Benutzerregistrierung und Konversionsereignisse mit UTM-Attributionsaufzeichnung
• Admin-Rollenzugriff auf das Attributions-Dashboard

Fuer die Kernfunktionalitaet der Attribution sind keine zusaetzlichen Umgebungsvariablen erforderlich. Fuer den Kostendatenimport unterstuetzt der Attributionsdienst einen Kampagnenkosten-Konfigurationsendpunkt unter /api/attributions/costs.

Integrationspunkte

Das Attributionsanalysesystem integriert sich mit den folgenden TanStack Ship Plattformmodulen:

• UTM-Tracking — Attributionsdaten stammen aus dem UTM-Erfassungssystem, das Benutzerkontaktpunkte bei jedem Seitenbesuch aufzeichnet
• Abrechnungssystem — Abonnementkaeufe und Zahlungsereignisse sind attribuierte Konversionen, die mit Akquisitionsquellen verbunden sind
• Kampagnenverwaltung — Kampagnenleistung wird durch Attribution gemessen und ermoeglicht die ROI-Berechnung pro Marketinginitiative
• Kurzlinks — Kurzlink-Klicks fliessen mit Klickdurchreichsraten und Konversionsattribution in die Attributionsdaten ein
• Gutschriftsystem — Guthabenkaeufe werden als sekundaere Konversionsereignisse fuer eine umfassende Umsatzattribution verfolgt
• E-Mail-Marketing — E-Mail-Kampagnen-Klickdurchreichungen und resultierende Konversionen werden durch in Kampagnenlinks eingebettete UTM-Parameter attribuiert