PPartnerDesk

52 — UTM, Sub-IDs & Fingerprint

Aktualisiert am 1. Juni 2026

52 — UTM, Sub-IDs & Fingerprint

Erweiterte Tracking-Parameter, mit denen Partner und Tenant ihre Klicks und Conversions differenzieren können.

UTM-Parameter

Standard-UTM-Felder werden bei jedem Klick automatisch erfasst, wenn vorhanden:

Parameter Zweck
utm_source Quelle (z. B. facebook, newsletter)
utm_medium Medium (z. B. cpc, email)
utm_campaign Kampagne (z. B. summer-promo-2026)
utm_term Optional: Suchbegriff
utm_content Optional: Variante (A/B-Test)

Wird mit dem TrackingClick persistiert. In der Transaction-Detail-View sieht der Admin später, woher der Click kam.

https://4leads.partnerdesk.io/t/summer-promo?pid=P-123&utm_source=facebook&utm_medium=ads&utm_campaign=launch-week

Sub-IDs (sub1, sub2, sub3)

Drei freie Felder, die der Partner für seine eigene Aufteilung nutzen kann.

Use-Cases

  • sub1 = welche Landingpage-Variante.
  • sub2 = welche Anzeige.
  • sub3 = welche Zielgruppe.

Beispiel:

https://4leads.partnerdesk.io/t/launch?pid=P-123&sub1=lp-v3&sub2=ad-blue&sub3=audience-tech

Der Partner kann diese später in seinem eigenen Tool zusammenführen — z. B. Google Analytics, eigenes Dashboard.

Wo wird das angezeigt?

Admin

  • Transaction-Detail-View: alle Tracking-Felder werden ausgespielt.
  • Click-Reports: Aggregation nach UTM-Source / Sub-IDs (in Advanced Stats).

Partner

  • Klick-Liste im Partner-Portal: Filter nach UTM-Werten möglich.
  • Tracking-Report: Conversion-Rate pro Source.

Fingerprint — die unsichtbare Backup-Resolution

Wenn der Tracking-Cookie verloren geht (Browser-Wechsel, Cookie-Cleanup, Inkognito-Modus), versucht PartnerDesk eine zweite Match-Strategie:

Wie

  1. Beim Klick wird ein Fingerprint berechnet: SHA-256(IP + UserAgent).
  2. Bei der Conversion wird derselbe Fingerprint berechnet.
  3. Wenn ein Klick mit demselben Fingerprint innerhalb der Cookie-Lifetime existiert: Match.

Wann hilft das?

  • Mobile-User wechselt zwischen WiFi und Mobilfunk → IP ändert sich → kein Match.
  • User räumt Cookies auf → Fingerprint bleibt gleich → Match.
  • User wechselt Browser → User-Agent ändert sich → kein Match.

Fingerprint ist also ein Backup, keine 100%-Lösung. Aber rettet einen Teil der sonst verlorenen Attributionen.

Privacy

  • IP wird nicht im Klartext gespeichert (nur im TrackingClick-Datensatz).
  • Fingerprint ist hash-only — nicht reversibel.
  • Cookie-Consent-Banner (siehe 95) regelt, ob der Mechanismus angewendet werden darf.

UTM-Builder im Partner-Portal

Damit Partner nicht die UTM-Parameter manuell zusammenbauen müssen, gibt es einen visuellen UTM-Builder:

Partner-Portal → „Links" → „UTM-Builder":

  • Schnellauswahl-Presets: Instagram, TikTok, YouTube, LinkedIn, X, Mail, …
  • 5 UTM-Felder eintragen.
  • Live-Preview der fertigen URL.
  • Copy- und Share-Buttons.

Der Builder hängt die UTM-Parameter automatisch an den Tracking-Link an.

Pretty-URLs als Alternative

Statt langer UTM-Links können Sie auch Pretty-URLs anlegen (siehe 54), die intern auf eine UTM-Konfiguration mappen — kürzer und teilbarer.

Verwandte Kapitel

Technische Tiefen-Doku: ../001-initial-setup.md (TrackingService), ../102-short-links.md, ../179-sprint-5-polishing.md (UTM-Builder)