Blog
SignalHost per Joomla: installa l’estensione, collegala una volta e il tracciamento lato server è attivo
Pubblicato · 7 min di lettura
Disponibile su Joomla Extensions Directory
L’estensione SignalHost porta Google Tag Manager lato server su un sito Joomla senza una sola riga di codice da incollare. Aggiunge il loader di tracciamento a ogni pagina del tuo sito, lo mantiene aggiornato quando qualcosa cambia dalla nostra parte e lo toglie di nuovo quando ti disconnetti. Questa guida segue l’ordine in cui lo incontri: installazione del pacchetto, collegamento di un container, verifica del funzionamento e cosa fare quando qualcosa non va.
Prima di iniziare
- Joomla 4.4, 5 o 6, su PHP 7.4 o successivo.
- Un account SignalHost. Il piano gratuito basta per provarla: 10.000 richieste al mese e un container. Puoi creare l’account durante il collegamento.
- Un account Super User nell’amministrazione di Joomla: collegare e disconnettere richiedono l’autorizzazione a configurare il componente SignalHost, che i Super User hanno.
1. Installa l’estensione
Scarica il pacchetto dalla Joomla Extensions Directory, dove è elencato come SignalHost Server-Side Tagging. Nell’amministrazione di Joomla apri Sistema › Installa › Estensioni e carica il file zip.
È un unico pacchetto in due parti: il componente SignalHost, dove colleghi il sito e ne vedi lo stato, e il plugin di sistema System - SignalHost Server-Side Tagging, che mette il codice nelle tue pagine. L’installazione attiva il plugin da sola; non stampa nulla finché il sito non è collegato.
2. Collega il sito a un container
Apri Componenti › SignalHost e premi «Connect with SignalHost». Se non hai ancora un account, «Create a free account» ti porta invece alla registrazione. Nulla viene inviato a SignalHost prima che tu prema il pulsante.
Su signalhost.io, accedi. La schermata successiva elenca cosa potrà e cosa non potrà fare l’estensione, e chiede quale container deve usare il sito. Un container è il tuo server di tagging: un container web e un container server di Tag Manager, costruiti nel tuo account Google, così restano tuoi.
Scegli un container esistente, oppure premi «Nuovo container per …» con il nome del tuo sito e segui la breve procedura guidata. La costruzione di un nuovo container richiede qualche minuto; puoi collegarlo subito, e il codice viene aggiunto non appena è pronto. Premi «Collega». Torni in Componenti › SignalHost con il messaggio «Connected». Il codice di SignalHost è ora aggiunto a ogni pagina del tuo sito.
3. Verifica che il codice sia sul tuo sito
La schermata ora dice «Tracking is live», oppure «Tracking starts as soon as your container is ready» mentre un nuovo container è ancora in costruzione. Poi leggi la riga «On your home page»: subito dopo il collegamento, l’estensione recupera la tua home page come farebbe un visitatore e cerca il suo codice. «Code found» è la risposta che vuoi. «Check again» ripete il controllo in qualsiasi momento, e le altre risposte sono descritte in «Quando qualcosa non funziona».
4. Provalo
Apri il tuo sito in una finestra privata e visita qualche pagina; un visitatore che rifiuta il tuo banner dei cookie viene comunque contato, come ping senza cookie di Google. Poi premi «Open statistics & settings» per aprire la pagina del tuo container su signalhost.io.
In «Statistiche avanzate», la scheda «Recenti» mostra le visualizzazioni di pagina degli ultimi 30 minuti, comprese le tue. «Esegui i controlli», sotto «Risoluzione dei problemi» in fondo alla pagina, confronta ciò che il tuo server di tagging ha ricevuto con ciò che Google Analytics riporta per gli stessi 30 minuti. Un numero più basso in Analytics è normale: esclude i visitatori che hanno rifiutato i cookie. Dal piano Growth in su, «Monitoraggio eventi in tempo reale» mostra ogni evento man mano che arriva.
Cosa aggiunge l’estensione al tuo sito
Un piccolo script e un contatto ogni ora:
- Il loader di Google Tag Manager, nell’head delle pagine del tuo sito, puntato al tuo indirizzo di tagging invece che a googletagmanager.com. Carica da lì il tuo container Tag Manager. Il plugin lo aggiunge tramite il Web Asset Manager di Joomla, così porta un nonce CSP quando il tuo sito ne usa uno. Non viene mai eseguito nell’amministrazione, in un feed o in una vista del solo componente.
- Una volta all’ora, dopo che una pagina è stata inviata, il plugin contatta signalhost.io per restare aggiornato. Invia solo le versioni dell’estensione, di Joomla e di PHP, l’indirizzo del tuo sito e se il codice è stato trovato nella tua home page: nessun dato dei visitatori, nessun contenuto, nessun account utente. Se signalhost.io non è raggiungibile, il tuo sito mantiene l’ultima configurazione valida.
Ogni richiesta lascia il browser in una forma che gli ad blocker non riconoscono, e il tuo server di tagging la inoltra a Google Analytics 4 e alle piattaforme pubblicitarie che configuri nella pagina del container: Google Ads, Meta, TikTok e altre. Il tracciamento segue il tuo banner dei cookie tramite Google Consent Mode; metti il codice del banner prima di quello di SignalHost.
L’estensione non legge moduli né ordini. Le visualizzazioni di pagina arrivano da sole; un acquisto o un lead raggiunge il tuo container quando il tuo sito lo invia al data layer.
Il tuo dominio di tracciamento
Il tuo container parte su un indirizzo sotto signalhost.io. Con un piano a pagamento, «Configura il tuo dominio» nella pagina del container lo sposta su un sottodominio del tuo sito, come sgtm.tuosito.com, con un solo record DNS presso il tuo provider. Quell’indirizzo sopravvive alle liste di filtri e mantiene first-party i cookie dei clic. Quando diventa attivo, l’estensione vi sposta il tuo sito al suo contatto successivo, di solito entro un’ora, e svuota la cache delle pagine di Joomla. Non c’è nulla da sostituire a mano, e fino ad allora il vecchio indirizzo continua a funzionare.
Aggiungere SignalHost a mano
Puoi anche incollare il codice tu stesso. Nella pagina del container, trova il tuo snippet nella scheda «Installa sul tuo sito» e premi «Copia». Incollalo nell’head di ogni pagina (in Joomla, nel template del tuo sito), subito dopo lo script del tuo banner dei cookie, e premi «Fatto». «Copia per agente IA» affida lo stesso lavoro a un agente di programmazione.
Incollando a mano rinunci a ciò che fa l’estensione: nulla controlla la tua home page, nulla rimuove il codice quando ti disconnetti, il loader non riceve un nonce CSP a meno che tu non lo aggiunga, e quando il tuo dominio diventa attivo sostituisci tu il codice, da «Aggiorna lo snippet del tuo sito» sulla scheda o dall’email che annuncia il dominio. Non usare mai entrambe le strade: due copie contano ogni visita due volte.
Aggiornamenti, gestione e disconnessione
Gli aggiornamenti arrivano tramite il sistema di aggiornamento di Joomla, in Sistema › Aggiorna › Estensioni, come per qualsiasi altra estensione.
«Disconnect», nella schermata Componenti › SignalHost, chiede conferma una volta, poi revoca l’accesso del sito, toglie il codice da ogni pagina e svuota la cache delle pagine di Joomla. Il tuo container e le sue statistiche restano, e puoi collegarti di nuovo in qualsiasi momento.
Su signalhost.io, la pagina del container dice «Installato dall’estensione per Joomla» sul tuo sito. Il suo pulsante «Gestisci» porta a Impostazioni › Siti collegati, dove funziona anche «Disconnetti»: l’estensione smette di caricare SignalHost al suo contatto successivo, di solito entro un’ora.
Disinstallare il pacchetto rimuove tutto ciò che l’estensione aveva salvato. Disconnetti prima, così anche SignalHost sa che il sito non c’è più.
Quando qualcosa non funziona
- «Code not found»: il plugin potrebbe essere disattivato. Abilita System - SignalHost Server-Side Tagging nella gestione dei plugin di Joomla, poi premi «Check again».
- «Could not check (your server refused a request to itself)»: il tuo hosting blocca le richieste verso il suo stesso indirizzo. Questo non dice nulla sui tuoi visitatori; cerca il tuo indirizzo di tagging nel sorgente della tua home page.
- «An older copy is on the page» oppure «The code is on the page twice»: una copia è stata incollata a mano in un template o in un’altra estensione. Rimuovila; l’estensione aggiunge quella attuale, e due copie contano ogni visita due volte.
- Un avviso che il tuo sito carica già un container Tag Manager con lo snippet di Google: rimuovi quello snippet, perché ora è SignalHost a caricare il container ed entrambi insieme contano ogni visita due volte.
- «This site's address has changed since it was connected»: su una copia, come uno staging, non viene inviato nulla. Se il sito reale si è spostato, disconnettilo e collegalo di nuovo.
- Componenti › SignalHost continua invece ad aprire la dashboard: su un Joomla appena installato, il tour guidato del primo accesso lo fa con ogni pagina di amministrazione finché non lo nascondi.
- Qualsiasi altra cosa: scrivi a hello@signalhost.io indicando l’indirizzo del tuo sito.
Marchi
SignalHost è un prodotto indipendente di Algorithmo GmbH e non è affiliato né approvato da Open Source Matters, Google, Meta o TikTok. Google Analytics, Google Ads e Google Tag Manager sono marchi di Google LLC; Meta è un marchio di Meta Platforms, Inc.; TikTok è un marchio di ByteDance Ltd.; Joomla! è un marchio di Open Source Matters, Inc.

