Performance: Tuurbo Test

Cos'è Tuurbo Test

Tuurbo consente di verificare le ottimizzazioni di un sito prima di renderle visibili ai visitatori e di confrontarle con la versione originale anche dopo la pubblicazione.

Abbiamo creato Tuurbo Test per rispondere a una situazione ricorrente: utenti che volevano vedere il sito senza Tuurbo perché sospettavano che Tuurbo fosse la causa di anomalie sulla pagina. Quasi mai era così, e per questo abbiamo realizzato uno strumento che permette di verificarlo in sicurezza: un clic mostra la versione originale, un altro quella ottimizzata, e ogni differenza è subito visibile nel tuo browser.

Per usare queste funzioni occorre distinguere due impostazioni:

• La modalità del sito, test o produzione, stabilisce quale versione viene mostrata normalmente ai visitatori.
• La visualizzazione nel tuo browser, originale o ottimizzata, permette di confrontare le due versioni senza cambiare la modalità del sito.

L’estensione Chrome Tuurbo Test gestisce il secondo punto. Il cambio della modalità pubblica si effettua nella Suite Tuurbo.

Questa guida descrive il funzionamento dell’estensione con abilitazione per singolo sito. Le diciture possono differire nelle versioni precedenti.

Link utili

1. Che cosa significa “versione originale”

La versione originale è la versione della pagina senza le ottimizzazioni applicate da Tuurbo alla risposta.

Visualizzarla permette di confrontare il risultato di Tuurbo con il comportamento di partenza del sito. Non significa tornare a una vecchia revisione dei contenuti, annullare modifiche nel CMS o ripristinare un backup.

Nel pannello dell’estensione viene indicata come “Originale (senza Tuurbo)”.

2. Che cosa significa “versione ottimizzata”

La versione ottimizzata è la versione della pagina servita con le ottimizzazioni di Tuurbo applicabili a quella pagina e alla configurazione del sito.

Nel pannello viene indicata come “Ottimizzata (con Tuurbo)”.

Le differenze possono riguardare il caricamento e altri aspetti della pagina. Non tutte le ottimizzazioni producono un cambiamento visivo evidente: una pagina può mantenere lo stesso aspetto pur essendo ottimizzata.

Il confronto tra originale e ottimizzata serve a verificare il risultato e il funzionamento della pagina, oltre al suo aspetto.

3. Che cos’è la modalità test di Tuurbo

In modalità test, la versione mostrata normalmente ai visitatori è quella originale. Le ottimizzazioni possono essere visualizzate nel browser di chi usa Tuurbo Test e sceglie “Mostra ottimizzata”.

Nel pannello questa modalità è chiamata “Tuurbo in anteprima”.

La modalità test permette di controllare le ottimizzazioni prima di renderle pubbliche. Puoi verificare le pagine, confrontare le due versioni e segnalare eventuali problemi mentre gli altri visitatori continuano a vedere il sito originale.

L’anteprima si consulta sul dominio del sito. La modalità test di Tuurbo riguarda la visualizzazione delle ottimizzazioni e non crea, da sola, una copia separata del sito o un ambiente di test del CMS. Il termine tecnico staging usato nel rilevamento indica questa modalità di Tuurbo.

Che cosa vede ciascuno in modalità test

Installare o attivare l’estensione non rende pubbliche le ottimizzazioni. Per visualizzarle in anteprima, autorizza il sito e seleziona la versione ottimizzata dal pannello.

Quando usare la modalità test

• Prima di rendere pubbliche le ottimizzazioni.
• Quando vuoi controllare il comportamento di pagine e funzioni del sito.
• Quando devi confrontare un problema tra originale e ottimizzata.
• Quando lavori con il team Tuurbo alla verifica di una configurazione.

4. Che cos’è la modalità produzione di Tuurbo

In modalità produzione, la versione ottimizzata è quella mostrata normalmente ai visitatori, sulle pagine a cui si applicano le ottimizzazioni.

Nel pannello questa modalità è chiamata “Tuurbo attivo per tutti”.

L’estensione resta utile anche in produzione: puoi selezionare “Mostra originale” per confrontare il sito senza le ottimizzazioni nel tuo browser. Gli altri visitatori continuano a vedere la versione pubblica ottimizzata.

Che cosa vede ciascuno in modalità produzione

Mostrare l’originale nel tuo browser non disattiva Tuurbo sul sito. La modalità pubblica resta produzione finché non viene modificata nella Suite.

5. La differenza fondamentale: sito e browser

La modalità del sito e la versione che visualizzi nel tuo browser sono due informazioni separate.

Il pannello le separa con due etichette:

• “Visitatori del sito” descrive la versione pubblica.
• “Nel tuo browser” descrive la versione della pagina che stai visualizzando.

Esempio: anteprima in test

Il sito è in modalità test. Premi “Mostra ottimizzata”.

Il pannello mostra:

• Visitatori del sito: “Vedono la versione originale”.
• Nel tuo browser: “Ottimizzata (con Tuurbo)”.
• Messaggio: “Stai provando Tuurbo in anteprima”.
• Modalità: “Tuurbo in anteprima”.

La modalità pubblica resta test.

Esempio: confronto in produzione

Il sito è in produzione. Premi “Mostra originale”.

Il pannello mostra:

• Visitatori del sito: “Vedono la versione ottimizzata”.
• Nel tuo browser: “Originale (senza Tuurbo)”.
• Messaggio: “Stai confrontando la versione originale”.
• Modalità: “Tuurbo attivo per tutti”.

La modalità pubblica resta produzione.

6. Che cos’è l’estensione Tuurbo Test

Tuurbo Test è un’estensione per Google Chrome che rileva i segnali di Tuurbo nella pagina e mostra un pannello per confrontare la versione originale e quella ottimizzata.

Consente di:

• Leggere lo stato di collegamento rilevato sulla pagina.
• Distinguere modalità test e produzione.
• Capire cosa vedono i visitatori e cosa stai vedendo tu.
• Passare tra originale e ottimizzata nel tuo browser.
• Aprire la Suite per gestire Tuurbo.
• Ricordare i siti autorizzati e la preferenza di visualizzazione per ciascun sito.

L’estensione non installa Tuurbo su un sito e non pubblica le ottimizzazioni. Il sito deve essere collegato a Tuurbo per poter confrontare le versioni.

7. Requisiti per utilizzare l’estensione

Per seguire la guida usa Google Chrome aggiornato su computer, con la possibilità di installare estensioni. Devi poter aprire il sito da verificare e autorizzare l’estensione ad accedervi.

Per cambiare la modalità pubblica o completare il collegamento del sito devi anche avere accesso alla relativa configurazione nella Suite Tuurbo.

L’autorizzazione di Chrome e l’accesso alla Suite sono distinti: consentire l’accesso dell’estensione a un dominio non collega quel dominio alla piattaforma.

8. Come scaricare e installare Tuurbo Test

1. Apri Google Chrome sul computer.
2. Visita la pagina di Tuurbo Test sul Chrome Web Store.
3. Premi “Aggiungi a Chrome” o il pulsante di aggiunta mostrato da Chrome.
4. Conferma con “Aggiungi estensione”.
5. Apri il menu Estensioni, identificato dall’icona a forma di puzzle.
6. Trova Tuurbo Test e seleziona “Fissa” per tenerne visibile l’icona.

L’installazione e la gestione delle icone seguono le indicazioni della guida ufficiale di Chrome.

Per l’installazione dal Chrome Web Store non servono ZIP, comandi di build o modalità sviluppatore.

9. Primo utilizzo: abilita l’estensione sul sito

L’accesso viene richiesto per il sito che vuoi verificare. L’estensione non abilita automaticamente tutti i domini che visiti.

1. Apri il sito da verificare nella scheda attiva di Chrome.
2. Clicca sull’icona Tuurbo Test.
3. Controlla che “Attiva estensione” sia acceso.
4. Premi “Abilita su questo sito”.
5. Nella richiesta di Chrome premi “Consenti”, o il comando equivalente di autorizzazione.
6. Attendi il reload della pagina.
7. Leggi lo stato nel pannello di Tuurbo Test.

Dopo il consenso, l’abilitazione viene completata dal background dell’estensione anche se Chrome chiude il popup. Non occorre premere una seconda volta “Abilita su questo sito”.

Quando il sito è abilitato, il popup mostra “Abilitata su …”, seguito dal dominio. Questa frase conferma l’accesso dell’estensione, non la presenza di Tuurbo sul sito.

Il permesso resta memorizzato. Quando ricarichi o riapri lo stesso sito, il pannello può essere mostrato automaticamente, se l’estensione è attiva.

Domini e sottodomini

Un’autorizzazione per https://www.esempio.it non abilita automaticamente https://shop.esempio.it o un altro sito.

Controlla sempre l’indirizzo finale dopo eventuali redirect: esempio.it e www.esempio.it possono essere origini diverse. Le preferenze di confronto distinguono anche protocollo e porta, per esempio HTTP e HTTPS.

10. Come leggere il pannello

“Connesso”

La pagina contiene segnali che permettono di rilevare Tuurbo. Lo stato è mostrato in verde.

“Connesso” non significa automaticamente che stai visualizzando l’ottimizzata: puoi essere connesso a Tuurbo mentre confronti la versione originale. Leggi anche “Nel tuo browser”.

“Visitatori del sito”

Indica la versione pubblica:

• “Vedono la versione originale”: Tuurbo è in modalità test.
• “Vedono la versione ottimizzata”: Tuurbo è in modalità produzione.
• “Versione pubblica non rilevata”: i segnali disponibili non identificano una modalità supportata.

“Nel tuo browser”

Indica la versione che stai visualizzando:

• “Originale (senza Tuurbo)”.
• “Ottimizzata (con Tuurbo)”.

Il messaggio di confronto

La modalità in fondo al pannello

• “Tuurbo in anteprima” indica test.
• “Tuurbo attivo per tutti” indica produzione.
• “Visibilità pubblica sconosciuta” indica che la modalità non è determinabile dai segnali disponibili.

Quando disponibili, il tooltip della modalità riporta versione di Tuurbo, data di ottimizzazione e fonte del rilevamento. La versione di Tuurbo indicata qui è distinta dalla versione dell’estensione Chrome.

11. Come provare l’ottimizzata in modalità test

1. Assicurati che il sito sia collegato a Tuurbo e configurato in modalità test.
2. Apri il sito e abilita l’estensione su quel dominio, se non lo hai già fatto.
3. Nel pannello verifica “Tuurbo in anteprima”.
4. Premi “Mostra ottimizzata”.
5. Attendi il completamento del caricamento.
6. Controlla che “Nel tuo browser” mostri “Ottimizzata (con Tuurbo)”.
7. Verifica le pagine e le funzioni che ti interessano.

Gli altri visitatori continuano a vedere l’originale.

Per tornare alla visualizzazione standard della modalità test, premi “Mostra originale” e attendi il reload. Il sito rimane in test in entrambi i casi.

12. Come confrontare l’originale in modalità produzione

1. Apri il sito e abilita l’estensione sul dominio.
2. Nel pannello verifica “Tuurbo attivo per tutti”.
3. Premi “Mostra originale”.
4. Attendi il caricamento della pagina.
5. Controlla che “Nel tuo browser” mostri “Originale (senza Tuurbo)”.
6. Confronta il risultato con l’ottimizzata.

I visitatori continuano a vedere la versione pubblica ottimizzata.

Per tornare alla visualizzazione standard della produzione, premi “Mostra ottimizzata” e attendi il reload.

13. Che cosa succede quando cambi versione

Il pulsante indica la versione che verrà mostrata dopo il clic, non quella che stai già vedendo.

Durante il cambio, il pulsante mostra “Caricamento versione originale…” o “Caricamento versione ottimizzata…” e rimane disabilitato fino al reload. Attendi il completamento: non servono clic ripetuti.

La preferenza è associata al sito nel profilo di Chrome in uso. Se hai più schede aperte sulla stessa origine, il cambio ricarica la scheda corrente; le altre adotteranno la nuova preferenza al loro prossimo reload.

Il cambio non modifica la modalità pubblica, i contenuti nel CMS o le impostazioni del sito nella Suite.

14. Come passare da test a produzione

Per rendere pubbliche le ottimizzazioni devi intervenire sulla configurazione del sito nella Suite Tuurbo.

1. Completa il confronto delle pagine in modalità test.
2. Apri la Suite Tuurbo, anche tramite “Apri dashboard” nel pannello.
3. Accedi e seleziona il sito corretto.
4. Individua l’impostazione della modalità del sito e passa da test a produzione.
5. Attendi che la modifica sia applicata.
6. Ricarica il sito e verifica la modalità rilevata dall’estensione.
7. Assicurati di visualizzare l’ottimizzata anche nel tuo browser: una preferenza personale di confronto può farti vedere una versione diversa da quella pubblica.

La posizione e il nome del comando nella Suite possono variare. Se l’impostazione non è disponibile nel tuo account, chiedi supporto al team Tuurbo.

Il pulsante “Mostra ottimizzata” dell’estensione non sostituisce questo passaggio e non pubblica le ottimizzazioni.

15. Come tornare dalla produzione alla modalità test

Apri la Suite, seleziona il sito e modifica la sua modalità da produzione a test. Dopo che la modifica è stata applicata, ricarica le pagine e verifica “Tuurbo in anteprima” nel pannello.

La versione pubblica torna a essere l’originale; puoi continuare a visualizzare l’ottimizzata nel tuo browser tramite l’estensione.

Premere soltanto “Mostra originale” mentre il sito è in produzione cambia la tua visualizzazione, senza riportare il sito in test.

16. Se Tuurbo non è collegato o la pagina è esclusa

Su un sito autorizzato dove Tuurbo non viene rilevato, il pannello mostra subito:

• Stato rosso: “Non connesso o Escluso”.
• Messaggio: “Tuurbo non risulta collegato a questo sito web”.
• Pulsante: “Effettua il collegamento”.

Il pulsante apre la Suite Tuurbo per gestire il collegamento. Non collega automaticamente il sito e non rende disponibili ottimizzazioni su un dominio dove Tuurbo non è configurato.

Il messaggio riguarda la pagina corrente e non basta, da solo, a dimostrare che tutto il dominio sia scollegato. Alcune pagine possono essere escluse oppure il rilevamento può non essere ancora completo.

Quando l’estensione identifica una pagina esclusa durante un test, può mostrare “Questa pagina è esclusa dalle ottimizzazioni” e il pulsante “Termina il test su questo sito”. Questo comando rimuove l’inversione di visualizzazione del browser per quel sito; non modifica la modalità pubblica.

17. Come organizzare il pannello

• Riduci o espandi: usa la freccia nell’intestazione.
• Trasparenza: usa il relativo pulsante per cambiare l’aspetto del pannello.
• Sposta: trascina l’intestazione per posizionarlo dove preferisci.

Queste impostazioni riguardano l’interfaccia dell’estensione. Ridurre il pannello o cambiarne la trasparenza non cambia la versione della pagina.

18. Come disattivare l’estensione e ripristinare la visualizzazione standard

Per un solo sito, mantenendo attiva l’estensione

Torna alla versione standard della modalità pubblica:

• Sito in test: premi “Mostra originale”.
• Sito in produzione: premi “Mostra ottimizzata”.

Per disattivare Tuurbo Test dal suo popup

1. Clicca sull’icona dell’estensione.
2. Spegni “Attiva estensione”.

Questa disattivazione rimuove i pannelli, le regole di confronto e le preferenze di versione dei siti. I siti autorizzati restano memorizzati. Se riattivi l’estensione, le vecchie inversioni non vengono ripristinate automaticamente.

Ricarica eventuali altre schede già aperte per farle tornare alla versione pubblica. Disattivare Tuurbo Test non disattiva Tuurbo sul sito.

Per revocare l’accesso a un sito

Apri chrome://extensions, trova Tuurbo Test, seleziona “Dettagli” e modifica l’accesso ai siti per rimuovere il dominio. Per la gestione dei permessi puoi consultare la guida ufficiale di Chrome.

L’estensione rimuove il pannello e le regole del sito revocato. Gli altri siti autorizzati restano abilitati. Per tornare a usarla sul dominio, autorizzalo nuovamente dal popup.

19. Permessi: perché vengono richiesti

Per funzionare, Tuurbo Test deve poter leggere i segnali presenti nella pagina e nelle risposte HTTP, mostrare il pannello e modificare l’header di confronto delle richieste di navigazione.

La richiesta “Abilita su questo sito” consente queste operazioni sul sito scelto. Non abilita automaticamente gli altri domini.

La modifica dell’header permette di richiedere una versione diversa solo nel tuo browser. Le preferenze vengono conservate nel profilo Chrome in uso e non diventano impostazioni pubbliche del sito.

Autorizzare il dominio, collegare il sito a Tuurbo e attivare la produzione sono tre azioni diverse, con scopi diversi.

20. Un percorso pratico di verifica

Per verificare un sito prima della produzione:

1. Configura il sito in modalità test nella Suite.
2. Installa Tuurbo Test e autorizza il dominio.
3. Seleziona l’ottimizzata e controlla la home e alcune pagine rappresentative.
4. Verifica immagini, menu, collegamenti, moduli e interazioni importanti.
5. Su un e-commerce, controlla anche la navigazione del catalogo e il comportamento del carrello.
6. Torna all’originale sulla stessa pagina per confrontare eventuali differenze.
7. Se rilevi un problema, annota URL, modalità del sito e versione visualizzata nel browser.
8. Condividi la verifica con il team Tuurbo.
9. Quando il risultato è approvato, passa alla produzione dalla Suite.
10. Ricarica e verifica che il pannello distingua correttamente la versione pubblica e quella personale.

Per confrontare le prestazioni, usa condizioni il più possibile simili: stessa pagina, stesso dispositivo e stesso stato di accesso al sito. Una sola apertura o una differenza visiva non bastano a misurare il risultato di tutte le ottimizzazioni.

21. Problemi comuni e soluzioni

Se stai usando una copia locale aggiornata manualmente, ricarica anche l’estensione da chrome://extensions prima di ricaricare il sito: popup e background devono appartenere alla stessa build. Questo passaggio è distinto dal normale utilizzo della copia installata dallo Store.

22. Che cosa inviare all’assistenza

Per rendere utile una segnalazione includi:

• L’URL completo della pagina.
• La modalità che hai configurato nella Suite: test o produzione.
• La versione indicata sotto “Nel tuo browser”.
• Il messaggio esatto mostrato dal pannello o dal popup.
• I passaggi che hai eseguito per arrivare al problema.
• Uno screenshot del pannello.
• Se disponibili, versione di Chrome, versione dell’estensione e dettagli del tooltip Tuurbo.

Specifica se il comportamento cambia passando tra originale e ottimizzata. Non sono necessarie password o credenziali del sito nella segnalazione.

23. Domande frequenti

Se installo Tuurbo Test, attivo Tuurbo per tutti?

No. L’installazione aggiunge uno strumento di confronto al tuo browser. La modalità pubblica viene gestita nella Suite.

“Abilita su questo sito” installa Tuurbo sul dominio?

No. Autorizza soltanto l’estensione ad accedere a quel sito. Il collegamento alla piattaforma è un passaggio separato.

In modalità test gli altri visitatori vedono l’ottimizzata che sto provando?

I visitatori che navigano normalmente continuano a vedere l’originale. L’anteprima che scegli con l’estensione riguarda il tuo browser.

In produzione “Mostra originale” disattiva le ottimizzazioni pubbliche?

No. Cambia solo la tua visualizzazione. Il pannello continua a indicare “Tuurbo attivo per tutti”.

Chi visita il sito deve installare l’estensione?

No. In produzione i visitatori ricevono normalmente la versione ottimizzata, senza usare Tuurbo Test.

Posso confrontare le versioni anche dopo essere passato in produzione?

Sì. Puoi alternare originale e ottimizzata nel tuo browser mentre la versione pubblica resta ottimizzata.

Se chiudo e riapro il sito devo autorizzarlo di nuovo?

Normalmente no: il permesso resta memorizzato finché non viene revocato. Deve essere attiva anche l’estensione nel profilo Chrome che stai usando.

Se cambio computer o profilo, trovo necessariamente le stesse preferenze?

Questa guida non presume la sincronizzazione tra dispositivi. Controlla installazione, autorizzazioni e preferenze nel profilo in cui stai lavorando.

Nascondere o ridurre il pannello cambia la versione?

No. La freccia modifica solo la visibilità dei dettagli del pannello. Per cambiare versione usa il pulsante dedicato.

Perché una pagina è esclusa mentre altre sono ottimizzate?

La presenza di Tuurbo sul dominio non implica che ogni pagina riceva tutte le ottimizzazioni. Verifica le esclusioni e la configurazione della pagina con la Suite o l’assistenza.

Posso usare l’estensione sulle pagine interne di Chrome?

No. Le pagine come chrome://extensions e il Chrome Web Store non sono pagine su cui Tuurbo Test può mostrare il proprio pannello.

24. Approfondimento tecnico: come viene selezionata la versione

Questa sezione è destinata a sviluppatori e assistenza. Per l’utilizzo quotidiano sono sufficienti i pulsanti dell’estensione.

L’header debug: 1

Tuurbo Test usa l’header di richiesta debug: 1 per invertire la versione normalmente servita dalla modalità del sito.

Quando torni alla versione standard, l’estensione rimuove l’header di confronto per il sito. Le regole riguardano le richieste di navigazione della stessa origine; non cambiano la configurazione pubblica di Tuurbo.

L’header di risposta x-tb-stage

• production identifica la modalità produzione.
• staging identifica la modalità test.
• forward indica una risposta originale; per distinguere la modalità pubblica può servire il contesto registrato dall’estensione prima del cambio.

La modalità del sito non determina da sola quale versione sta vedendo questo browser: va considerato anche debug: 1.

Il meta tuurbo-log

La pagina può contenere un meta come questo:

<meta name="tuurbo-log" content="status=ready, env=production, version=v19.1.0, pageOptimizedAt=1790612785000">

I campi utilizzati sono:

• status: ready è un segnale di rilevamento di Tuurbo.
• env: identifica l’ambiente, per esempio production o staging.
• version: versione di Tuurbo riportata dalla pagina.
• pageOptimizedAt: timestamp in millisecondi usato per mostrare la data di ottimizzazione.

Il valore ready non va interpretato da solo come prova della versione visualizzata dal browser. Per distinguere originale e ottimizzata occorre considerare anche ambiente e header di confronto.

Il meta può essere assente: l’estensione usa anche gli header della pagina e aggiorna il pannello quando riceve nuovi dati.

Come controllare gli header in Chrome DevTools

Apri DevTools, vai in Network, ricarica e seleziona la richiesta principale della pagina, di tipo Document. Nella sezione Headers controlla gli header di risposta x-tb-stage e, se presente, x-tb-version; negli header di richiesta cerca debug.

Gli header di un file CSS, JavaScript o immagine non bastano a descrivere la versione del documento principale. Per una verifica coerente confronta i dati del documento, il meta della pagina e lo stato del pannello.

25. Glossario