HubSpot Knowledge Base

Risoluzione dei problemi dei moduli HubSpot

Scritto da HubSpot Support | Apr 7, 2022 1:41:00 PM

Imoduli di HubSpot consentono di generare lead dal vostro sito web e di raccogliere informazioni importanti sui vostri visitatori e contatti in HubSpot. Se avete difficoltà con il comportamento o l'invio dei moduli, esaminate i diversi problemi comuni e i passaggi per risolverli.

Passi generali per la risoluzione dei problemi

Se si verificano problemi con l'invio dei moduli, il problema potrebbe essere causato dal modulo HubSpot stesso o dalla pagina in cui il modulo è incorporato. Per risolvere il problema, potete testare il vostro modulo HubSpot:

  • Aprire l'URL della pagina autonoma del modulo in un'altra scheda del browser. Questa pagina indipendente non ha elementi che possono influenzare il modulo.
  • Eseguire un invio di prova del modulo.
  • Controllare l'invio del test:
    • Se l'invio è riuscito, il problema è probabilmente legato alla pagina in cui è incorporato. Verificate con il vostro sviluppatore i possibili elementi della pagina che potrebbero aver influenzato l'invio, come ad esempio script o fogli di stile allegati.
    • Se anche l'invio è stato colpito dallo stesso errore, contattate l'assistenza HubSpot.

Risoluzione dei problemi di comportamento dei moduli più comuni

Di seguito sono riportati alcuni problemi comuni che si possono incontrare durante l'impostazione del modulo e i passi tipici per risolverli. Dopo aver aggiornato il modulo, pubblicarlo e verificarlo nuovamente.

Errore Passi per risolvere l'errore

Un campo non viene visualizzato in un modulo attivo

Assicurarsi che il modulo aggiornato sia stato pubblicato controllando l'URL della pagina indipendente del modulo in un'altra scheda del browser.

Se alcuni campi non vengono ancora visualizzati sul modulo quando lo si aggiunge a una pagina, è probabile che il modulo abbia campi progressivi e che HubSpot ricordi il visitatore da interazioni o test precedenti. I campi progressivi sono nascosti se il visitatore ha precedentemente compilato il campo o se il contatto ha già un valore per la proprietà.

Se si desidera che il campo venga visualizzato in modo coerente, aggiungerlo come campo di un modulo normale anziché come campo di un modulo progressivo.

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

Se una proprietà non è disponibile come campo del modulo, potrebbe essere perché non è stata impostata per essere visualizzata nei moduli. Per abilitare una proprietà alla visualizzazione nei moduli:
  • Nel menu della barra laterale sinistra, spostarsi su Proprietà.
  • Fare clic sul nome della proprietà.
  • Selezionare la casella di controllo Usa nei moduli e nei bot. Se la proprietà ha più opzioni, l'interruttore Mostra nei moduli deve essere attivato per ogni opzione che si desidera utilizzare nei moduli.
  • In basso a sinistra, fare clic su Salva.



Il contenuto intelligente non compare nella mia pagina di ringraziamento

Non è possibile utilizzare lo smart content in una pagina di ringraziamento. Quando un visitatore invia un modulo e viene reindirizzato a una pagina di ringraziamento, non c'è tempo sufficiente perché il modulo venga elaborato e perché HubSpot determini se il contatto soddisfa le regole di smart content nella pagina di ringraziamento.

Hai fornito un erroreHTML richtext non sicuro

L'errore Hai fornito un richtext HTML non sicuro si verifica quando sono stati inclusi tag o attributi HTML non consentiti nel modulo.

Per risolvere l'errore e salvare il modulo, verificare il codice sorgente delle aree di testo ricco nel modulo rispetto a quanto segue:

  • I tag <script> non sono consentiti e devono essere rimossi.
  • Tutti gli attributi HTML di scripting (ad esempio 'onmouseover', 'onclick') non sono consentiti e devono essere rimossi.
  • Tutti gli URL delle 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 più comuni di invio dei moduli

Di seguito sono riportati alcuni problemi comuni che si possono riscontrare con l'invio di moduli e i passi tipici per la loro risoluzione. Dopo aver aggiornato il modulo, si può provare a pubblicarlo e controllarlo di nuovo.

Errore Passi per risolvere l'errore

Un numero maggiore di invii di moduli rispetto ai contatti / Nessun record di contatto creato per un invio di moduli

Gli invii di moduli vengono registrati quando il pulsante Invia di un modulo viene cliccato ed elaborato. Questi sono alcuni motivi comuni per cui il numero di invii di moduli può essere superiore al numero di contatti creati:
  • Il modulo è stato inviato più volte con lo stesso indirizzo e-mail. Di conseguenza, è stato creato un solo contatto, ma ogni singolo invio del modulo è stato comunque registrato. Per evitare questo problema, nella scheda Opzioni del modulo, attivate l'impostazione Crea sempre un contatto per un nuovo indirizzo e-mail .
  • 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 dagli invii del modulo.
  • Il campo Email non è stato popolato al momento dell'invio del modulo. Affinché l'invio di un modulo crei un record di contatto in HubSpot, il campo Email predefinito deve essere utilizzato nel modulo. In caso contrario, è necessario consentire agli invii di moduli senza indirizzi e-mail di creare contatti.
  • L'invio del modulo ha utilizzato un indirizzo e-mail già associato a un record di contatto, oppure l'invio è stato effettuato in un browser con cookie di tracciamento legati a un record di contatto esistente. In questo caso, l'invio aggiornerà il record di contatto esistente e non ne creerà uno nuovo. Per saperne di più su come HubSpot deduplica i contatti e su come ricreare i contatti sovrascritti dall'invio di un modulo.

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

Per tracciare correttamente le pagine viste, verificare che il codice di tracciamento di HubSpot sia installato sul sito e che funzioni correttamente.

Se il codice di tracciamento è installato e funziona correttamente, ma il valore della proprietà Numero di pagine viste di 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 appare nella timeline 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 modulo appartenente a quel tipo di oggetto.
  • Il campo del modulo appartenente a quel tipo di oggetto deve essere popolato quando il modulo viene inviato.

Ad esempio, se il modulo contiene un campo di proprietà dell'azienda e questo campo è stato popolato al momento dell'invio del modulo, l'invio del modulo apparirà nella cronologia delle attività dell'azienda associata al contatto. Per garantire che il campo sia sempre popolato, è possibile impostare il campo del modulo come obbligatorio.

Errore diregistrazione dei contatti

Se non consentite l'invio di moduli senza indirizzi e-mail per creare contatti, ci sono due motivi per cui nessun record di contatto può essere visualizzato nell'invio del modulo:
  • Il campo Email non è incluso e/o richiesto nel modulo.
  • Il contatto associato all'invio è stato eliminato da HubSpot.

Nessun errore diregistrazione

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

La visita della pagina non viene registrata dopo l'invio del modulo

Quando l'invio di un modulo non registra la visita di una pagina, è molto probabile che l'indirizzo IP del visitatore sia stato escluso dall'analisi del sito.
  • Se il visitatore invia il modulo mentre si trova su un indirizzo IP escluso, il suo invio sarà registrato negli analytics dell'invio del modulo, ma la visita alla pagina non sarà conteggiata.
  • Se il visitatore è un utente di un account HubSpot e non si trova su un indirizzo IP escluso, l'invio del modulo e la visita della pagina verranno conteggiati.

Non è stato trovato alcun cookie per questo errore diinvio

Questo errore potrebbe essere causato da quanto segue:
  • L'invio proviene da un'integrazione esterna tramite l'API di HubSpot e non include un cookie.
  • Il browser del visitatore ha bloccato il cookie.
  • Il visitatore non ha accettato il banner del cookie.
  • Il visitatore ha effettuato l'invio utilizzando un indirizzo IP filtrato.

File rimosso dall'invio del modulo del contatto

Lo strumento dei moduli di HubSpot è dotato di un sistema di rilevamento dei virus che impedisce il caricamento di file sospetti nell'invio dei moduli.

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

Informazioni aggiuntive sull'azienda visualizzate nella notifica del mio modulo

Se HubSpot dispone di ulteriori informazioni sull'azienda nei nostri database, HubSpot le inserirà automaticamente in fondo alla notifica.

Contatto mancante di un valore per IP Country, IP State o IP City

HubSpot utilizza diversi database di terze parti per cercare di abbinare l'indirizzo IP di un visitatore alla sua posizione geografica. Ci sono due motivi per cui l'IP Country, l'IP State/Region o l'IP City di un contatto possono essere vuoti:
  • I contatti devono inviare un modulo con il tracciamento dei cookie abilitato o interagire con (aprire o cliccare) un'e-mail HubSpot tracciata con un indirizzo IP associato.
  • HubSpot non è riuscito a trovare una corrispondenza per le proprietà di geolocalizzazione con i suoi database. I dati relativi alla localizzazione degli indirizzi IP possono essere imprecisi o frammentati in alcune località geografiche, pertanto è possibile che HubSpot non riesca a trovare dati per tutte e tre le proprietà IP.

Risoluzione dei problemi più comuni di visualizzazione dei moduli

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

Errore Passi per risolvere l'errore

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

Se il vostro modulo non appare nelle pagine di HubSpot o in quelle esterne, è possibile che ci sia un codice in conflitto nella pagina che lo impedisce. Il più comune è lo script OtAutoBlock.js di One Trust.

Per impostazione predefinita, i moduli non vengono visualizzati sulle pagine in cui viene eseguito questo script finché i cookie non vengono 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. Si possono considerare le seguenti opzioni:

  • Configurare gli script allowlist nello script OtAutoBlock.js di OneTrust per consentire il rendering del modulo. Si consiglia di collaborare con il proprio sviluppatore.
  • Verificate con OneTrust se è possibile consentire l'inserimento degli script dei moduli di HubSpot.
  • Rimuovere completamente lo script OtAutoBlock.js di OneTrust.

Nota bene: nel valutare le fasi di risoluzione dei problemi, nel lavorare con i banner di consenso e nel considerare la vostra politica sulla privacy, il vostro team legale è la risorsa migliore per darvi consigli sulla conformità alle vostre specifiche circostanze aziendali.

Il modulo non viene visualizzato su una pagina esterna

Se il vostro 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. Scoprite come risolvere i problemi dei moduli incorporati esternamente.

Un modulo incorporato viene visualizzato nel posto sbagliato su una pagina esterna

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

Per saperne di più su come risolvere questi problemi aggiornando il codice incorporato del modulo.

Abbiamo riscontrato problemi nel caricamento di questo modulo. Fare clic qui per continuare l' errore

I moduli di HubSpot sono costruiti con JavaScript per aggiungere funzionalità come 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, possono bloccare il caricamento e la visualizzazione dei moduli se sono abilitate.

Il testo Clicca qui per continuare è collegato 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 fa clic sul link, viene portato a una pagina di modulo indipendente dove può inviare il modulo.

Il link include il contesto completo del codice di incorporamento del modulo originale in una stringa di query, nonché le informazioni della pagina originale, come il titolo e l'URL. Il modulo in questa pagina autonoma si comporterà esattamente come il modulo originale. L'invio del modulo sulla pagina standalone passerà le stesse informazioni analitiche di un invio sul modulo originale.