Strumenti per sviluppatori · URL codificatore e decodificatore
Perché i valori & e = non codificati nei valori UTM corrompono silenziosamente i report della tua campagna
· Perché è importante
codifica dell'URL tracciamento utm analitica
Un nome di campagna contenente & o = sembra corretto nel collegamento ma viene suddiviso in due parametri da ogni strumento di analisi. Questo post mostra cosa succede, come codificare i valori in modo sicuro e come controllare un collegamento prima che venga spedito.
Quando i parametri UTM si dividono in caratteri e commerciali non codificati
Il nome di una campagna contenente & o = sembra a posto quando viene digitato in un collegamento, ma ogni sistema di analisi lo divide nella e commerciale e tratta il resto come un nuovo parametro. Primavera ed estate diventano due valori di campagna separati nei report. Il segno di uguale all'interno di un valore crea un'interruzione simile: utm_campaign=2024=best corrompe silenziosamente la coppia chiave-valore. Questi caratteri sono riservati nella sintassi della query per la struttura, non per il contenuto, quindi ogni strumento che analizza gli URL li legge come delimitatori.
Il parser URL non ha modo di sapere che li intendevi come dati. Codificandoli come %26 e %3D li preserva come caratteri letterali all'interno dei valori. Senza codifica, la tua dashboard di analisi riceve nomi di campagne incompleti o danneggiati e suddivide il traffico in segmenti non desiderati. Un singolo collegamento condiviso può generare una mezza dozzina di campagne fantasma se il nome contiene più caratteri speciali.
Come vengono analizzate le stringhe di query: & separa le coppie e = separa la chiave dal valore, senza escape a meno che tu non lo fornisca
Il modo in cui le stringhe di query analizzano rivela perché la e commerciale e gli uguali sono pericolosi nei valori. La e commerciale separa coppie chiave=valore indipendenti: ?utm_source=email&utm_campaign=sale indica due parametri separati. All'interno di un valore, la e commerciale senza caratteri di escape termina la coppia corrente e ne inizia una nuova. Il segno di uguale separa le chiavi dai valori: se utm_campaign=Q3&2024, il parser vede utm_campaign=Q3 e quindi il parametro orfano "2024" senza valore.
Questa analisi avviene a più livelli: il browser legge URL, il server riceve la richiesta e la piattaforma di analisi decodifica nuovamente la stringa di query. Ogni livello applica le stesse regole e raggiunge la stessa conclusione su dove iniziano e finiscono i parametri. Non puoi avvisare i consumatori a valle che la tua e commerciale è speciale; La struttura URL è deterministica e inequivocabile.
Quali caratteri devono essere codificati in un valore UTM — &, =, #, ?, spazi e nonASCII, e perché # è il più subdolo
I caratteri che richiedono la codifica nei valori UTM includono e commerciale, uguale, cancelletto, punto interrogativo, spazi e qualsiasi lettera o simbolo non ASCII. Il carattere hash è il più subdolo: #qualsiasi cosa viene trattato come identificatore di frammento, che il browser non invia mai al server. Il nome della campagna che termina con hash perde tutto ciò che segue prima ancora che la richiesta lasci il tuo browser. Gli spazi devono diventare %20 per lo stesso motivo strutturale: non valido negli URL senza codifica.
NonASCII come la e accentata o caratteri cinesi codificati come UTF-8 byte e quindi con escape percentuale: la e accentata diventa %C3%A9. Costruisci i tuoi collegamenti con attenzione o utilizza il modulo che codifica per te. Gli strumenti che ti consentono di incollare il nome della campagna e generare il collegamento completo di solito gestiscono questo passaggio automaticamente, ma la formula del foglio di calcolo o la concatenazione manuale rendono questa responsabilità una tua responsabilità.
Esempio realizzato: codifica di "Q3 Sale & Launch" come utm_campaign — prima e dopo, e come il report legge ciascuna versione
Esempio realizzato: la codifica di "Q3 Sale & Launch" come utm_campaign mostra chiaramente il problema. Senza codifica, URL termina con la e commerciale: ?utm_campaign=Q3 Sale &. Il resto scompare o diventa un nuovo parametro non valido. Codificato correttamente, %26 sostituisce la e commerciale: ?utm_campaign=Q3%20Sale%20%26%20Launch. Lo spazio è anche codificato come %20. Ora l'intera stringa arriva intatta alla tua piattaforma di analisi e viene segnalata come un'unica campagna.
Incolla la versione non codificata e la versione codificata in decoder URL separati e osserva come differiscono. Il modulo codificato decodifica il testo originale preservando tutti i caratteri speciali. Utilizza il codificatore URL per verificare qualsiasi collegamento UTM prima di condividerlo con i membri del team o pubblicarlo in campagne email o piattaforme di social media.
Formule di fogli di calcolo e generatori di collegamenti: casi in cui la codifica avviene o fallisce nei flussi di lavoro comuni, descritti in modo generale
Le formule dei fogli di calcolo e i generatori di collegamenti personalizzati spesso falliscono perché concatenano stringhe senza codifica. Una formula CONCATENATE che crea URL potrebbe produrre testo dall'aspetto perfettamente valido che si interrompe quando viene aperto come collegamento. La codifica deve avvenire all'interno della formula, non dopo. Molti servizi di abbreviazione dei collegamenti e piattaforme di tracciamento della posta elettronica codificano automaticamente, quindi prova il collegamento generato anziché dare per scontato che la costruzione manuale sia sicura.
I generatori di campagne drag-and-drop in Google Analytics, HubSpot e piattaforme simili gestiscono la codifica internamente. Se stai creando collegamenti manualmente in un foglio di calcolo o incollandoli in Slack, presumi che non verranno codificati automaticamente. Esegui il URL finale attraverso il decodificatore per verificare che tutti i caratteri speciali siano rappresentati come %XX prima di distribuire il collegamento.
Errori comuni: codificare l'intero URL e mescolare + e %20 in modo che una campagna diventi due
Gli errori più comuni includono la codifica dell'intero URL, che ne interrompe la struttura codificando due punti e barre in https://. Un altro errore mescola più e %20 per gli spazi: alcuni sistemi utilizzano più (codifica dei moduli legacy) mentre lo standard moderno utilizza %20. Se un valore di campagna utilizza più e un altro utilizza %20, verranno visualizzati come campagne diverse anche se rappresentano lo stesso testo. Mantieni la coerenza e utilizza %20 per i componenti URL.
La doppia codifica si verifica anche quando il generatore di collegamenti codifica una volta e tu codifichi nuovamente, producendo %2526 invece di %26. Dopo aver decodificato una volta, ottieni %26 invece della e commerciale. Il carattere diventa una stringa percentuale due-sei anziché una e commerciale. Controlla i passaggi intermedi del processo di compilazione per garantire che la codifica avvenga esattamente una volta per valore.
Ciò che questo non copre: configurazione della piattaforma di analisi e modelli di attribuzione
La configurazione di Analytics e il modello di attribuzione dipendono interamente dall'ottenimento di dati della campagna coerenti e accurati. Se i tuoi valori UTM arrivano confusi o divisi, i rapporti non possono abbinare correttamente le campagne e i modelli di attribuzione multi-touch non riescono ad assegnare il credito in modo accurato. Un singolo errore di codifica si propaga in ogni report che utilizza parametri, distorcendo in modo significativo i confronti mese per mese o tra campagna e campagna.
Metti alla prova i collegamenti della tua campagna prima del lancio completo. Incollali nel decodificatore URL e verifica che ogni carattere speciale nel nome della campagna sia codificato correttamente. Il codificatore URL mostra sia i moduli codificati che quelli decodificati fianco a fianco, in modo da poter verificare che la codifica sia avvenuta e che la decodifica recuperi esattamente il testo originale.
Conclusione: codifica ogni valore una volta: in che modo il codificatore e decodificatore URL produce un valore di query sicuro da qualsiasi nome di campagna
La conclusione è semplice: codificare ogni valore una volta utilizzando le regole di codifica percentuale adeguate. La e commerciale o il segno uguale all'interno del parametro UTM devono diventare %26 o %3D prima che URL venga finalizzato e pubblicato. Il codificatore URL in modalità a valore singolo esegue questa codifica in modo automatico e affidabile per te. Incolla il nome della tua campagna, seleziona la modalità Valore, copia il risultato codificato nel modello di collegamento.
Ogni URL di elaborazione dello strumento di analisi applica le stesse regole di analisi. Non c’è modo di aggirarlo e nessuno strumento può indovinare il tuo intento o le tue intenzioni. Il passaggio di codifica non è facoltativo; è l'unico modo per preservare i caratteri speciali all'interno dei valori della stringa di query. Verifica che i collegamenti funzionino come previsto prima di condividerli con le parti interessate o di pubblicarli nelle campagne.