# UTM-Builder

Erstell UTM-Links, die im richtigen GA4-Channel landen. Diese Seite ist der Builder: Übergib die Werte als Query-Parameter und du bekommst den getaggten Link, den GA4-Channel, in dem er landet, und alles, was deine Reports durcheinanderbringt. Ohne Key, ohne Anmeldung, es wird nichts gespeichert.

## So rufst du ihn auf

GET `https://www.usenotra.com/de/utm-builder.md?url=example.com/pricing&source=newsletter&medium=email&campaign=spring-launch`

Dieselbe Abfrage auf `https://www.usenotra.com/de/utm-builder` öffnet den Builder mit allen Feldern ausgefüllt. So kannst du einem Menschen einen Link zum Prüfen geben, bevor etwas live geht. Anfragen an `https://www.usenotra.com/de/utm-builder` mit `Accept: text/markdown` bekommen diese Seite.

Tagge eine Kampagne in einem Aufruf für mehrere Channels:

GET `https://www.usenotra.com/de/utm-builder.md?url=example.com&campaign=spring-launch&channels=newsletter,linkedin,google-ads`

Codier den Wert von `url` als URL, wenn er eigene `?`, `&` oder `#` enthält, sonst werden diese Teile als Builder-Parameter gelesen.

Bei Fehlern fehlt der Link im Ergebnis und die Antwort kommt mit Status 422. Bei Warnungen bekommst du trotzdem einen Link.

## Parameter

| Query-Key | UTM-Parameter | Pflicht | Bedeutung |
| --- | --- | --- | --- |
| `url` | (Ziel) | Pflicht | Die Seite, auf die du Leute schicken willst. Fehlt `https://`, wird es ergänzt. Vorhandene Query-Parameter und das `#fragment` bleiben erhalten, vorhandene `utm_`-Parameter werden ersetzt. |
| `source` | `utm_source` | Pflicht | Woher der Klick kommt: eine Website, Plattform oder Liste. Beispiele: google, linkedin, newsletter. |
| `medium` | `utm_medium` | Empfohlen | Die Art des Traffics. GA4 gruppiert Channels vor allem nach diesem Wert. Beispiele: cpc, email, social, paid-social, affiliate. |
| `campaign` | `utm_campaign` | Empfohlen | Die Kampagne, der Launch oder die Aktion, zu der der Link gehört. Halte den Namen über alle Channels gleich, damit du sie vergleichen kannst. |
| `id` | `utm_id` | Optional | Eine feste ID für die Kampagne. GA4 braucht sie, um importierte Kostendaten mit Sessions zu verknüpfen. |
| `term` | `utm_term` | Optional | Das bezahlte Keyword oder die Zielgruppe, die die Anzeige ausgelöst hat. |
| `content` | `utm_content` | Optional | Unterscheidet Links, die sonst alles gemeinsam haben, zum Beispiel zwei Buttons in einer E-Mail oder zwei Anzeigenvarianten. |
| `platform` | `utm_source_platform` | Optional | Die Plattform, über die die Kampagne läuft, etwa ein Einkaufstool oder Ad Manager. |
| `format` | `utm_creative_format` | Optional | Die Art des Werbemittels, zum Beispiel display, native oder video. |
| `tactic` | `utm_marketing_tactic` | Optional | Das Targeting der Kampagne, zum Beispiel remarketing oder prospecting. |
| `channels` | (mehrere Links) | Optional | Kommagetrennte Preset-IDs aus der Tabelle unten. Liefert einen getaggten Link pro Channel, alle mit derselben Kampagne, ID und denselben übrigen Werten. |
| `clean` | (Verhalten) | Optional | Standardmäßig `true`: Werte werden kleingeschrieben und Leerzeichen zu Bindestrichen. Platzhalter in `{geschweiften Klammern}` bleiben unverändert. Schick `false`, um die Werte so zu behalten, wie sie eingegeben wurden. |

## Channel-Presets

| Preset-ID | Channel | utm_source | utm_medium | Extras | GA4-Channel |
| --- | --- | --- | --- | --- | --- |
| `newsletter` | Newsletter | newsletter | email | - | Email |
| `linkedin` | LinkedIn-Post | linkedin | social | - | Organic Social |
| `x` | X-Post | x | social | - | Organic Social |
| `reddit` | Reddit-Post | reddit | social | - | Organic Social |
| `youtube` | YouTube-Video | youtube | video | - | Organic Video |
| `google-ads` | Google Ads | google | cpc | utm_term=`{keyword}`, utm_content=`{creative}` | Paid Search |
| `meta-ads` | Meta Ads | facebook | paid-social | utm_term=`{{adset.name}}`, utm_content=`{{ad.name}}` | Paid Social |
| `linkedin-ads` | LinkedIn Ads | linkedin | paid-social | - | Paid Social |
| `bing-ads` | Microsoft Ads | bing | cpc | - | Paid Search |
| `partner` | Partner oder Affiliate | partner | affiliate | - | Affiliates |
| `podcast` | Podcast | podcast | audio | - | Audio |
| `sms` | SMS | sms | sms | - | SMS |

- Google Ads: {keyword} und {creative} sind ValueTrack-Parameter, die Google Ads beim Klick ausfüllt.
- Meta Ads: {{adset.name}} und {{ad.name}} sind dynamische Parameter, die Meta beim Klick ausfüllt.

## Wie GA4 einen Channel wählt

GA4 prüft diese Regeln von oben nach unten und hört beim ersten Treffer auf. Die Werte werden kleingeschrieben verglichen, saubere Werte liefern also stabile Ergebnisse.

| Reihenfolge | Channel | Regel |
| --- | --- | --- |
| 1 | Direct | Source ist (direct) und Medium ist (none) oder (not set). |
| 2 | Cross-network | Der Kampagnenname enthält cross-network. |
| 3 | Paid Shopping | Source ist eine Shopping-Website oder der Kampagnenname enthält shop oder shopping, und das Medium ist bezahlt. |
| 4 | Paid Search | Source ist eine Suchmaschine und das Medium ist bezahlt. |
| 5 | Paid Social | Source ist ein soziales Netzwerk und das Medium ist bezahlt. |
| 6 | Paid Video | Source ist eine Video-Website und das Medium ist bezahlt. |
| 7 | Display | Medium ist display, banner, expandable, interstitial oder cpm. |
| 8 | Paid Other | Das Medium ist bezahlt, die Source ist etwas anderes. |
| 9 | Organic Shopping | Source ist eine Shopping-Website oder der Kampagnenname enthält shop oder shopping. |
| 10 | Organic Social | Source ist ein soziales Netzwerk oder Medium ist social, social-network, social-media, sm, social network oder social media. |
| 11 | Organic Video | Source ist eine Video-Website oder das Medium enthält video. |
| 12 | Organic Search | Source ist eine Suchmaschine oder Medium ist organic. |
| 13 | Referral | Medium ist referral, app oder link. |
| 14 | Email | Source oder Medium ist email, e-mail, e_mail oder e mail. |
| 15 | Affiliates | Medium ist affiliate. |
| 16 | Audio | Medium ist audio. |
| 17 | SMS | Source oder Medium ist sms. |
| 18 | Mobile Push Notifications | Medium endet auf push oder enthält mobile oder notification, oder Source ist firebase. |
| 19 | Unassigned | Keine der Regeln oben hat gepasst. |

Bezahlt heißt, das Medium passt auf cp (cpc, cpm, cpv und so weiter), ppc oder retargeting oder beginnt mit paid.

Suchmaschinen, soziale Netzwerke, Video- und Shopping-Websites stammen aus Listen, die Google pflegt. Der Builder prüft die gängigen Einträge, eine Nischen-Source kann also in einem anderen Channel landen als erwartet.

## Namensregeln für saubere Reports

- Schreib alles klein. `Email`, `email` und `EMAIL` erscheinen in GA4 als drei Zeilen.
- Nimm Bindestriche statt Leerzeichen. Leerzeichen werden zu `%20` oder `+` und man vertippt sich leicht.
- Die Source ist die Website oder Liste, das Medium die Art des Traffics. `source=newsletter&medium=email`, nicht umgekehrt.
- Nutz für alle Channels eines Launches denselben Kampagnennamen und unterscheide die Links mit `utm_content`.
- Tagge nie Links zwischen Seiten deiner eigenen Website. Das startet eine neue Session und überschreibt, woher der Besuch wirklich kam.
- Gib `utm_id` an, wenn du Kostendaten in GA4 importierst. Über diesen Schlüssel verknüpft der Import die Daten.
