# UTM-Quellen-Tracking

Source: https://docs.rooquiz.com/de/publish/tracking

> UTM-Quellen-Tracking kennzeichnet, woher jede Antwort stammt, damit Sie Kanäle vergleichen können: was die Parameter bedeuten, wie Sie pro Kanal einen markierten Link erstellen und wo die Zahlen erscheinen.

Wenn Sie dasselbe Quiz über mehrere Kanäle verbreiten, hilft Ihnen **UTM-Quellen-Tracking** zu erkennen, woher jede Antwort stammt, sodass Sie die Wirksamkeit jedes Kanals bewerten können.

## Was ist UTM?

UTM ist eine Reihe von Parametern, die an einen Link angehängt werden, um seine Traffic-Quelle zu kennzeichnen. Gängige Parameter sind:

* **Quelle (Source)**: z. B. `facebook`, `linkedin`, `x`, `newsletter`.
* **Medium**: z. B. `post`, `bio`, `email`, `cpc`.
* **Kampagne (Campaign)**: der Name dieser Kampagne, z. B. `spring-launch`.

## So verwenden Sie es

Öffnen Sie im gewünschten Quiz **Teilen** → **Verteilungsplan**. Jede integrierte Kanalkarte hat bereits ihren eigenen UTM-markierten Link. Für jeden anderen Kanal klicken Sie auf **Kanal hinzufügen** und füllen **utm\_source** (erforderlich) sowie **utm\_medium** und **utm\_campaign** (beide optional) aus; die neue Karte erhält ihren eigenen nachverfolgbaren Link. Siehe [Verteilungsplan](https://docs.rooquiz.com/de/publish/promotion).

UTM-Werte dürfen nur Buchstaben, Ziffern, Unterstriche und Bindestriche enthalten.

Auch Website-Einbettungen können UTM-Tags tragen – siehe die Attribute `data-rooquiz-utm-*` unter [Einbetten](https://docs.rooquiz.com/de/publish/embed#verfügbare-attribute).

## Quelldaten ansehen

Wenn Teilnehmer über einen UTM-markierten Link einsenden, wird die Quelle mit der Antwort gespeichert. UTM-Parameter in jedem Link (`utm_source`, `utm_medium`, `utm_campaign`) werden auf diese Weise gespeichert – egal, ob der Link aus dem Verteilungsplan stammt oder von Hand erstellt wurde. Unter [Einsendungen](https://docs.rooquiz.com/de/results/records) und [Insights](https://docs.rooquiz.com/de/results/insights) können Sie nach Quelle unterscheiden und auswerten.

<Callout type="info">
  Eine **klare, einheitliche Benennung** für jeden Kanal (z. B. durchgehend Kleinbuchstaben, mit Bindestrichen getrennt) hält Ihre spätere Auswertung übersichtlich.
</Callout>

## URL-Parameter (versteckte Felder)

UTM-Tags erfassen Kanäle. Um weitere Angaben aus dem Link mitzunehmen – welcher **Partner**, welche **Kampagnen-ID** oder welche **Landingpage** die Person geschickt hat –, deklarieren Sie eigene URL-Parameter.

Die Werte kommen meist von außen: aus dem Merge-Tag Ihres E-Mail-Tools wie `?crm_id={{contact.id}}`, von der Seite, in die das Quiz eingebettet ist, oder aus einem eigenen Link für jeden Partner. Wenn Sie nur Kanäle unterscheiden möchten, nutzen Sie stattdessen den [Verteilungsplan](https://docs.rooquiz.com/de/publish/promotion) – er setzt die UTM-Tags für Sie und zeigt die Zahlen pro Kanal.

<Steps>
  ### Parameter deklarieren

  Öffnen Sie im Quiz **Teilen** → **URL-Parameter** und fügen Sie die Namen hinzu, etwa `partner` und `campaign_id`. Erlaubt sind Kleinbuchstaben, Ziffern und Unterstriche, höchstens 10 pro Quiz. `utm_*` und Systemnamen wie `email`, `name`, `lang` und `ref` sind reserviert.

  ### An den Link anhängen

  Hängen Sie die Werte an den Quiz-Link an: `https://YOUR_QUIZ_LINK?partner=acme&campaign_id=spring`.
</Steps>

Die Werte werden mit jeder Antwort gespeichert und erscheinen in den Details der [Antworten](https://docs.rooquiz.com/de/results/records), in Exporten (eine Spalte pro Parameter) sowie in Webhook- und Zapier-Daten unter `metadata.params`. Gespeichert werden nur deklarierte Parameter; alles andere im Link wird ignoriert. Werte werden auf 256 Zeichen gekürzt. In allen Tarifen verfügbar.

<Callout type="info">
  Links, die auf der Ergebnisseite geteilt werden, enthalten diese Parameter nicht – die Antwort eines Freundes wird also nicht dem ursprünglichen Partner oder der Kampagne zugerechnet.
</Callout>

## Lead-Formular per Link vorausfüllen

Hängen Sie `?email=` (und optional `?name=`) an einen Quiz-Link an – etwa in einem Newsletter –, dann ist das Lead-Formular vor dem Bericht schon ausgefüllt. Das spart nur Tipparbeit: Die E-Mail wird wie gewohnt bestätigt. Die Werte werden direkt beim Laden aus der Adresszeile entfernt, bevor Google Analytics oder ein Werbe-Pixel sie sehen kann.

<Callout type="warning">
  Die E-Mail-Adresse steht direkt im Link und kann daher in Server-Logs, im Browserverlauf und überall dort landen, wohin der Link weitergeleitet wird. Verwenden Sie solche Links nur in Eins-zu-eins-Kanälen wie einer E-Mail an die Person selbst – nie auf öffentlichen Seiten oder in Anzeigen.
</Callout>
