UTM-Tracking & Kampagnenattribution

Uebersicht

Das UTM-Tracking-System in TanStack Ship erfasst Marketingparameter von eingehenden Traffic-Quellen, speichert sie in Benutzersitzungen und ermoeglicht automatische Kampagnenattribution und Angebotszuordnung. Jede Benutzerreise kann bis zu ihrem urspruenglichen Marketing-Kontaktpunkt zurueckverfolgt werden, was vollstaendige Transparenz ueber den Kampagnen-ROI bietet.

Als Teil der TanStack Ship Plattform integriert sich das UTM-Modul in das Kampagnen- und Angebotssystem fuer automatische Rabattzuordnung, das Kurzlinksystem fuer verfolgbare URLs und das Attributionsanalyse-Dashboard fuer datengesteuerte Marketingentscheidungen.

UTM-Daten-Pipeline

Das Tracking-System erfasst Marketingparameter beim ersten Kontaktpunkt und begleitet sie durch den gesamten Benutzerlebenszyklus:

Design-Philosophie

Das UTM-Tracking-System basiert auf drei Designprinzipien:

• Passive Erfassung, null Reibung — UTM-Parameter werden beim Seitenladen still erfasst, ohne Benutzereingriff oder Opt-in. Das System arbeitet im Hintergrund und sammelt Attributionsdaten, ohne die Benutzererfahrung zu beeintraechtigen.
• Duales Attributionsmodell — Sowohl First-Touch (urspruenglicher Akquisitionskanal) als auch Last-Touch (Conversion-Ausloeser) werden gespeichert. Dies bietet einen vollstaendigen Ueberblick ueber die Customer Journey vom ersten Klick bis zur finalen Conversion.
• Standardmaessig datenschutzfreundlich — UTM-Daten werden als Erstanbieter-Analytik behandelt, sicher gespeichert und niemals mit Drittanbietern geteilt. Es sind keine externen Tracking-Skripte erforderlich — alles geschieht innerhalb der eigenen Infrastruktur der Plattform. Im Gegensatz zu Google Analytics oder HubSpot — die das Einbetten von Third-Party-JavaScript-Tags erfordern und auf externe Cookie-Synchronisation fuer geraeteuebergreifende Attribution angewiesen sind — laeuft unsere UTM-Erfassung vollstaendig auf Ihrer eigenen Infrastruktur mit First-Party-Cookies, sodass alle Marketingdaten unter Ihrer Kontrolle bleiben.

Kernfunktionen

UTM-Parametererfassung

Das System verwendet einen SSR-Streaming-Ansatz, um UTM-Parameter vor der Seitenhydrierung zu erfassen und sicherzustellen, dass keine Attributionsdaten verloren gehen:

• Erfasste Parameter — utm_source, utm_medium, utm_campaign, utm_term, utm_content
• Client-Erfassung — Beim Seitenladen ueber Frontend-Code
• Server-Erfassung — Auch serverseitig waehrend des initialen SSR fuer vollstaendige Zuverlaessigkeit
• Referrer-Tracking — HTTP-Referrer-Header wird zusammen mit UTM-Daten erfasst

Der duale Erfassungsmechanismus (Client + Server) stellt sicher, dass Attributionsdaten selbst in Grenzfaellen wie deaktiviertem JavaScript oder langsamer Hydrierung aufgezeichnet werden.

Clientseitiger UTM-Zugriff – Beispiel:

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

function CampaignBanner() {
  const { data } = useQuery({
    queryKey: ['utm-attribution'],
    queryFn: () =>
      fetch('/api/utm/session').then((r) => r.json()) as Promise<{
        utmSource: string | null
        utmMedium: string | null
        utmCampaign: string | null
      }>,
  })

  if (!data?.utmCampaign) return null

  return (
    <div className="rounded-md bg-gradient-to-r from-primary/10 to-primary/5 p-4 text-center">
      <p>Willkommen! Sie haben uns ueber {data.utmSource} gefunden.</p>
      <p className="text-muted-foreground text-sm">
        Kampagne: {data.utmCampaign}
      </p>
    </div>
  )
}

UTM-Speicherung & Persistenz

Nach der Erfassung werden UTM-Daten:

• Im Datenbankdatensatz des Benutzers als First-Touch- und Last-Touch-Attribution gespeichert
• Mit zukuenftigen Conversions (Abonnements, Kaeufe) verknuepft
• Fuer historische Analysen im Admin-Dashboard verfuegbar
• Von der Preis-Engine fuer automatische Angebotszuordnung verwendet

UTM-Builder-Tool

Das UTM-Builder-Tool bietet eine benutzerfreundliche Oberflaeche zur Erstellung von Kampagnen-URLs:

1. Geben Sie Ihre Ziel-URL ein
2. Fuellen Sie UTM-Parameter aus (Quelle, Medium, Kampagne, Begriff, Inhalt)
3. Optional: URL mit dem Kurzlinksystem verkuerzen
4. Vorschau anzeigen und die endgueltige URL zur Verteilung kopieren

Der Builder validiert UTM-Parameterformate und bietet empfohlene Namenskonventionen.

Kampagnenattributionsanalyse

Das Attributions-Dashboard bietet umfassende Berichterstattung:

• Traffic-Aufschluesselung nach Quelle, Medium und Kampagne
• Conversion-Raten pro Marketingkanal
• Umsatz pro Kampagne mit First-Touch- und Last-Touch-Modellen
• Top-Kampagnen nach ROI sortiert
• Klick- und Conversion-Trichter

Best Practices

Konsistente UTM-Benennung

Verwenden Sie eine konsistente Namenskonvention: Quelle_Medium_Kampagne (z. B. twitter_social_sommer2024). Dies ermoeglicht bessere Filterung und Berichterstattung im Analyse-Dashboard.

First-Touch und Last-Touch

Verfolgen Sie sowohl First-Touch (urspruenglicher Akquisitionskanal) als auch Last-Touch (Conversion-Kanal) Attribution. Das System speichert beide fuer eine vollstaendige Kampagnenanalyse.

UTM-Parameter-Bloat vermeiden

Beschraenken Sie UTM-Parameter auf die fuenf wesentlichen (source, medium, campaign, term, content). Die uebermaessige Verwendung benutzerdefinierter Parameter reduziert die Berichtsuebersichtlichkeit.

Haeufig gestellte Fragen

Wie erfasst das System UTM-Parameter? UTM-Parameter werden clientseitig ueber JavaScript und serverseitig waehrend SSR erfasst. Der duale Ansatz stellt sicher, dass Parameter selbst in Grenzfaellen aufgezeichnet werden.

Werden UTM-Parameter dauerhaft gespeichert? Ja, einmal erfasste UTM-Daten werden im Datenbankdatensatz des Benutzers gespeichert und mit allen zukuenftigen Conversions verknuepft.

Kann ich UTM-Parameter fuer automatische Rabatte verwenden? Ja. In Kombination mit dem Kampagnen- und Angebotssystem koennen UTM-Parameter automatische Rabattzuordnung waehrend des Checkouts ausloesen.

Ist das UTM-Tracking-System mit TanStack Ship kompatibel? Ja. Das UTM-Tracking-Modul ist vollstaendig kompatibel mit TanStack Ship fuer die Produktionsbereitstellung. Als leichte Alternative zu Next.js und Remix fuer Serverless-Edge-Deployment minimiert TanStack Ship den Bundle-Overhead bei voller Typsicherheit.

Konfiguration

UTM-Tracking funktioniert sofort — keine spezielle Konfiguration erforderlich. Die UTM-Erfassungskomponente ist im Root-Layout enthalten und aktiviert sich automatisch.

Fuer UTM-basiertes Angebots-Matching konfigurieren Sie Kampagnen im Admin-Dashboard mit dem gewuenschten Angebot und UTM-Parametern.

Integrationspunkte

• Kampagnen & Angebote — UTM-Parameter loesen automatische Angebotszuordnung ueber die Preis-Engine aus
• Kurzlinks — UTM-Parameter koennen in Kurzlink-URLs eingebettet werden
• Attributionsanalyse — Vollstaendiges Attributions-Dashboard mit Umsatzverfolgung
• Klickanalyse — Verfolgen Sie Klickraten auf Kampagnenlinks