Kurzlinks

Uebersicht

Das Kurzlinksystem in TanStack Ship bietet markenbezogene, verfolgbare Kurz-URLs, die in Marketingkampagnen, sozialen Medien und Offline-Materialien verwendet werden koennen. Jeder Link verfolgt Klicks, eindeutige Besucher, Geodaten und UTM-Attribution — und gibt Ihnen vollstaendige Transparenz ueber die Linkleistung.

Als Teil der TanStack Ship Plattform integrieren sich Kurzlinks in das UTM-Tracking-System fuer Kampagnenattribution, das Kampagnen- und Angebotssystem fuer die Verteilung und das Analyse-Dashboard fuer die Klickberichterstattung.

Design-Ablauf

Das Kurzlinksystem verwaltet den gesamten Linklebenszyklus von der Erstellung ueber die Weiterleitung bis zur Analyseberichterstattung:

Kernfunktionen

Linkerstellung & -verwaltung

Erstellen Sie Kurzlinks ueber das Admin-Dashboard (/dashboard/admin/short-links):

• Benutzerdefinierter Alias — Definieren Sie Ihren eigenen Kurzpfad (z. B. go.yourdomain.com/sommer)
• Automatisch generieren — System generiert automatisch einen eindeutigen Kurzcode
• Ziel-URL — Die vollstaendige URL, zu der weitergeleitet werden soll
• UTM-Parameter — Integrierter UTM-Builder fuer Kampagnenattribution
• Ablauf — Optionaler Link-Ablauf fuer zeitlich begrenzte Kampagnen

Beispiel — Erstellen eines Kurzlinks in React:

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

function CreateShortLink() {
  const mutation = useMutation({
    mutationFn: async (data: { url: string; alias?: string }) => {
      const res = await fetch('/api/links', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify(data),
      })
      if (!res.ok) throw new Error('Fehler beim Erstellen des Links')
      return res.json()
    },
  })

  const handleSubmit = (e: React.FormEvent) => {
    e.preventDefault()
    const form = new FormData(e.target as HTMLFormElement)
    mutation.mutate({ url: form.get('url') as string })
  }

  return (
    <form onSubmit={handleSubmit}>
      <input name="url" placeholder="Ziel-URL eingeben" />
      <button type="submit">Kurzlink erstellen</button>
      {mutation.data && <p>Kurz-URL: {mutation.data.shortUrl}</p>}
    </form>
  )
}

Klickanalyse

Jeder Kurzlink bietet umfassende Analysen:

• Gesamtklicks — Aggregierte Klickanzahl ueber die gesamte Lebensdauer des Links
• Eindeutige Besucher — Anzahl einzelner Besucher basierend auf IP und Sitzung
• Klickverlauf — Klicks im Zeitverlauf (taegliche, woechentliche, monatliche Ansicht)
• Referrer-Daten — Woher die Klicks stammen (direkt, sozial, E-Mail usw.)
• Geodaten — Besucherverteilung nach Land und Stadt

QR-Code-Generierung

Jeder Kurzlink verfuegt ueber einen integrierten QR-Code-Generator fuer den Einsatz in:

• Druckmaterialien (Flyer, Poster, Visitenkarten)
• Veranstaltungsbeschilderung und Plakatwaenden
• Produktverpackungen und In-Store-Displays

Design-Philosophie

Standardmaessig verfolgbar

Jeder Kurzlink wird mit integrierten Analysefunktionen erstellt — kein Opt-in erforderlich. Ab dem Moment der Linkerstellung werden Klickzahlen, eindeutige Besucher, geografische Verteilung und Referrer-Daten automatisch erfasst und aggregiert. Dieser Null-Konfigurations-Ansatz stellt sicher, dass Marketingteams keine Attributionsdaten verlieren, weil sie vergessen haben, das Tracking zu aktivieren. Die Analysen werden in dedizierten Dashboard-Ansichten mit Zeitraumfiltern und Kampagnensegmentierung praesentiert.

Kampagnenattribution zuerst

Kurzlinks sind als erstklassige Kampagnenzustellungsvehikel konzipiert. Der integrierte UTM-Builder stellt sicher, dass jeder Link Kampagnenattributionsparameter traegt und jeder Klick zu seiner Kampagnenquelle zurueckverfolgbar ist. Im Gegensatz zu generischen URL-Kuenzern wie Bitly, die oft UTM-Parameter entfernen oder kostenpflichtige Plaene fuer Analysen erfordern, bewahrt und reichert das System den Attributionskontext in der gesamten Weiterleitungskette an — ohne zusaetzliche Kosten. Dies ermoeglicht eine genaue Berichterstattung im Attributionsanalyse-Dashboard.

Multi-Channel-Verteilung

Das System ueberbrueckt Online- und Offline-Marketingkanaele durch QR-Code-Generierung. Ein einzelner Kurzlink kann per E-Mail, in sozialen Medien, auf Druckmaterialien und Veranstaltungsbeschilderungen verteilt werden — alle Kanaele speisen in dieselbe Analyseansicht ein. Dieser einheitliche Messansatz gibt Marketingteams ein vollstaendiges Bild der Kampagnenleistung, unabhaengig vom Verteilungskanal.

Best Practices

Einpraegsame Aliase

Verwenden Sie kurze, einpraegsame Aliase fuer Links, die in Offline- oder muendlichen Kontexten geteilt werden (z. B. yourbrand.com/launch). Heben Sie automatisch generierte Codes fuer die programmatische Verwendung auf.

Kampagnenspezifische Links

Erstellen Sie fuer jede Kampagne eindeutige Kurzlinks, um eine genaue Attribution zu ermoeglichen. Die Wiederverwendung desselben Links ueber Kampagnen hinweg verwaessert die Analysedaten.

Klickmuster ueberwachen

Ueberpruefen Sie regelmaessig die Klickanalyse, um Verkehrsmuster zu erkennen. Ploetzliche Spitzen koennen auf virale Verbreitung hinweisen; plotzliche Abfaelle koennen auf defekte Links hindeuten.

Haeufig gestellte Fragen

Was ist die Basis-URL fuer Kurzlinks? Die Basis-URL wird ueber die Umgebungsvariable VITE_SHORT_LINK_BASE_URL konfiguriert. Das Standardformat ist go.yourdomain.com.

Kann ich einen Kurzlink nach der Erstellung bearbeiten? Ja, Sie koennen die Ziel-URL, UTM-Parameter und den Alias vorhandener Kurzlinks ueber das Admin-Dashboard aktualisieren.

Wie lange werden Klickdaten aufbewahrt? Klickdaten werden fuer historische Analysen unbegrenzt aufbewahrt. Das Dashboard bietet Zeitraumfilter fuer gezielte Berichte.

Konfiguration

Legen Sie die Basis-URL fuer Kurzlinks in .dev.vars fest:

VITE_SHORT_LINK_BASE_URL=https://go.yourdomain.com

Links werden vollstaendig ueber das Admin-Dashboard verwaltet. Keine Datenbankmigrationen erforderlich — das Kurzlink-Schema ist in der Standardmigration enthalten.

Integrationspunkte

• UTM-System — Kurzlinks tragen UTM-Parameter fuer Kampagnenattribution
• Kampagnen — Verteilen Sie Kampagnen-URLs ueber verfolgbare Kurzlinks
• Klickanalyse — Vollstaendiges Klick-Tracking und Analyse-Dashboard
• Attributions-Dashboard — Klickdaten tragen zur Kampagnen-Attributionsberichterstattung bei
• QR-Code-Generierung — Integrierter QR-Code-Export fuer Offline-Verteilung