Überblick über Marketing-Attribution & Kampagnen-Tracking
Wenn Sie digitale Pässe über Social-Media-Anzeigen, Influencer-Kooperationen, E-Mail-Newsletter, QR-Aufsteller in Filialen und Affiliate-Netzwerke verteilen, ist die präzise Messung des Kanal-ROI entscheidend. Passinstance bietet natives UTM-Parameter-Tracking (UTM Attribution Engine und UTM Tracking API unter /templates/:templateId/utm-tracking), um Traffic-Quellen zu erfassen, Pass-Registrierungs-Conversions nachzuverfolgen und die First-Touch-Marketing-Attribution dauerhaft direkt an jedem ausgegebenen Pass-Datensatz zu speichern.
Unterstützte UTM-Tags & Parameter
Passinstance standardisiert die branchenübliche Google-Analytics-UTM-Taxonomie in Kombination mit benutzerdefinierten Tags:
| Parameter-Schlüssel | Zweck | Beispielwert | Ideal verwendet für |
|---|---|---|---|
utm_source | Identifiziert Traffic-Plattform oder Referrer | facebook, instagram, newsletter, counter_qr | Bestimmung der Plattform, die den Besuch ausgelöst hat |
utm_medium | Marketingkanal oder Auslieferungsmedium | cpc, social, email, print_flyer, sms | Unterscheidung bezahlter Anzeigen von organischen oder gedruckten Werbemitteln |
utm_campaign | Konkreter Name der Werbekampagne | spring_launch_2026, black_friday_vip, store_opening | Gruppierung aller Pässe einer bestimmten Kampagne |
utm_term | Bezahltes Such-Keyword oder Zielgruppensegment | loyalty_rewards, coffee_club, fitness_sub | Tracking bestimmter Anzeigen-Keywords oder Zielgruppenvarianten |
utm_content | Konkretes Werbemittel oder CTA-Variante | blue_button, story_ad_v2, table_stand_4 | A/B-Tests von Anzeigenvarianten oder verschiedenen Tresenstandorten |
utm_id | Kampagnen-ID aus CRM oder Marketing-Automatisierung | camp_01j8k9m2, ad_99214 | Zuordnung von Pass-Ausgaben zu Google-Ads- oder HubSpot-IDs |
tag | Freitext-Kategorisierungskennung | store_munich, partner_nike, staff_alex | Individuelle Tracking-Tags für Ihren spezifischen Geschäftsprozess |
First-Touch-Attributionsmodell (FIRST_TOUCH)
Passinstance setzt ein First-Touch-Attributionsmodell um (ATTRIBUTION_MODEL = 'FIRST_TOUCH', FIRST_TOUCH_SOURCE = 'UTM_FIRST_TOUCH'):
-
1
Sitzungsbindung: Landet ein Interessent erstmals mit UTM-Parametern auf einem öffentlichen PassFlow (
/f/:slug) oder Smart-Link (/d/:slug), speichert Passinstance das Attributionspaket im Sitzungsspeicher. -
2
First-Touch-Invariante: Verlässt die Person die Seite, vergleicht Angebote oder kehrt Stunden später über einen Direktlink zurück, bleibt die ursprüngliche Kampagnenquelle erhalten, die sie zuerst zu Ihrer Marke gebracht hat.
-
3
Unveränderliche Pass-Telemetrie: Sobald der Pass generiert wurde, wird das Attribution-Objekt dauerhaft im Pass-Datensatz der Datenbank versiegelt. Spätere Bearbeitungen oder Updates des Passes überschreiben die ursprüngliche Akquisitions-Telemetrie niemals.
UTM-Regeln über Dashboard & API konfigurieren
Über das Dashboard:
-
1
Öffnen Sie Ihre Vorlage im Dashboard.
-
2
Navigieren Sie zu Funktionen -> UTM & Tracking (
/templates/:templateId/utm-tracking). -
3
Aktivieren Sie UTM-Parameter-Tracking aktivieren.
-
4
Legen Sie Standardparameter für reguläre Vorlagenlinks fest oder definieren Sie erforderliche Attributionsschlüssel für Partnerkampagnen.
Über die API (UTM Tracking API):
PUT /api/v1/templates/{templateId}/utm-tracking HTTP/1.1
Host: api.passinstance.com
X-API-Key: <API_KEY>
Content-Type: application/json
{
"enabled": true,
"defaultSource": "direct",
"defaultMedium": "web",
"allowedTags": ["store_location", "promoter_id", "partner_code"],
"trackDeviceTelemetry": true
}
UTM-Attribution in Pass-Exporten ausgeben
Sämtliche erfassten Attributionsparameter sind beim CSV-Export von Pass-Kohorten sowie bei Pass-Abfragen über die REST-API enthalten (POST /passes/export und GET /api/v1/passes):
Exportierte Telemetrie-Spalten:
-
utm_source -
utm_medium -
utm_campaign -
utm_term -
utm_content -
utm_id -
tag -
attribution_model(FIRST_TOUCH) -
attribution_captured_at(ISO-Zeitstempel) -
attribution_captured_from(PASSFLOW,SMART_LINKoderDIRECT_API) -
attribution_landing_url -
attribution_referrer
Beispielzeile im CSV-Export:
id,serialNumber,externalId,status,utm_source,utm_medium,utm_campaign,tag,capturedAt
pass_01j9x1,PI-8821,CUST-901,ACTIVE,instagram,story,spring_launch_2026,influencer_maya,2026-03-15T14:22:10Z
URL-Builder-Beispiele für Marketingkampagnen
Hängen Sie beim Verteilen Ihrer öffentlichen Links UTM-Parameter in regulärer URL-Query-Syntax an:
1. Tischaufsteller-QR-Code in der Filiale:
https://app.passinstance.com/f/coffee-club?utm_source=in_store&utm_medium=qr_code&utm_campaign=table_tents&tag=table_12
2. Instagram-Story-Swipe-Up-Anzeige:
https://app.passinstance.com/f/coffee-club?utm_source=instagram&utm_medium=story_ad&utm_campaign=summer_promo_2026&utm_content=video_b
3. Fußzeile im E-Mail-Newsletter:
https://app.passinstance.com/f/coffee-club?utm_source=newsletter&utm_medium=email&utm_campaign=weekly_digest_wk11
Weiterführende Dokumentation
-
Self-Service-Verteilung — PassFlows, Smart-Links und NFC-Verteilung.
-
Pässe verkaufen — Pässe über den PassFlow-Checkout monetarisieren.
-
Datenexporte & Berichte — Pass-Kohorten und Telemetrie als CSV exportieren.
