SignalHost per TYPO3: installa l’estensione, collega ogni sito e il tracciamento lato server è attivo

• TYPO3 13.4 LTS o 14.3 LTS, su PHP 8.2 o successivo con l’estensione sodium.
• 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 amministratore del backend. Il modulo SignalHost è riservato agli amministratori.
• Un sito la cui base, nella sua configurazione del sito, contiene un dominio, come https://www.example.com/.

In un’installazione basata su Composer, richiedila da Packagist:

composer require signalhost/server-side-tagging

In modalità classica, installala invece dall’Extension Manager; si trova nel TYPO3 Extension Repository con la chiave signalhost_server_side_tagging. Non aggiunge nulla a un sito finché quel sito non è collegato.

Nel backend di TYPO3 apri Sites › SignalHost (Site Management › SignalHost su TYPO3 13), dove ogni sito ha la sua scheda. Dopo il collegamento SignalHost ti rimanda all’indirizzo del sito stesso, quindi apri il backend sotto il dominio di quel sito; altrimenti la scheda ha un pulsante che apre la pagina lì, dove potresti dover accedere una volta.

Nella scheda del sito premi «Connect with SignalHost», oppure «Create a free account» se non hai ancora un account. 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», e torni sulla scheda con il messaggio «Connected». Il codice di SignalHost è ora aggiunto a ogni pagina di questo sito. Ripeti la procedura per ogni sito che vuoi tracciare.

La scheda del sito 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».

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.

Un piccolo script per ogni sito collegato e un contatto ogni ora:

• Il loader di Google Tag Manager, subito prima della fine dell’head di ogni pagina frontend, puntato all’indirizzo di tagging del sito invece che a googletagmanager.com. Carica da lì il tuo container Tag Manager. Viene inserito nella pagina finita dopo la cache delle pagine di TYPO3, quindi non serve svuotare alcuna cache. Se il sito applica la Content Security Policy di TYPO3, l’estensione vi aggiunge l’indirizzo di tagging e consente il loader tramite il suo hash, a meno che la policy non consenta già gli script inline.
• Una volta all’ora, dopo che una risposta è stata inviata, l’estensione contatta signalhost.io per restare aggiornata. Invia solo le versioni dell’estensione, di TYPO3 e di PHP, l’indirizzo del sito e se il codice è stato trovato nella home page: nessun dato dei visitatori, nessun contenuto, nessun account utente. Se signalhost.io non è raggiungibile, il 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. Il loader viene dopo un banner che si trova nell’head; un banner caricato più tardi deve impostare i valori predefiniti di Consent Mode prima del loader.

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 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 quel sito al suo contatto successivo, di solito entro un’ora, e la sua Content Security Policy si adegua. Non c’è nulla da sostituire a mano, e fino ad allora il vecchio indirizzo continua a funzionare.

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 TYPO3, tramite il tuo template o TypoScript), 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, in un sito che applica la Content Security Policy di TYPO3 lo script e l’indirizzo di tagging vanno consentiti a mano, 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.

Aggiornala nello stesso modo in cui l’hai installata: tramite Composer, oppure dall’Extension Manager in modalità classica.

«Disconnect», nella scheda di un sito, chiede conferma una volta, poi rimuove subito il codice di SignalHost da ogni pagina di quel sito e ne revoca l’accesso. Gli altri siti restano collegati, e il tuo container e i suoi dati restano nel tuo account SignalHost.

Su signalhost.io, la pagina del container dice «Installato dall’estensione per TYPO3» 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.

Disattivare l’estensione nell’Extension Manager, in modalità classica, revoca l’accesso di ogni sito e rimuove ciò che aveva salvato. composer remove non esegue codice di TYPO3, quindi disconnetti prima ogni sito; altrimenti restano elencati in Impostazioni › Siti collegati, e li disconnetti da lì.

• La scheda dice che dopo il collegamento SignalHost ti rimanda all’indirizzo del sito stesso: hai aperto il backend sotto un altro dominio. Usa il pulsante sottostante per aprire la pagina sul dominio del sito.
• «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, in TypoScript 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.
• Qualsiasi altra cosa: scrivi a hello@signalhost.io indicando l’indirizzo del tuo sito.

SignalHost è un prodotto indipendente di Algorithmo GmbH e non è affiliato né approvato dalla TYPO3 Association, da Google, da Meta o da 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.; TYPO3 è un marchio registrato della TYPO3 Association.