Entwicklertools · URL-Encoder und -Decoder
Warum uncodierte & und = in UTM-Werten Ihre Kampagnenberichte stillschweigend beschädigen
· Warum es wichtig ist
URL-Kodierung utm-tracking Analysen
Ein Kampagnenname, der & oder = enthält, sieht im Link gut aus, wird aber von jedem Analysetool in zwei Parameter aufgeteilt. Dieser Beitrag zeigt, was passiert, wie man Werte sicher kodiert und wie man einen Link überprüft, bevor er versendet wird.
Wenn UTM-Parameter an nicht kodierten kaufmännischen Und-Zeichen geteilt werden
Ein Kampagnenname, der & oder = enthält, sieht gut aus, wenn er in einen Link eingegeben wird, aber jedes Analysesystem teilt ihn am kaufmännischen Und und behandelt den Rest als neuen Parameter. Frühling und Sommer werden in Berichten zu zwei separaten Kampagnenwerten. Das Gleichheitszeichen innerhalb eines Werts erzeugt eine ähnliche Unterbrechung: utm_campaign=2024=best beschädigt stillschweigend das Schlüssel-Wert-Paar. Diese Zeichen sind in der Abfragesyntax für die Struktur und nicht für den Inhalt reserviert, sodass jedes Tool, das URLs analysiert, sie als Trennzeichen liest.
Der URL-Parser kann nicht erkennen, dass Sie sie als Daten gemeint haben. Durch die Codierung als %26 und %3D bleiben sie als Literalzeichen innerhalb von Werten erhalten. Ohne Kodierung erhält Ihr Analyse-Dashboard unvollständige oder beschädigte Kampagnennamen und teilt den Datenverkehr auf unbeabsichtigte Segmente auf. Ein einzelner geteilter Link kann ein halbes Dutzend Phantomkampagnen generieren, wenn der Name mehrere Sonderzeichen enthält.
Wie Abfragezeichenfolgen analysiert werden – & trennt Paare und = trennt Schlüssel vom Wert, ohne Escapezeichen, es sei denn, Sie geben es an
Die Analyse von Abfragezeichenfolgen zeigt, warum kaufmännische Und- und Gleichheitswerte in Werten gefährlich sind. Das kaufmännische Und trennt unabhängige Schlüssel=Wert-Paare: ?utm_source=email&utm_campaign=sale bedeutet zwei separate Parameter. Innerhalb eines Werts beendet ein kaufmännisches Und ohne Escapezeichen das aktuelle Paar und beginnt ein neues. Das Gleichheitszeichen trennt Schlüssel von Werten: Wenn utm_campaign=Q3&2024, sieht der Parser utm_campaign=Q3 und dann den verwaisten Parameter „2024“ ohne Wert.
Diese Analyse erfolgt auf mehreren Ebenen: Der Browser liest die URL, der Server empfängt die Anfrage und Ihre Analyseplattform dekodiert die Abfragezeichenfolge erneut. Jede Ebene wendet dieselben Regeln an und kommt zu derselben Schlussfolgerung darüber, wo Parameter beginnen und enden. Sie können nachgeschaltete Verbraucher nicht warnen, dass Ihr kaufmännisches Und-Zeichen etwas Besonderes ist; Die URL-Struktur ist deterministisch und eindeutig.
Welche Zeichen müssen in einem UTM-Wert kodiert werden – &, =, #, ?, Leerzeichen und Nicht-ASCII, und warum # am hinterhältigsten ist
Zu den Zeichen, die in UTM-Werten kodiert werden müssen, gehören kaufmännisches Und, Gleichheitszeichen, Raute, Fragezeichen, Leerzeichen und alle Nicht-ASCII-Buchstaben oder -Symbole. Das Hash-Zeichen ist am hinterhältigsten: #anything wird als Fragment-ID behandelt, die der Browser überhaupt nicht an den Server sendet. Der Kampagnenname, der mit einem Hash endet, verliert alles, bevor die Anfrage Ihren Browser verlässt. Aus demselben strukturellen Grund müssen Leerzeichen zu %20 werden: nicht gültig in URLs ohne Codierung.
Nicht-ASCII-Zeichen wie akzentuiertes e oder chinesische Zeichen, die als UTF-8 Bytes codiert und dann mit Prozent-Escapezeichen versehen werden: akzentuiertes e wird zu %C3%A9. Erstellen Sie Ihre Links sorgfältig oder verwenden Sie ein Formular, das für Sie kodiert. Tools, mit denen Sie den Kampagnennamen einfügen und einen vollständigen Link generieren können, erledigen diesen Schritt normalerweise automatisch, aber Tabellenkalkulationsformeln oder manuelle Verkettungen machen ihn zu Ihrer Verantwortung.
Arbeitsbeispiel: Kodierung von „Q3 Sale & Launch“ als utm_campaign – vorher und nachher und wie der Bericht jede Version liest
Funktioniertes Beispiel: Die Codierung von „Q3 Sale & Launch“ als utm_campaign zeigt das Problem deutlich. Ohne Codierung endet die URL mit dem kaufmännischen Und: ?utm_campaign=Q3 Sale &. Der Rest verschwindet oder wird zu einem fehlerhaften neuen Parameter. Richtig codiert ersetzt %26 das kaufmännische Und: ?utm_campaign=Q3%20Sale%20%26%20Launch. Leerzeichen wird auch als %20 codiert. Jetzt kommt die gesamte Zeichenfolge unversehrt auf Ihrer Analyseplattform an und wird als einzelne Kampagne gemeldet.
Fügen Sie die uncodierte Version und die codierte Version in separate URL-Decoder ein und beobachten Sie, wie sie sich unterscheiden. Die kodierte Form wird in den Originaltext zurückdekodiert, wobei alle Sonderzeichen erhalten bleiben. Verwenden Sie den URL-Encoder, um jeden UTM-Link zu überprüfen, bevor Sie ihn mit Teammitgliedern teilen oder in E-Mail-Kampagnen oder Social-Media-Plattformen veröffentlichen.
Tabellenkalkulationsformeln und Linkbuilder – wo die Codierung in gängigen Arbeitsabläufen auftritt oder fehlschlägt, allgemein beschrieben
Tabellenkalkulationsformeln und benutzerdefinierte Linkbuilder schlagen oft fehl, weil sie Zeichenfolgen ohne Kodierung verketten. Eine CONCATENATE-Formel-Erstellungs-URL kann zu vollkommen gültig aussehendem Text führen, der beim Öffnen als Link unterbrochen wird. Die Kodierung muss innerhalb der Formel erfolgen, nicht danach. Viele Link-Kürzungsdienste und E-Mail-Tracking-Plattformen kodieren automatisch für Sie, sodass es sicher ist, den generierten Link zu testen, anstatt davon auszugehen, dass er manuell erstellt wird.
Drag-and-Drop-Kampagnen-Builder in Google Analytics, HubSpot und ähnlichen Plattformen übernehmen die Codierung intern. Wenn Sie Links manuell in einer Tabellenkalkulation erstellen oder in Slack einfügen, gehen Sie davon aus, dass sie nicht automatisch kodiert werden. Führen Sie die endgültige URL durch den Decoder, um zu überprüfen, ob alle Sonderzeichen als %XX dargestellt werden, bevor Sie den Link verteilen.
Häufige Fehler – Codieren der gesamten URL und Mischen von + und %20, sodass aus einer Kampagne zwei werden
Zu den häufigsten Fehlern gehört die Codierung der gesamten URL, die ihre Struktur durch die Codierung von Doppelpunkten und Schrägstrichen in https://. zerstört. Ein weiterer Fehler vermischt Plus und %20 für Leerzeichen: Einige Systeme verwenden Plus (alte Formcodierung), während moderne Standards %20 verwenden. Wenn ein Kampagnenwert Plus und ein anderer %20 verwendet, werden sie als unterschiedliche Kampagnen angezeigt, obwohl sie denselben Text darstellen. Bleiben Sie konsistent und verwenden Sie %20 für URL-Komponenten.
Doppelte Kodierung kommt auch vor, wenn der Link Builder einmal kodiert und Sie dann noch einmal kodieren, wodurch %2526 anstelle von %26 entsteht. Nach einmaliger Dekodierung erhalten Sie %26 anstelle des kaufmännischen Und-Zeichens. Das Zeichen wird zu einer literalen Prozent-zwei-sechs-Zeichenfolge und nicht zu einem kaufmännischen Und-Zeichen. Überprüfen Sie die Zwischenschritte in Ihrem Build-Prozess, um sicherzustellen, dass die Codierung nur genau einmal pro Wert erfolgt.
Was hiervon nicht abgedeckt wird: Konfiguration der Analyseplattform und Attributionsmodelle
Die Konfiguration von Analytics und die Attributionsmodellierung hängen vollständig davon ab, konsistent genaue Kampagnendaten zu erhalten. Wenn Ihre UTM-Werte verstümmelt oder geteilt ankommen, können Berichte Kampagnen nicht korrekt zuordnen und Multi-Touch-Attributionsmodelle können die Gutschrift nicht korrekt zuweisen. Ein einzelner Codierungsfehler breitet sich in jedem Bericht aus, der Parameter verwendet, und verzerrt die Vergleiche von Monat zu Monat oder von Kampagne zu Kampagne erheblich.
Testen Sie Ihre Kampagnenlinks vor dem vollständigen Start. Fügen Sie sie in den URL-Decoder ein und vergewissern Sie sich, dass jedes Sonderzeichen im Kampagnennamen ordnungsgemäß codiert ist. Der URL-Encoder zeigt sowohl kodierte als auch dekodierte Formen nebeneinander an, sodass Sie überprüfen können, ob die Kodierung stattgefunden hat und durch die Dekodierung der Originaltext exakt wiederhergestellt wird.
Takeaway: Codieren Sie jeden Wert einmal – wie der URL-Encoder und -Decoder aus jedem Kampagnennamen einen sicheren Abfragewert generiert
Die Erkenntnis ist einfach: Codieren Sie jeden Wert einmal mit den richtigen Prozentcodierungsregeln. Das kaufmännische Und- oder Gleichheitszeichen innerhalb des UTM-Parameters muss zu %26 oder %3D werden, bevor die URL finalisiert und veröffentlicht wird. Der URL-Encoder im Einzelwertmodus erledigt diese Kodierung automatisch und zuverlässig für Sie. Fügen Sie Ihren Kampagnennamen ein, wählen Sie den Wertmodus aus und kopieren Sie das codierte Ergebnis in Ihre Linkvorlage.
Jedes Analysetool, das URLs verarbeitet, wendet dieselben Analyseregeln an. Daran führt kein Weg vorbei und es gibt kein Tool, das Ihre Absicht(en) erraten kann. Der Kodierungsschritt ist nicht optional; Dies ist nur eine Möglichkeit, Sonderzeichen innerhalb von Abfragezeichenfolgenwerten beizubehalten. Überprüfen Sie, ob Ihre Links wie erwartet funktionieren, bevor Sie sie mit Interessengruppen teilen oder in Kampagnen veröffentlichen.