Costruisci un link UTM
I parametri UTM sono i tag che aggiungi a un link per far sapere a Google Analytics da quale campagna, canale o annuncio arriva ogni visita. Questo strumento del KIT costruisce il link completo a partire dall’indirizzo di destinazione e dai parametri che scegli, senza errori di battitura o maiuscole sbagliate.
Esegui gratis nel browser
Funziona nel tuo browser: gratis, senza registrazione, i file non escono dal tuo dispositivo.
I cinque parametri, in breve
Sorgente (source, ad esempio “newsletter”), mezzo (medium, come “email” o “social”), campagna (campaign, il nome dell’iniziativa), e in aggiunta termine e contenuto per distinguere due varianti dello stesso annuncio. Insieme raccontano non solo che qualcuno ha cliccato, ma da dove e grazie a cosa, campagna per campagna, senza dover indovinare a occhio nei report finali di Google Analytics o di un altro strumento di misurazione.
L’errore più comune: l’incoerenza
Se una volta scrivi “Newsletter” e la volta dopo “newsletter”, per Google Analytics sono due sorgenti diverse e i dati si spezzano in due righe invece di sommarsi in una. Questo strumento aiuta a mantenere coerenza tra i link che generi, così i report restano leggibili nel tempo invece di moltiplicare varianti dello stesso canale senza che nessuno se ne accorga finché è tardi.
Gratis nel browser
La costruzione del link avviene nel browser, gratis e senza limiti: compili i campi, ottieni il link completo, lo copi. Per generarne in blocco — ad esempio un link diverso per ogni inserzione di una campagna — la stessa funzione è disponibile via API, a $0.002 a richiesta, comoda quando gli annunci da tracciare sono molti insieme e non uno alla volta.
Casi d'uso
Newsletter mensile
Francesca Colombo aggiunge parametri UTM coerenti a ogni link della newsletter mensile, così a fine mese sa esattamente quanti click ha generato l’email rispetto ai social.
Campagna con più annunci
Rossi & Figli S.r.l. crea un link UTM diverso per ogni variante dell’annuncio pubblicitario, per capire quale testo converte meglio prima di aumentare il budget.
Link nella bio dei social
Un piccolo brand di Milano usa un link UTM specifico nella bio di Instagram, distinto da quello usato nelle storie, per confrontare le due fonti di traffico nel tempo.
Domande frequenti
A cosa servono davvero i parametri UTM?
Permettono a Google Analytics e agli altri strumenti di misurazione di riconoscere da quale campagna, canale o annuncio arriva ogni visita, invece di vedere solo “traffico diretto”.
Devo usarli sempre in minuscolo?
È buona pratica sì, perché maiuscole e minuscole diverse vengono trattate come sorgenti distinte: la coerenza conta più della forma esatta.
Quanto costa costruire un link UTM?
Nel browser è gratis e senza limiti, senza registrazione. Solo la generazione in blocco via API, a $0.002 a richiesta, è a pagamento.
I parametri che inserisco vengono registrati da qualche parte?
No, il link viene costruito nel browser: i parametri che inserisci non vengono inviati a nessun server durante la creazione.
Posso costruire link UTM in blocco per una campagna intera?
Nel browser uno alla volta; per generarne molti insieme, usa la stessa funzione via API, a $0.002 a richiesta.
Funziona con qualsiasi sito di destinazione?
Sì, i parametri UTM si aggiungono a qualunque URL valido, indipendentemente da dove porti il link.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/dev/utm \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"items":["valor-1","valor-2"]}'const res = await fetch("https://api.kit.forhosting.com/dev/utm", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"items": [
"valor-1",
"valor-2"
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/dev/utm",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"items": [
"valor-1",
"valor-2"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/utm", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"items":["valor-1","valor-2"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/utm", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"items": [
"valor-1",
"valor-2"
]
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev.utm",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |