Panoramica
Questo articolo fornisce i passaggi per la risoluzione dei problemi più comuni riscontrati durante l'utilizzo di alcune funzionalità di Funnel, siti web e webinar. Questi passaggi aiutano gli utenti a risolvere problemi relativi a codici di tracciamento, campi personalizzati (Custom Fields), immagini, problemi di rendering e altro ancora.
- Panoramica
- Problemi comuni e passaggi di risoluzione
- 1. Il codice di tracciamento <head> non fa parte del tag <head>
- 2. I Campi personalizzati aggiornati non vengono visualizzati nell'anteprima/sito
- 3. Immagini sfocate o a caricamento lento
- 4. I valori personalizzati si rompono o non vengono visualizzati nell'anteprima
- 5. Identificare il Funnel, la pagina o la Location di un sito in produzione
- 6. Il sito non viene visualizzato correttamente (problemi di allineamento, loop di aggiornamento, ecc.)
- 7. Il punteggio o la velocità di caricamento della pagina sono troppo bassi
- 8. Gli header di sicurezza bloccano le risorse del sito
Problemi comuni e passaggi di risoluzione
1. Il codice di tracciamento non fa parte del tag <head>
Problema
I codici di tracciamento dell'intestazione (head) e del corpo (body) vengono iniettati lato client (browser), quindi non appariranno all'interno del tag <head> nel codice sorgente. Quello che si vede nel sorgente della pagina è il dato HTML iniziale utilizzato per il rendering. Squadd inietta dinamicamente i codici di tracciamento lato client, il che significa che non saranno presenti nella visualizzazione statica del sorgente.
Anche se gli utenti implementano soluzioni di tracciamento personalizzate, come Google Tag Manager (GTM), quegli script funzioneranno comunque come previsto; l'iniezione lato client è compatibile con GTM e strumenti simili.
Spiegazione
Quello che si vede nel codice sorgente sono i dati della pagina utilizzati per il rendering, non i codici di tracciamento iniettati dinamicamente.
Passaggi di risoluzione
Fare riferimento alla spiegazione video su come GoHighLevel / Squadd inietta i codici di tracciamento head e body: Link video
2. I Campi personalizzati aggiornati non vengono visualizzati nell'anteprima/sito
Problema
I valori dei Campi personalizzati non vengono visualizzati sul sito quando aggiornati tramite backend (es. automazioni, Workflow).
Spiegazione
- I Campi personalizzati sono archiviati nel database dei Contatti, ma il sito recupera i dati dei campi dalla memoria locale (local storage) o dai cookie per visualizzarli nella pagina successiva.
Quando un contatto compila un modulo, un sondaggio o un modulo d'ordine, i valori inseriti vengono salvati nella memoria locale.
Se i valori dei Campi personalizzati (come punteggi o costi stimati) vengono aggiornati tramite Automazioni, Workflow o altri processi backend, questi non vengono salvati nella memoria locale.
Di conseguenza, questi campi non verranno visualizzati nelle pagine del Funnel, poiché la visualizzazione frontend si basa sui dati archiviati localmente nel browser.
Questo comportamento è intenzionale, e garantisce un rendering più veloce e la personalizzazione per i dati inviati direttamente dagli utenti.
Passaggi di risoluzione
Verificare se i Campi personalizzati interessati vengono popolati tramite moduli/sondaggi o tramite automazione backend.
Se vengono aggiornati da backend, non appariranno nella pagina del Funnel perché non esiste una corrispondente voce nella memoria locale.
Per garantire la visualizzazione di questi campi:
Aggiungere i campi rilevanti al modulo o sondaggio in modo che l'input dell'utente attivi il salvataggio nella memoria locale.
In alternativa, utilizzare uno script personalizzato o una logica apposita per trasferire i valori dei campi aggiornati da backend nella memoria locale prima del rendering.
⚠ Nota - Solo i Campi personalizzati aggiornati tramite input diretto dell'utente (es. invio di moduli o sondaggi) vengono salvati nella memoria locale e visualizzati nella pagina del Funnel.
I campi aggiornati tramite automazione backend (come punteggi o aggiornamenti CRM) non appariranno sul sito.
3. Immagini sfocate o a caricamento lento
Problema
Alcune immagini appaiono sfocate o si caricano lentamente a causa delle impostazioni di ottimizzazione delle immagini.
Spiegazione
L'ottimizzazione delle immagini migliora la velocità della pagina, ma applica un'impostazione di qualità universale. Alcune immagini potrebbero perdere nitidezza se l'ottimizzazione è troppo aggressiva.
Passaggi di risoluzione
Disabilitare l'ottimizzazione delle immagini per immagini specifiche nel builder.
Per le immagini di sfondo, disabilitare l'ottimizzazione nelle impostazioni del Funnel.
Caricare immagini ad alta risoluzione per mantenere la nitidezza dopo l'ottimizzazione.
4. I valori personalizzati si rompono o non vengono visualizzati nell'anteprima
Problema
I valori personalizzati non vengono visualizzati correttamente nel Funnel.
Possibili cause e soluzioni
Problema con i collegamenti ipertestuali:
Verificare se un valore personalizzato in un elemento di testo è stato convertito in un collegamento ipertestuale.
Rimuovere i collegamenti ipertestuali dagli elementi interessati, poiché interrompono il rendering.
Problema di formattazione delle risposte di ChatGPT:
Il contenuto generato da ChatGPT può contenere caratteri speciali (es.
\n) che interrompono la pagina del Funnel.Aggiornare il prompt di ChatGPT per restituire contenuto formattato in HTML.
In alternativa, utilizzare l'azione "formattatore di testo" per sostituire
\ncon<br/>.
5. Identificare il Funnel, la pagina o la Location di un sito in produzione
Passaggi per l'identificazione
Aprire la scheda Network nel browser.
Pulire la console e abilitare il filtro XHR.
Ricaricare la pagina.
Controllare la chiamata evento nei log di rete.
Aprire la sezione payload per trovare i dettagli necessari.
6. Il sito non viene visualizzato correttamente (problemi di allineamento, loop di aggiornamento, ecc.)
Problema
Il sito non viene visualizzato correttamente, con elementi disallineati o la pagina che si aggiorna continuamente.
Passaggi di risoluzione
Rimuovere tutto il codice personalizzato negli elementi di codice, nel codice di tracciamento head/footer e nei CSS personalizzati.
Per trovare gli elementi di codice personalizzato:
Aprire il builder.
Ispezionare l'anteprima della pagina.
Usare Ctrl + F (Windows) o Cmd + F (Mac) per cercare
c-custom-code.Se trovato, rimuovere gli elementi di codice personalizzato e verificare se il problema persiste.
Verifica di problemi specifici:
Assicurarsi che nessuna sezione, colonna o elemento abbia l'opzione sticky abilitata (il CSS sticky funziona solo in modalità anteprima).
Rimuovere gli elementi timer scaduti, poiché possono causare problemi di visualizzazione.
Aprire la console del browser e verificare la presenza di errori.
Se appare un errore di hydration, escalare il problema come ticket di supporto.
7. Il punteggio o la velocità di caricamento della pagina sono troppo bassi
Problema
La pagina si carica lentamente oppure gli strumenti di analisi delle prestazioni restituiscono punteggi bassi.
Nota
Il team di sviluppo non fornisce supporto diretto per il miglioramento della velocità delle pagine.
Strumenti consigliati
Questi strumenti aiutano ad analizzare le prestazioni di una pagina e a suggerire miglioramenti.
Passaggi di risoluzione e ottimizzazione
Verificare la presenza di script o CSS esterni caricati tramite codice di tracciamento o elementi di codice personalizzato.
Valutare la lunghezza e la densità di contenuto della pagina.
Ottimizzare le immagini utilizzando il toggle Ottimizzazione immagini di GoHighLevel / Squadd, oppure comprimerle manualmente.
Best practice: le immagini visibili above the fold dovrebbero essere inferiori a 200kb per ottenere buoni punteggi LCP su mobile.
Abilitare Ottimizza JavaScript per ritardare l'hydration di JS non essenziale e dei codici di tracciamento — questo migliora il TBT (Total Blocking Time).
Cercare elementi di codice personalizzato che iniettano widget o JavaScript di terze parti.
Spostare gli elementi pesanti (moduli, calendari, widget di recensioni, mappe, ecc.) below the fold.
Benchmark
Una pagina GoHighLevel / Squadd ben ottimizzata ottiene tipicamente:
Oltre 80 su mobile
Oltre 95 su desktop
Questo include scenari in cui sono presenti codici di tracciamento e immagini ad alta risoluzione.
8. Gli header di sicurezza bloccano le risorse del sito
Problema
Le pagine o i passaggi del Funnel non riescono a caricare script, immagini o stili quando header di sicurezza restrittivi o non validi sono configurati nella scheda Sicurezza in Siti (Sites) → Funnel → Funnel specifico con il problema.
Cause comuni
Valori
Content-Security-Policymal configurati o eccessivamente restrittivi.Interruzioni di riga o caratteri non validi nel valore dell'header.
Direttive restrittive che bloccano risorse dal CDN di GoHighLevel / Squadd o da integrazioni di terze parti.
Configurazione URL errata dopo la modifica degli header.
Passaggi di risoluzione
Andare su Siti → Impostazioni (Settings) → scheda Sicurezza.
Esaminare gli header personalizzati (es.
Content-Security-Policy,Strict-Transport-Security,X-Content-Type-Options,X-Frame-Options).Rimuovere o cancellare temporaneamente tutti gli header personalizzati e ricaricare la pagina.
Se la pagina si carica correttamente, il problema è causato da una delle configurazioni degli header.
Assicurarsi che non ci siano interruzioni di riga o nuove righe nel valore dell'header.
I valori degli header devono essere inseriti come una singola riga continua.
Evitare l'uso di regole restrittive o non supportate a meno che non se ne comprenda appieno l'effetto.
Esempio di formato valido:default-src 'self'; img-src *; script-src 'self' https://example.com;Se la homepage continua a non funzionare, provare ad assegnare temporaneamente un percorso URL diverso.
Dopo le modifiche, cancellare la cache o testare in modalità di navigazione in incognito per confermare la risoluzione.
Suggerimenti per la risoluzione
Verificare la sintassi di ciascun header e confermare che non vengano utilizzate direttive non valide o non supportate.
Se il cliente reintroduce valori non validi, richiedere di rimuoverli o semplificarli.
Benchmark
Una pagina correttamente configurata con header di sicurezza validi dovrebbe:
Caricare tutte le risorse di GoHighLevel / Squadd senza blocchi.
Non mostrare errori "Refused to load" o "Blocked by CSP" nella console del browser.
Suggerimento per la validazione
Usare il CSP Evaluator di Google per verificare se il Content-Security-Policy configurato è valido e sicuro.