Skip to content
Hilfecenter-Anleitung · Pass-Verteilung
3 Min. LesezeitGeprüft 2026-11-16

UTM-Tracking-Parameter

Verfolgen Sie Marketingkampagnen, Anzeigenquellen und Conversion-Trichter auf Pass-Verteilungskontingenten und PassFlows mit First-Touch-Attribution.

In dieser Anleitung

Ü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.

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
UTM-ATTRIBUTIONS- & TELEMETRIE-PIPELINE
STUFE 01 MARKETINGKAMPAGNEN-TOUCHPOINT
Kundin/Kunde klickt Link oder scannt QR-Code mit UTM-Tags: https://app.passinstance.com/f/vip-club?utm_source=instagram&utm_medium=story...
STUFE 02 UTM-ERFASSUNGS- & ATTRIBUTIONS-ENGINE
Liest Query-Tags aus: utm_source, utm_medium, utm_campaign, utm_term...
Erfasst HTTP-Referer und ursprüngliche landingUrl
Erzwingt First-Touch-Attribution (ATTRIBUTION_MODEL = 'FIRST_TOUCH')
STUFE 03 PERSISTIERUNG DER PASS-ATTRIBUTION (DATENBANK)
Dauerhaft gespeichert im JSON-Feld Pass.attribution:
utm_source: "instagram"
utm_medium: "story"
utm_campaign: "summer_promo_2026"
tag: "influencer_sarah"
capturedAt: ISO-Zeitstempel | capturedFrom: "PASSFLOW"
STUFE 04A CSV-EXPORT & ANALYTICS
Enthalten in POST/passes/export
Kohorten nach Kampagne filtern
STUFE 04B INTEGRATIONS-WEBHOOKS
Weitergeleitet in pass.created
Sync zu CRM / Google Analytics 4

Unterstützte UTM-Tags & Parameter

Passinstance standardisiert die branchenübliche Google-Analytics-UTM-Taxonomie in Kombination mit benutzerdefinierten Tags:

Parameter-SchlüsselZweckBeispielwertIdeal verwendet für
utm_sourceIdentifiziert Traffic-Plattform oder Referrerfacebook, instagram, newsletter, counter_qrBestimmung der Plattform, die den Besuch ausgelöst hat
utm_mediumMarketingkanal oder Auslieferungsmediumcpc, social, email, print_flyer, smsUnterscheidung bezahlter Anzeigen von organischen oder gedruckten Werbemitteln
utm_campaignKonkreter Name der Werbekampagnespring_launch_2026, black_friday_vip, store_openingGruppierung aller Pässe einer bestimmten Kampagne
utm_termBezahltes Such-Keyword oder Zielgruppensegmentloyalty_rewards, coffee_club, fitness_subTracking bestimmter Anzeigen-Keywords oder Zielgruppenvarianten
utm_contentKonkretes Werbemittel oder CTA-Varianteblue_button, story_ad_v2, table_stand_4A/B-Tests von Anzeigenvarianten oder verschiedenen Tresenstandorten
utm_idKampagnen-ID aus CRM oder Marketing-Automatisierungcamp_01j8k9m2, ad_99214Zuordnung von Pass-Ausgaben zu Google-Ads- oder HubSpot-IDs
tagFreitext-Kategorisierungskennungstore_munich, partner_nike, staff_alexIndividuelle 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. 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. 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. 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. 1
    Öffnen Sie Ihre Vorlage im Dashboard.
  2. 2
    Navigieren Sie zu Funktionen -> UTM & Tracking (/templates/:templateId/utm-tracking).
  3. 3
    Aktivieren Sie UTM-Parameter-Tracking aktivieren.
  4. 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):

HTTP
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_LINK oder DIRECT_API)
  • attribution_landing_url
  • attribution_referrer

Beispielzeile im CSV-Export:

CSV
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:

TEXT
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:

TEXT
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:

TEXT
https://app.passinstance.com/f/coffee-club?utm_source=newsletter&utm_medium=email&utm_campaign=weekly_digest_wk11

Weiterführende Dokumentation

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.