Namenskonventionen für UTM-Kampagnen prüfen
Prüfen Sie einen Namen wie summer-sale-q3 gegen die Namenskonvention Ihres Teams und sehen Sie, welche Regeln erfüllt und welche verletzt sind, damit ein Großbuchstabe oder Leerzeichen Ihre Berichte nicht aufspaltet. Kostenlos in Ihrem Browser.
- Kostenlos
- Läuft in Ihrem Browser
- Ohne Anmeldung
- Ihre Daten bleiben auf Ihrem Gerät
Im Browser ausführen – kostenlos
Rechenbeispiel
- Kampagnenname
- summer-sale-q3
- Muster
- lowercase-hyphenated-by-quarter
- Erwartet
- lowercase hyphenated text ending in q1, q2, q3, or q4
Einheitliche UTM-Kampagnennamen sorgen für durchsuchbare, vergleichbare und leicht verwaltbare Analyseberichte. Dieser Validator prüft einen Namen anhand der von Ihnen ausgewählten Konvention und erläutert bestandene sowie verletzte Regeln. Wählen Sie ein unterstütztes Muster für kleingeschriebene Namen mit Bindestrichen, Quartalssuffixe, Unterstriche, Großbuchstaben oder kompakte alphanumerische Kennungen. Das Ergebnis ist deterministisch: Derselbe Name und dasselbe Muster liefern immer dieselbe Antwort. Verwenden Sie die Prüfung vor der Veröffentlichung, bei einer Kampagnenfreigabe oder in einem automatisierten Ablauf.
Wählen Sie eine Konvention für Ihr Berichtssystem
Eine Namenskonvention ist nur dann nützlich, wenn alle Beteiligten sie ohne Mutmaßungen anwenden können. Wählen Sie das unterstützte Muster, das der dokumentierten Regel Ihres Teams entspricht. lowercase-hyphenated akzeptiert Namen wie spring-launch und partner-webinar-2026, lehnt jedoch Leerzeichen, Unterstriche, Großbuchstaben, doppelte Trennzeichen und Satzzeichen ab. Verwenden Sie lowercase-hyphenated-by-quarter, wenn jeder Name mit q1, q2, q3 oder q4 enden muss, beispielsweise summer-sale-q3.
Die Großbuchstabenoption eignet sich für Taxonomien wie EMEA-PRODUCT-Q4, während alphanumeric keinerlei Trennzeichen zulässt. Die Angabe des Musters ist Pflicht, denn ein Kampagnenname lässt sich nicht isoliert bewerten: summer-sale und SUMMER-SALE können nach unterschiedlichen Richtlinien jeweils korrekt sein. Nehmen Sie das gewählte Muster in Briefing, Linkgenerator oder Formular auf, damit alle dieselbe schriftliche Norm prüfen.
So kann keine unbemerkte Standardeinstellung Namen nach einer nie beabsichtigten Konvention freigeben.
Verstehen Sie das Ergebnis und beheben Sie Fehler
Die Antwort enthält den eingereichten Kampagnennamen, das normalisierte Muster, einen allgemeinen Gültigkeitswert, einzelne Prüfungen, Regelverstöße und eine kurze Beschreibung des erwarteten Formats. Ein gültiges Ergebnis bedeutet, dass der vollständige Name sämtliche Anforderungen erfüllt. Ein negatives Ergebnis ist bewusst aussagekräftiger als eine pauschale Ablehnung.
Beispielsweise verletzt Summer-Sale-Q3 beim Muster lowercase-hyphenated-by-quarter sowohl die Kleinschreibungsregel als auch die Quartalssuffixregel, da ein kleines q verlangt wird. Ein Name mit Leerzeichen scheitert an der Trennzeichenprüfung; q5 liegt außerhalb des erlaubten Bereichs. Nutzen Sie violations für kurze Oberflächenmeldungen oder automatische Entscheidungen und checks, wenn bestandene sowie fehlgeschlagene Regeln sichtbar sein sollen.
Der Validator entfernt äußere Leerzeichen, schreibt den Namen jedoch nicht um und errät keinen Ersatz. Dadurch bleiben Analysekennungen vor ungeprüften Änderungen geschützt. Korrigieren Sie den Ausgangswert, prüfen Sie erneut und veröffentlichen Sie erst, wenn valid true ist.
Fehlt das Muster, ist es leer oder unbekannt, antwortet die Anfrage mit einem Eingabefehler, statt stillschweigend eine Konvention anzunehmen.
Prüfen Sie Namen, bevor Links verbreitet werden
Der beste Zeitpunkt zur Prüfung eines UTM-Kampagnennamens liegt unmittelbar vor dem Erzeugen oder Freigeben der Tracking-URL. Führen Sie die Prüfung in einem Formular beim Verlassen des Namensfelds aus und zeigen Sie verletzte Regeln direkt daneben an. Behandeln Sie valid false in einer Veröffentlichungspipeline als fehlgeschlagene Freigabe, bevor URLs in Anzeigen, Newsletter, soziale Medien, QR-Codes oder Partnermaterialien gelangen.
Speichern Sie das Muster mit den internen Standards, damit die ursprüngliche Entscheidung reproduzierbar bleibt. Der Dienst führt begrenzte lokale Zeichenkettenprüfungen ohne Netzwerk, Zufall oder zeitabhängige Regeln aus und liefert daher stabile Ergebnisse. Geprüft wird nur die Kampagnenkomponente: Das Werkzeug baut keine URL, testet kein Ziel und bewertet keine Taxonomiestrategie.
Anwendungsfälle
Prüfen Sie einen Quartalsstart
Verlangen Sie ein kleingeschriebenes Suffix q1 bis q4, damit Berichte korrekt nach Quartal gruppiert werden.
Kontrollieren Sie automatisierte Abläufe
Prüfen Sie erzeugte Kennungen, bevor URLs über Anzeigen, E-Mail, soziale Medien oder Partner verteilt werden.
Häufige Fragen
Welche Muster werden unterstützt?
Unterstützt werden lowercase-hyphenated-by-quarter, lowercase-hyphenated, lowercase-underscore-separated, uppercase-hyphenated und alphanumeric.
Korrigiert der Validator einen ungültigen Namen?
Nein. Er meldet verletzte Regeln, ohne eine möglicherweise freigabepflichtige Analysekennung unbemerkt zu ändern.
Unterscheiden Quartalssuffixe Groß- und Kleinschreibung?
Ja. Die Quartalskonvention verlangt am Ende ein kleines q, gefolgt von 1, 2, 3 oder 4.
Warum muss ich vor der Prüfung eine Konvention wählen?
Weil sich ein Name nicht für sich allein beurteilen lässt: summer-sale und SUMMER-SALE können je nach Teamregel beide richtig sein. Die Pflichtangabe verhindert, dass eine stille Voreinstellung einen Namen nach einer Regel freigibt, die Ihr Team nie wollte.
Warum sollte ich den Namen vor dem Teilen des Links prüfen?
Weil eine spätere Änderung des Kampagnennamens Ihre Messwerte auf getrennte Einträge verteilt. Schon ein harmloser Unterschied in der Großschreibung erzeugt eine weitere Zeile in den Berichten, daher prüfen Sie am besten direkt vor dem Erstellen des Tracking-Links.
Verwandte Tools
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem Stack
curl -X POST https://api.kit.forhosting.com/seo/utm-campaign-name-validate \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"campaign_name":"summer-sale-q3","pattern":"lowercase-hyphenated-by-quarter"}'const res = await fetch("https://api.kit.forhosting.com/seo/utm-campaign-name-validate", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"campaign_name": "summer-sale-q3",
"pattern": "lowercase-hyphenated-by-quarter"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/seo/utm-campaign-name-validate",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"campaign_name": "summer-sale-q3",
"pattern": "lowercase-hyphenated-by-quarter"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/seo/utm-campaign-name-validate", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"campaign_name":"summer-sale-q3","pattern":"lowercase-hyphenated-by-quarter"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"campaign_name":"summer-sale-q3","pattern":"lowercase-hyphenated-by-quarter"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/seo/utm-campaign-name-validate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"campaign_name": "summer-sale-q3",
"pattern": "lowercase-hyphenated-by-quarter"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "seo.utm_campaign_name_validate",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |
Technische Hinweise
Wählen Sie eine Konvention für Ihr Berichtssystem
Für Kennungen im Snake-Stil akzeptiert lowercase-underscore-separated etwa lifecycle_email_q2.
Prüfen Sie Namen, bevor Links verbreitet werden
Rufen Sie die API in Tabellen oder Stapelabläufen einmal pro vorgeschlagenem Namen auf und geben Sie ungültige Zeilen an die Verantwortlichen zurück. Frühe Prüfung ist wichtig, weil eine nachträgliche Änderung von utm_campaign Messwerte auf mehrere Analysezeilen verteilt; bereits andere Großschreibung kann eine neue Zeile erzeugen. Der Browser eignet sich für manuelle Kontrollen; API-Anfragen kosten jeweils $0.002.
Integrationsbeispiele
Sichern Sie ein Kampagnenformular ab
Weisen Sie uneinheitliche utm_campaign-Werte zurück, bevor ein Tracking-Link veröffentlicht oder exportiert wird.
Technische Fragen
Was geschieht, wenn Sie das Muster weglassen?
Die Anfrage liefert invalid_input, da für die Prüfung eine ausdrückliche Konvention erforderlich ist.
Was kostet eine Prüfung über die API?
Jede API-Anfrage kostet $0.002. Eine schnelle manuelle Prüfung ist auch im Browser möglich.