Panoramica

Questo articolo fornisce i passaggi per risolvere i problemi più comuni riscontrati nell'uso di alcune funzionalità di Funnel, siti web e webinar. I passaggi ti aiuteranno a risolvere problemi relativi a codici di tracciamento, campi personalizzati, immagini, problemi di rendering e altro.

INDICE DEI CONTENUTI

Problemi Comuni e Passaggi di Risoluzione

1. Il Codice di Tracciamento Head non fa parte del Tag <head>

Problema

I codici di tracciamento head e body vengono iniettati lato client (browser), quindi non appariranno all'interno del tag <head> nel codice sorgente. Quello che vedi nel sorgente della pagina sono i dati HTML iniziali usati per il rendering. La piattaforma inietta dinamicamente i codici di tracciamento lato client, il che significa che non saranno presenti nella visualizzazione statica del sorgente.

Anche se implementi soluzioni di tracciamento personalizzate come Google Tag Manager (GTM), questi script funzioneranno comunque come previsto: l'iniezione lato client è compatibile con GTM e strumenti simili.

Spiegazione

Quello che vedi nel codice sorgente sono i dati della pagina usati per il rendering, non i codici di tracciamento iniettati dinamicamente.

Passaggi di Risoluzione

Fai riferimento alla spiegazione video su come HITLEAD inietta i codici di tracciamento head e body: Link video

2. I Campi Personalizzati Aggiornati non si Visualizzano in Anteprima/Sito

Problema

I valori dei campi personalizzati non vengono visualizzati sul sito quando vengono aggiornati tramite backend (es. automazioni, Workflow).

Spiegazione

  • I campi personalizzati sono memorizzati nel database dei Contatti, ma il sito recupera i dati dei campi dalla memoria locale o dai cookie per visualizzarli nella pagina successiva.
  • Quando un contatto compila un Form, un Survey o un order form, 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, non vengono memorizzati nella memoria locale.
  • Di conseguenza, questi campi non verranno visualizzati nelle pagine del Funnel, poiché il front-end si basa sui dati memorizzati localmente nel browser.
  • Questo comportamento è intenzionale e garantisce un rendering più rapido e la personalizzazione per i dati inviati direttamente dagli utenti.

Passaggi di Risoluzione

  1. Verifica se i campi personalizzati interessati vengono popolati tramite Form/Survey o tramite automazione backend.
  2. Se vengono aggiornati dal backend, non appariranno nella pagina del Funnel perché non esiste una voce corrispondente nella memoria locale.
  3. Per assicurarti che questi campi vengano visualizzati:
    • Aggiungi i campi rilevanti al Form o al Survey in modo che l'input dell'utente attivi il salvataggio nei dati locali.
    • In alternativa, usa uno script personalizzato o una logica per trasferire i valori dei campi aggiornati dal backend nella memoria locale prima del rendering.

⚠ Nota - Solo i campi personalizzati aggiornati tramite input diretto dell'utente (es. invii di Form o Survey) 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

  • Disabilita l'ottimizzazione delle immagini per immagini specifiche nel builder.
  • Per le immagini di sfondo, disabilita l'ottimizzazione nelle impostazioni del Funnel.
  • Carica immagini ad alta risoluzione per mantenere la nitidezza dopo l'ottimizzazione.

4. I Valori Personalizzati non si Visualizzano o si Rompono in Anteprima

Problema

I valori personalizzati non vengono visualizzati correttamente nel Funnel.

Possibili Cause e Soluzioni

Problema con i Hyperlink:

  • Verifica se un valore personalizzato in un elemento di testo è stato convertito in un hyperlink.
  • Rimuovi i hyperlink dagli elementi interessati, poiché interrompono il rendering.

Problema di Formattazione delle Risposte di ChatGPT:

  • I contenuti generati da ChatGPT potrebbero contenere caratteri speciali (es. \n) che rompono la pagina del Funnel.
  • Aggiorna il prompt di ChatGPT per restituire contenuti in formato HTML.
  • In alternativa, usa l'azione "text formatter" per sostituire \n con <br/>.

5. Identificare il Funnel, la Pagina o la Posizione di un Sito Live

Passaggi per Identificare

  1. Apri la scheda Network nel browser.
  2. Svuota la console e abilita il filtro XHR.
  3. Ricarica la pagina.
  4. Controlla la chiamata evento nei log di rete.
  5. Apri la sezione payload per trovare i dettagli necessari.

6. Il Sito non si Visualizza Correttamente (Problemi di Allineamento, Loop di Aggiornamento, ecc.)

Problema

Il sito non viene visualizzato correttamente, con elementi non allineati o la pagina che si aggiorna continuamente.

Passaggi di Risoluzione

  • Rimuovi tutto il codice personalizzato negli elementi di codice, nei codici di tracciamento head/footer e nel CSS personalizzato.

Per trovare gli elementi di codice personalizzato:

  1. Apri il builder.
  2. Ispeziona l'anteprima della pagina.
  3. Usa Ctrl + F (Windows) o Cmd + F (Mac) per cercare c-custom-code.
  4. Se trovato, rimuovi gli elementi di codice personalizzato e verifica se il problema persiste.

Verifica Problemi Specifici:

  • Assicurati che nessuna sezione, colonna o elemento abbia l'opzione sticky abilitata (il CSS sticky funziona solo in modalità anteprima).
  • Rimuovi gli elementi timer scaduti, poiché potrebbero causare problemi di visualizzazione.
  • Apri la console del browser e controlla la presenza di errori.
  • Se appare un errore di hydration, segnala il problema come ticket di supporto.

7. Punteggio o Velocità di Caricamento della Pagina Troppo Lenti

Problema

La pagina si carica lentamente o gli strumenti di analisi delle prestazioni restituiscono punteggi bassi.

Nota

Il team di sviluppo non fornisce supporto per il debug diretto della velocità della pagina.

Strumenti Consigliati

Questi strumenti aiutano ad analizzare le prestazioni di una pagina e a suggerire miglioramenti.

Passaggi di Risoluzione e Ottimizzazione

  • Controlla la presenza di script esterni o CSS caricati tramite codice di tracciamento o elementi di codice personalizzato.
  • Valuta la lunghezza e la densità dei contenuti della pagina.
  • Ottimizza le immagini usando il toggle Image Optimization di HITLEAD, oppure comprimile manualmente.
  • Best practice: le immagini che si caricano above the fold dovrebbero essere inferiori a 200kb per ottenere buoni punteggi LCP su mobile.
  • Abilita Optimize JavaScript per ritardare l'hydration di JS non essenziale e dei codici di tracciamento — questo migliora il TBT (Total Blocking Time).
  • Cerca elementi di codice personalizzato che iniettano widget o JavaScript di terze parti.
  • Sposta gli elementi pesanti (Form, Calendari, widget di recensioni, mappe, ecc.) below the fold.

Benchmark

Una pagina HITLEAD 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. Header di Sicurezza che Bloccano gli Asset del Sito

Problema

Le pagine o i passi del Funnel non riescono a caricare script, immagini o stili quando sono configurati header di sicurezza restrittivi o non validi nella scheda Security sotto Sites → Funnels → Funnel specifico con il problema.

Cause Comuni

  • Valori Content-Security-Policy non configurati correttamente o troppo restrittivi.
  • Interruzioni di riga o caratteri non validi nel valore dell'header.
  • Direttive restrittive che bloccano gli asset dal CDN di HITLEAD o dalle integrazioni di terze parti.
  • Configurazione URL errata dopo la modifica degli header.

Passaggi di Risoluzione

  1. Vai su Sites → Settings → Security tab.
  2. Rivedi gli header personalizzati (es. Content-Security-Policy, Strict-Transport-Security, X-Content-Type-Options, X-Frame-Options).
  3. Rimuovi o cancella temporaneamente tutti gli header personalizzati e ricarica la pagina.
    • Se la pagina si carica correttamente, il problema è causato da una delle configurazioni degli header.
  4. Assicurati 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.
  5. Evita di usare regole restrittive o non supportate a meno che tu non ne comprenda pienamente l'effetto.

Esempio di formato valido:

default-src 'self'; img-src *; script-src 'self' https://example.com;
  1. Se la homepage continua a non funzionare, prova ad assegnare temporaneamente un percorso URL diverso.
  2. Dopo le modifiche, svuota la cache o testa in modalità Incognito per confermare la risoluzione.

Suggerimenti per la Risoluzione

  • Verifica la sintassi di ogni header e conferma che non vengano usate direttive non valide o non supportate.
  • Se il cliente reintroduce valori non validi, chiedigli di rimuoverli o semplificarli.

Benchmark

Una pagina configurata correttamente con header di sicurezza validi dovrebbe:

  • Caricare tutti gli asset di HITLEAD senza blocchi.
  • Non mostrare errori "Refused to load" o "Blocked by CSP" nella console del browser.

Suggerimento per la Validazione

Usa CSP Evaluator di Google per verificare se il Content-Security-Policy configurato è valido e sicuro.