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.

Utilizzare moduli non HubSpot

Ultimo aggiornamento: 15 aprile 2026

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

Riepilogo

I moduli non HubSpot sono moduli HTML presenti sul tuo sito esterno che non sono stati creati in HubSpot. Utilizza lo strumento per i moduli non HubSpot per iniziare a raccogliere i dati inviati sul tuo sito web non appena vengono inviati. Lo strumento è in grado di identificare i moduli esterni del tuo sito web in base al tag <form>presente nel codice HTML.

In questo articolo, esamina i requisiti per utilizzare lo strumento Moduli non HubSpot. Quindi, attiva le impostazioni dei moduli non HubSpot per iniziare a raccogliere i dati inviati. Scopri come vengono mappati i moduli non HubSpot e come gestire gli inserimenti di date. Infine, puoi gestire i tuoi moduli non HubSpot esistenti e intraprendere azioni su di essi.

Per utilizzare lo strumento Moduli non HubSpot, devi installare il codice di tracciamento HubSpot sulla tua pagina esterna o utilizzare il plugin HubSpot per WordPress. Una volta aggiunto il codice di tracciamento e attivato lo strumento, gli invii ai moduli non HubSpot verranno raccolti in HubSpot. Se il tuo modulo non sta acquisendo gli invii, scopri di più sui problemi comuni con i moduli non HubSpot.

Prima di iniziare

Quando utilizzi moduli non HubSpot, tieni presente quanto segue: 

  • In un account è possibile creare solo 10.000 moduli non HubSpot. Quando i moduli non HubSpot superano i 10.000, HubSpot rifiuterà gli invii.
  • Gli invii dei moduli non HubSpot vengono raccolti ogni volta che un visitatore fa clic sul pulsante di invio. Se nel modulo esterno è presente una convalida, ciò può portare a più invii parziali. Ad esempio, se un visitatore tenta di inviare il modulo senza compilare un campo obbligatorio, dovrà inserire le informazioni richieste e inviare nuovamente. In HubSpot, entrambi gli invii verrebbero raccolti, uno parziale e uno completo. 
  • Lo strumento per i moduli non HubSpot dipende dal codice di tracciamento. HubSpot può raccogliere gli invii dei moduli solo se il codice di tracciamento viene caricato correttamente. Ad esempio, se sulla pagina sono presenti conflitti JavaScript o se l'estensione di sicurezza del browser di un visitatore blocca gli script, l'invio del modulo non verrà raccolto.
  • Quando si utilizzano moduli non HubSpot, tutti gli invii associati allo stesso cookie verranno aggiunti allo stesso record di contatto. Ad esempio, se un visitatore invia un modulo specifico più volte con lo stesso dispositivo e browser, tutti gli invii saranno attribuiti a un unico contatto, anche se ogni invio utilizza un indirizzo e-mail diverso. 

Poiché questi comportamenti sono dovuti a fattori esterni, HubSpot non può prevenirli. In alternativa, puoi valutare la possibilità di collaborare con uno sviluppatore per collegare i tuoi moduli non HubSpot direttamente utilizzando l’API“Invia dati a un modulo” di HubSpot o un’integrazione di moduli esistente.

Quali sono i requisiti per acquisire gli invii di moduli non HubSpot

Affinché gli invii dei moduli vengano raccolti in HubSpot, il modulo deve soddisfare i seguenti requisiti:

  • Il modulo deve essere un modulo HTML statico.
  • Il modulo deve essere racchiuso tra i tag HTML <form>.
  • Il modulo deve avere un campo di immissione e-mail. Questo campo e-mail deve essere un campo di tipo e-mail, ad esempio: <input type="email">.
  • Il modulo deve utilizzare un pulsante standard <input type="submit"> per l'invio dei dati.
  • Il modulo non deve trovarsi all'interno di un <iframe>.
  • Il modulo non deve avere JavaScript associato all'evento di invio del modulo o all'evento di clic sul pulsante di invio. 
  • Il modulo non deve essere inserito dopo il completamento del caricamento della pagina. Verranno raccolti solo gli invii provenienti da moduli presenti durante il caricamento iniziale della pagina.
  • Il modulo non deve trovarsi su un'app a pagina singola. Nella maggior parte delle app a pagina singola, l'HTML non viene caricato quando si naviga verso un'altra pagina. Di conseguenza, HubSpot non può acquisire questi invii di moduli. 
  • Il modulo non deve contenere campi sensibili, come il numero di carta di credito.
  • Il modulo non deve contenere campi nascosti. Lo strumento non raccoglie informazioni da campi nascosti.

Come attivare o disattivare i moduli non HubSpot

Quando si utilizza lo strumento per i moduli non HubSpot, i dati di invio del modulo vengono memorizzati in localStorage e poi inviati a HubSpot per creare un nuovo contatto o aggiornare qualsiasi record di contatto esistente con lo stesso indirizzo e-mail.

Nota: ogni volta che si fa clic sul pulsante di invio nel modulo non HubSpot, si attiverà l’invio del modulo in HubSpot. Ciò include i casi in cui un utente non ha compilato tutti i campi obbligatori e fa clic sul pulsante di invio; HubSpot registrerà questa azione come invio del modulo.

Per attivare o disattivare la raccolta di informazioni dai moduli non HubSpot sulle tue pagine:

  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 su Marketing > Moduli.
  3. Fai clic sulla scheda Moduli non HubSpot.
  4. Fai clic per attivare/disattivare l'interruttore Raccogli dati dai moduli del sito web per abilitare/disabilitare i moduli non HubSpot.
  5. Per inviare notifiche via e-mail relative agli invii di moduli non HubSpot, inserisci gli indirizzi e-mail degli utenti HubSpot esistenti nel campo Invia notifiche via e-mail per gli invii di moduli raccolti a
  6. Se hai accesso ai contatti di marketing, clicca per attivare/disattivare l'interruttore Imposta i nuovi contatti creati tramite moduli non HubSpot come contatti di marketing per impostare lo stato di marketing predefinito di questi contatti creati comemarketing/non marketing.

Forms settings, displaying the non-HubSpot form settings to collect data from website forms and set contacts as marketing contacts.

Come mappare i campi

dei moduli

non HubSpot e le proprietà di HubSpot

Tutti i dati inviati ai campi dei moduli non HubSpot corrisponderanno solo alle proprietà di tipo campo di testo a riga singola in HubSpot. I campi dei moduli non HubSpot non possono corrispondere ad altri tipi di campo.

Se non è possibile rilevare una proprietà corrispondente di tipo campo di testo a riga singola, i dati inviati non verranno memorizzati nel record del contatto. I dettagli inviati per quel campo del modulo saranno comunque disponibili nei dati di invio del modulo.

Puoi creare campi o etichette del modulo da abbinare alle proprietà predefinite di HubSpot oppure creare una proprietà di contatto personalizzata da abbinare al nome o all'etichetta del tuo campo del modulo. Tuttavia, i campi dei moduli non HubSpot non possono essere mappati manualmente. HubSpot tenterà automaticamente di mappare i campi del modulo alle proprietà di contatto esistenti in HubSpot utilizzando la logica nel seguente ordine:

  1. nome del campo con nome interno della proprietà del contatto
  2. etichetta del campo con nome della proprietà del contatto
  3. etichetta del campo con nome interno della proprietà del contatto
  4. nome del campo con nome della proprietà del contatto

Nota: poiché i nomi interni delle proprietà possono essere solo alfabetici, la mappatura del nome interno della proprietà del contatto per lingue non alfabetiche come il giapponese o il cinese non funzionerà. Questi campi verranno mappati solo con il nome della proprietà del contatto. 


Property editor, highlighting the property's internal name.

Come gestire gli inserimenti di date nei

campi di testo

dei moduli non HubSpot

Se utilizzi campi di testo per raccogliere date nei tuoi moduli esterni, puoi utilizzare un attributo dati per interpretare i valori di data inviati. Al momento della raccolta dell’invio del modulo, i dati saranno standardizzati secondo lo standard ISO AAAA-MM-GG.

Ad esempio, puoi utilizzare un attributo data per identificare che il valore inviato è nel formato GG/MM/AAAA o in qualsiasi altro formato di data specificato. Quando l'invio del modulo viene raccolto e il valore 12/03/2013 viene inviato a HubSpot, verrà mappato alla proprietà corrispondente in HubSpot secondo lo standard ISO come 2013-03-12.

Nota: l'utilizzo degli attributi dati richiede una certa conoscenza dell'HTML e l'accesso al codice HTML del tuo modulo non HubSpot. Per

aggiungere un attributo dati al campo del tuo modulo non HubSpot:
  1. Dal modulo non HubSpot, accedi al codice HTML del modulo.
  2. Nel campo data del modulo, aggiorna il codice HTML <input> del campo del modulo per includere l'attributo dati data-hs-cf-date-format e il formato data corrispondente. Questo dovrebbe essere utilizzato solo con campi di testo che raccolgono valori di data. 
    • Ad esempio, se stai raccogliendo una proprietà data nel formato MM-GG-AAAA, l'input seguirebbe questo formato:<input type="text" data-hs-cf-date-format="MM-GG-AAAA"/>
    • Quando si configura l'attributo data, è possibile utilizzare i seguenti formati di data supportati:
GGMMAAAA GG/MM/AAAA GG-MM-AAAA GG.MM.AAAA GG MM AAAA
MM/GG/AAAA MM/GG/AAAA MM-GG-AAAA MM.GG.AAAA MM GG AAAA
AAAAMMGG AAAA/MM/GG AAAA-MM-GG AAAA.MM.GG AAAA MM GG
AAAAGGMM AAAA/GG/MM AAAA-GG-MM AAAA.GG.MM AAAA GG MM

 

Come gestire e agire sui moduli non HubSpot

Per gestire ulteriormente i tuoi moduli non HubSpot:
  1. Nel tuo account HubSpot, passa a Marketing > Form.
  2. In alto a sinistra, clicca sul menu a tendina Tipo di modulo e selezionaNon HubSpot.
  3. Passa con il mouse su un modulo non HubSpot e clicca sul menu a tendina Azioni per:

    • Rinomina: rinomina il modulo.
    • Visualizza informazioni:visualizza l'URL della pagina più recente in cui è stato raccolto un invio per questo modulo e la data del primo invio. Fai clic su Informazioni avanzateper visualizzare il selettore di questo modulo .
    • Visualizza invii: esamina la pagina dei dettagli del tuo modulo e una panoramica degli invii del modulo.
    • Esporta invii: esporta tutti gli invii del moduloin un file CSV, XLS o XLSX.
    • Modifica liste MailChimp : modifica le liste MailChimp a cui desideri inviare gli invii.
    • Modifica notifiche e-mail :modifica gli indirizzi di notifica dell'invio del modulo.
    • Sposta in cartella: sposta il modulo in una cartella.
    • Gestisci l'accesso ( solo Content Hub e Marketing Hub Enterprise ): seleziona quali utenti e team hanno accesso a questo modulo non HubSpot. Scopri di più sulla suddivisione delle risorse HubSpot
    • Copia su HubSpot : converti il modulo in un modulo HubSpot.
    • Elimina:rimuovi il modulo dalla pagina dell'indice dei moduli. Poiché i moduli non HubSpot non sono ospitati su HubSpot, questa operazione non eliminerà il modulo effettivo e attivo sul tuo sito esterno.

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