Salta al contenuto
Nota bene: la traduzione in italiano di questo articolo è fornita solo per comodità. La traduzione viene creata automaticamente tramite un software di traduzione e potrebbe non essere stata revisionata. Pertanto, la versione inglese di questo articolo deve essere considerata come la versione di governo contenente le informazioni più recenti. È possibile accedervi qui.

Risoluzione dei problemi dei moduli HubSpot

Ultimo aggiornamento: 24 aprile 2026

Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:

I moduli HubSpot ti consentono di generare lead dal tuo sito web e raccogliere informazioni importanti sui tuoi visitatori e contatti in HubSpot. Se riscontri difficoltà relative al funzionamento dei moduli o all'invio dei dati, consulta l'elenco dei problemi più comuni e le procedure per risolverli. 

Procedura generale di risoluzione dei problemi 

Se riscontri problemi con l'invio dei moduli, la causa potrebbe essere il modulo HubSpot stesso o la pagina in cui è incorporato. Per risolvere il problema, puoi testare il tuo modulo HubSpot:

  1. Apri l'URL della pagina autonoma del modulo in un'altra scheda del browser. Questa pagina autonoma non contiene elementi che possano influire sul modulo.
  2. Effettua un invio di prova al modulo.
  3. Controlla l'invio di prova:
    • Se l'invio va a buon fine, il problema è probabilmente correlato alla pagina in cui è incorporato. Verifica con il tuo sviluppatore quali elementi della pagina potrebbero aver influito sugli invii, come eventuali script o fogli di stile allegati.
    • Se anche l'invio presenta lo stesso errore, contatta l'assistenza HubSpot.

Risoluzione dei problemi comuni relativi al comportamento dei moduli

Di seguito sono riportati alcuni problemi comuni che potresti riscontrare durante la configurazione del modulo e i passaggi tipici per la risoluzione. Dopo aver aggiornato il modulo, pubblicalo e controllalo nuovamente.

Errore Passaggi per risolvere l'errore 

Un campo non viene visualizzato in un modulo live

Assicurati che il tuo modulo aggiornato sia stato pubblicato controllandol'URL della pagina autonoma del modulo in un'altra scheda del browser.

Se alcuni campi non vengono ancora visualizzati nel modulo quando lo aggiungi a una pagina, è probabile che il modulo contenga campi progressivi e che HubSpot ricordi il visitatore da precedenti interazioni o test. I campi progressivi vengono nascosti se il visitatore ha già compilato il campo in precedenza o se il contatto ha già un valore per la proprietà.

Se desideri che il campo venga visualizzato in modo coerente, aggiungilo come campo del modulo standard anziché come campo del modulo progressivo. 

Il modulo aggiunto alla pagina HubSpot non visualizza lo stesso messaggio di ringraziamento dell'editor dei moduli (versione precedente)

Quando un modulo (legacy) viene aggiunto a una pagina HubSpot, il messaggio di ringraziamento impostato nell'editor della pagina sovrascriverà quello dell'editor del modulo. Ciò accadrà quando il modulo è impostato su un messaggio di ringraziamento in linea o su un reindirizzamento a una pagina HubSpot o a una pagina esterna. 

Di conseguenza, quando si aggiunge un modulo creato nell’editor legacy a una pagina HubSpot, è necessario impostare il messaggio di ringraziamento in linea o il reindirizzamento a un’altra pagina all’interno del modulo del modulo nell’editor della pagina.

Ciò non si applica ai reindirizzamenti condizionali del modulo o al reindirizzamento a una pagina di pianificazione. Questi hanno la priorità quando sono impostati nell’editor del modulo.

La proprietà non è disponibile come campo nell'editor dei moduli

 

Se una proprietà non è disponibile come campo del modulo, potrebbe essere perché non è configurata per apparire nei moduli. Per abilitare una proprietà per la visualizzazione nei moduli: 
  1. Nel tuo account HubSpot, fai clic sulle settings icona delle impostazioni nella barra di navigazione principale.
  2. Nel menu della barra laterale sinistra, vai suProprietà.
  3. Fai clic sulnome della proprietà.
  4. Nel menu della barra laterale sinistra, vai su Regole
  5. Seleziona la casella di controllo Mostra proprietà nei moduli. Se la tua proprietà ha più opzioni, l'interruttore Mostra nei moduli deve essere attivato per ogni opzione che desideri utilizzare nei tuoi moduli.
  6. In alto a destra, clicca su Salva.

 

I contenuti intelligenti non vengono visualizzati nella mia pagina di ringraziamento

Non è possibile utilizzare i contenuti intelligenti in una pagina di ringraziamento.

Quando un visitatore invia un modulo e viene reindirizzato a una pagina di ringraziamento, non c'è tempo sufficiente per l'elaborazione del modulo e per consentire a HubSpot di determinare se il contatto soddisfa le regole dei contenuti intelligenti nella pagina di ringraziamento.

Hai fornitoun erroreHTML rich text non sicuro

L'errore " Hai fornito codice HTML rich text non sicuro" si verifica quando hai incluso tag o attributi HTML non consentiti nel tuo modulo.

Per risolvere questo errore e salvare il modulo, controlla il codice sorgente dellearee di testo formattatonel modulo rispetto a quanto segue:

  • I tag <script> non sono consentiti e devono essere rimossi.
  • Non sono consentiti attributi HTML di scripting (ad es. "onmouseover", "onclick") e devono essere rimossi.
  • Tutti gli URL nelle immagini devono iniziare con "http://" o "https://".
  • Tutti gli URL dei link devono iniziare con 'http://', 'https://', 'mailto:' o 'tel:'.
  • Tutti i tag di collegamento possono avere solo gli attributi HTML 'href', 'target', 'name' e 'rel'.

Risoluzione dei problemi comuni relativi all'invio dei moduli

Di seguito sono riportati alcuni problemi comuni che potresti riscontrare con l'invio dei moduli e i passaggi tipici per la risoluzione. Dopo aver aggiornato il modulo, puoi provare a pubblicarlo e controllarlo nuovamente. 

Errore Passaggi per risolvere l'errore 

Numero di invii del modulo superiore ai contatti / Nessun record di contatto creato per l'invio di un modulo

Gli invii dei moduli vengono registrati quando si fa clic sul pulsante Invia presente su un modulo e questi vengono elaborati. Di seguito sono riportati alcuni motivi comuni per cui il numero di invii dei moduli potrebbe essere superiore al numero di contatti creati: 
  • Il modulo è stato inviato più volte con lo stesso indirizzo e-mail. In questo caso, verrà creato un solo contatto, ma ogni invio del modulo verrà comunque registrato nell'attività del contatto e nelle analisi del modulo. 
  • I contatti potrebbero essere stati eliminati. Se un contatto viene eliminato da HubSpot, l'invio del modulo continuerà a essere conteggiato nel totale, ma il contatto non apparirà più in un elenco filtrato in base agli invii del modulo.
  • Il campo Email non era compilato al momento dell'invio del modulo. Affinché l'invio di un modulo crei un record di contatto in HubSpot, nel modulo deve essere utilizzato il campo Email predefinito. In caso contrario, devi consentire agli invii di moduli senza indirizzi email di creare contatti.
  • L'invio del modulo ha utilizzato un indirizzo email già associato a un record di contatto. Oppure l'invio del modulo è stato compilato in un browser con cookie di tracciamento associati a un record di contatto esistente. In questo scenario, l'invio aggiornerà il record di contatto esistente e non ne creerà uno nuovo. Scopri di più su come HubSpot deduplica i contatti e su come ricreare i contatti sovrascritti dagli invii dei moduli.

Il contatto non ha registrato una visualizzazione della pagina durante l'invio del modulo

 

Per tracciare correttamente le visualizzazioni di pagina, verifica che il codice di tracciamento HubSpot sia installato sul tuo sito e che funzioni correttamente.

Se il codice di tracciamento è installato e funziona correttamente, ma il valore della proprietà "Numero di visualizzazioni della pagina " su un contatto è ancora "0", è probabile che i cookie siano stati bloccati quando il contatto ha inviato il modulo. Ciò potrebbe essere dovuto a diversi motivi:

L'invio del modulo non compare nella cronologia delle attività degli oggetti associati

Per visualizzare l'invio di un modulo nella cronologia delle attività di un oggetto associato:
  • Il modulo deve contenere un campo appartenente a quel tipo di oggetto.
  • Il campo del modulo appartenente a quel tipo di oggetto deve essere compilato al momento dell'invio del modulo.

Ad esempio, se il modulo conteneva un campo relativo alla proprietà "azienda" e questo campo è stato compilato al momento dell'invio del modulo, l'invio del modulo apparirà nella cronologia delle attività dell'azienda associata al contatto. Per assicurarti che il campo sia sempre compilato, puoi impostare il campo del modulo come obbligatorio

Errore:nessun record di contatto

Se non si consentono invii di moduli senza indirizzi e-mail per creare contatti, ci sono due motivi per cui potrebbenon essere visualizzatoalcun record di contatto nell'invio del modulo:
  • Il campo Email non è incluso o non è obbligatorio nel tuo modulo.
  • Il contatto associato all'invio è stato eliminato da HubSpot.

Errore:nessun record

Questo errore significa che HubSpot non è stato in grado di determinare dove sia avvenuto l'invio. Ciò potrebbe essere dovuto a due motivi:

Visita alla pagina non registrata dopo l'invio del modulo

Quando l'invio di un modulo non registra una visita alla pagina, molto probabilmente ciò è dovuto al fatto che l'indirizzo IP del visitatore è stato escluso dall'analisi del tuo sito.
  • Se il visitatore invia il modulo mentre si trova su un indirizzo IP escluso, l’invio verrà registrato nelle analisi degli invii dei moduli, ma la visita alla pagina non verrà conteggiata.
  • Se sei un utente di un account HubSpot e non ti trovi su un indirizzo IP escluso, l'invio del modulo e la visita alla pagina verranno conteggiati.
Questo errore potrebbe essere causato dai seguenti motivi:
  • L'invio proviene da un'integrazione esterna tramite l'API di HubSpot e non includeva un cookie.
  • Il browser del visitatore ha bloccato il cookie.
  • Il visitatore non ha accettato il banner dei cookie.
  • Il visitatore ha inviato la richiesta utilizzando un indirizzo IP filtrato. 

File rimosso dall'invio del modulo del contatto

Lo strumento Moduli di HubSpot è dotato di un sistema di rilevamento dei virus che impedisce il caricamento di file sospetti negli invii dei moduli.

Se un visitatore invia un modulo con un file e viene rilevato un virus, nei dettagli dell'invio appariràil messaggio [Nome file] rimosso dall'invio.

Visualizzazione di informazioni aggiuntive sull'azienda nella notifica del mio modulo 

Se HubSpot dispone di ulteriori informazioni sull'azienda nei propri database, queste verranno inserite automaticamente nella parte inferiore della notifica.

Nel contatto manca un valore per Paese IP, Stato IP o Città IP

 

HubSpot utilizza diversi database di terze parti per cercare di associare l'indirizzo IP di un visitatore alla sua posizione geografica. Ci sono due motivi per cui i campi "Paese IP", " Stato/Regione IP" o " Città IP " di un contatto potrebbero risultare vuoti:
  • I contatti devono inviare un modulo con il tracciamento dei cookie abilitato o interagire (aprendo o cliccando) con un'e-mail HubSpot tracciata associata a un indirizzo IP.
  • HubSpot non è riuscito a trovare una corrispondenza per le proprietà di geolocalizzazione nei propri database. I dati sulla posizione dell'indirizzo IP possono essere imprecisi o sporadici in determinate aree geografiche, quindi potrebbero esserci casi in cui HubSpot non riesce a trovare dati per tutte e tre le proprietà IP.

Risoluzione dei problemi comuni relativi alla visualizzazione dei moduli

Di seguito sono riportati alcuni problemi comuni che impediscono la visualizzazione del modulo in HubSpot o nelle pagine esterne, nonché i passaggi tipici per la risoluzione.

Errore Passaggi per risolvere l'errore

Il modulo non viene visualizzato su una pagina HubSpot o su una pagina esterna

Se il tuo modulo non viene visualizzato sulle tue pagine HubSpot o su pagine esterne, potrebbe esserci un codice in conflitto sulla pagina che ne impedisce la visualizzazione. Il più comune sarebbe lo script OtAutoBlock.js di One Trust.

Per impostazione predefinita, i moduli non verranno visualizzati su nessuna pagina in cui è in esecuzione questo script finché i cookie non saranno accettati dai visitatori.

Per visualizzare il modulo per tutti i visitatori, compresi quelli che non hanno accettato i cookie, lo script dovrà essere gestito esternamente. Puoi prendere in considerazione le seguenti opzioni:

  • Configura gli script dell'allowlist nello script OtAutoBlock.js di OneTrust per consentire il rendering del modulo. Si consiglia di collaborare con il tuo sviluppatore a questo proposito.
  • Verifica con OneTrust se è possibile inserire gli script di incorporamento dei moduli di HubSpot nell'elenco dei permessi. 
  • Rimuovi completamente lo script OtAutoBlock.js di OneTrust.

Nota: quando valuti le procedure di risoluzione dei problemi, gestisci i banner di consenso e prendi in considerazione la tua informativa sulla privacy, il tuo team legale è la risorsa migliore per fornirti consulenza in materia di conformità per le tue specifiche circostanze aziendali.

Il modulo non viene visualizzato su una pagina esterna

Se il tuo modulo non viene visualizzato su una pagina esterna, potrebbe esserci un problema con il codice di incorporamento del modulo o con l'host del sito web. Scopri come risolvere i problemi relativi ai moduli incorporati esternamente

Un modulo incorporato viene visualizzato in una posizione errata su una pagina esterna

Dopo aver incorporato un modulo HubSpot in una pagina esterna, se il modulo viene visualizzato in una posizione diversa da quella desiderata, ciò potrebbe essere dovuto a: 
  • Il modulo viene visualizzato dinamicamente su una pagina. 
  • Sono stati aggiunti più codici di incorporamento del modulo allo stesso tag <div>. 
  • Il modulo non può essere caricato a causa dell'utilizzo di un browser obsoleto.

Scopri di più su come risolvere questi problemi aggiornando il codice di incorporamento del modulo. 

Si è verificato un problema durante il caricamento di questo modulo. Clicca qui per continuare

I moduli HubSpot sono realizzati con JavaScript per aggiungere funzionalità quali la convalida dei campi, i campi dipendenti e i messaggi di errore dinamici. Tuttavia, ciò significa che le estensioni del browser che bloccano le risorse, come Ghostery e Privacy Badger, potrebbero impedire il caricamento e la visualizzazione dei moduli se sono attivate. 

Il testo "Clicca qui per continuare " è collegato tramite hyperlink a https://www.hubspot.com/products/marketing/forms?utm_source=share.hsforms.com&utm_medium=referral&utm_campaign=hsforms-redirect, un dominio protetto controllato da HubSpot. Quando un visitatore clicca sul link, verrà reindirizzato a una pagina del modulo autonoma dove potrà inviare il modulo.

Il link include il contesto completo del codice di incorporamento dei moduli originali in una stringa di query, oltre alle informazioni sulla pagina originale come il titolo e l'URL. Il modulo su questa pagina autonoma si comporterà esattamente come il modulo originale. L'invio di un modulo sulla pagina autonoma trasmetterà le stesse informazioni di analisi di un invio sul modulo originale.

 

L'articolo è stato utile?
Questo modulo viene utilizzato solo per il feedback della documentazione. Scopri come ottenere assistenza con HubSpot.