ForHosting KIT · SEO

Costruisci un link UTM

Se qualcuno scrive Newsletter e un altro newsletter, una sola campagna si divide in due righe nei report: compili sorgente, mezzo e campagna e ottenga un link etichettato e ben codificato, oppure incolli un link esistente per leggerne le parti. Gratis nel suo browser.

Gratis
Funziona nel suo browser
Senza registrazione
I suoi dati restano sul dispositivo

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

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.

Perché le etichette scritte a mano rovinano i report

I parametri UTM, che prendono il nome da Urchin Traffic Monitor, sono stati adottati presto come modo semplice per indicare in un link da dove arriva una visita, e le loro cinque parti, sorgente, mezzo, campagna, termine e contenuto, sono rimaste in tutti i principali strumenti di analisi. Il sistema funziona solo se i valori vengono scritti sempre allo stesso modo, ed è proprio ciò che l'inserimento manuale sbaglia. Qualcuno scrive Newsletter, un altro newsletter, e la stessa campagna compare in righe separate, ognuna con una parte del traffico reale. Moltiplicato per decine di campagne e centinaia di link condivisi, il pannello smette di rispondere alla domanda per cui è nato.

Creare i link e controllarli prima del lancio

Lei indica l'indirizzo di base e i valori della campagna, e lo strumento restituisce un link etichettato e ben codificato che conserva i parametri già presenti nell'indirizzo. Può anche incollare un link etichettato esistente e riaverne le parti una per una. Così copre entrambi i lati del lavoro: generare un link per ogni post programmato sui social o per ogni link di un modello di newsletter, e controllare un gruppo di link di collaboratori diversi per scovare sorgenti o mezzi incoerenti prima che la campagna parta. I programmi di affiliazione usano lo stesso metodo per dare a ogni partner un link proprio, così il traffico viene attribuito senza dipendere da come il partner lo costruisce.

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.

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.

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.

Funziona con qualsiasi sito di destinazione?

Sì, i parametri UTM si aggiungono a qualunque URL valido, indipendentemente da dove porti il link.

Strumenti correlati

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

POSThttps://api.kit.forhosting.com/dev/utm

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 '{"url":"https://example.com/landing"}'

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({
    "url": "https://example.com/landing"
  })
});
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={
    "url": "https://example.com/landing"
},
)
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" => '{"url":"https://example.com/landing"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"url":"https://example.com/landing"}`)
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

{
  "url": "https://example.com/landing"
}

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

per richiesta$0.002

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.

Note tecniche

I cinque parametri, in breve

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. 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.

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.

Domande tecniche

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.

Leggi la documentazione completa del KIT →