- Knowledge base
- Marketing
- Form
- Compilazione automatica dei campi di un modulo tramite una stringa di query
Compilazione automatica dei campi di un modulo tramite una stringa di query
Ultimo aggiornamento: 27 luglio 2026
Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:
Compila automaticamente i campi del modulo aggiungendo stringhe di query all'URL della pagina prima di inviare il modulo ai tuoi contatti. I campi del modulo, compresi quelli nascosti, verranno compilati automaticamente in base alla stringa di query aggiunta. Ad esempio, puoi creare proprietà UTM personalizzate e utilizzare i parametri UTM per compilare automaticamente un campo nascosto del modulo.
Prima di iniziare
- Le stringhe di query non possono compilare automaticamente i campi del modulo dipendenti.
- I campi dipendenti del modulo non possono essere attivati in base a più valori all’interno di una stringa di query.
Creare stringhe di query statiche con valori predefiniti
Per creare un URL con una stringa di query statica, è necessario copiare il nome della proprietà interna di tutti i campi che si desidera compilare automaticamente, quindi aggiungerli alla fine dell'URL della pagina.
Copia il nome interno della proprietà
- Nel tuo account HubSpot, fai clic sulle
icona delle impostazioni nella barra di navigazione principale. - Nel menu della barra laterale sinistra, vai su Proprietà.
- Fai clic sul nome di una proprietà per precompilare i valori.
- Copia il nome interno della proprietà. Scopri di più sui nomi interni delle proprietà.
- Ripeti questa operazione per tutte le altre proprietà per le quali desideri precompilare automaticamente i valori nel tuo modulo.

Crea l'URL con stringhe di query statiche
Dopo aver copiato i nomi delle proprietà interne, puoi configurare l’URL della pagina che invierai ai tuoi contatti:
- Nel browser, accedi alla pagina in cui si trova il modulo. Quindi, copia l’URL.
- Aggiungi un punto interrogativo (?) alla fine dell'URL della pagina. Se l'URL della pagina contiene già parametri di query, aggiungi invece una e commerciale (&).
- Aggiungi il nome interno della proprietà, seguito da un segno di uguale e dal valore da inserire automaticamente nel campo. Prendi nota delle regole per l’inserimento dei valori, a seconda del tipo di campo della proprietà:
- Casella di controllo singola: le stringhe di query devono contenere un valore vero o falso, non sì o no.
- Selettore di data: le stringhe di query devono contenere un valore di data nel formato AAAA-MM-GG.
- Caselle di controllo multiple: i valori delle stringhe di query devono corrispondere esattamente alle opzioni di valore della proprietà, con un punto e virgola a separare i valori multipli.
- Selettori a radio/menu a tendina: i valori delle stringhe di query devono corrispondere esattamente alle opzioni di valore della proprietà.
- Per tutti i tipi di campo: quando si creano stringhe di query, queste regole si applicano a tutti i tipi di campo.
- Gli spazi all’interno del valore di una proprietà devono essere sostituiti con %20.
- Proprietà multiple e diverse devono essere separate da una e commerciale (&).
Esempio di URL con una stringa di query statica
Dopo aver creato l’URL con stringhe di query statiche, è possibile utilizzarlo come link nei propri contenuti, ad esempio nelle e-mail e nelle pagine. Un contatto che clicca sul link vedrà il modulo sulla pagina compilato automaticamente con i valori predefiniti presenti nella stringa di query. Ecco un esempio e l’analisi dettagliata di un URL con stringhe di query statiche formattate correttamente:
http://www.domain.com/marketing-offer?firstname=John&lastname=Smith&email=jsmith@email.com&favorite_season=Winter%20Season&favorite_fast_food=Burger;Taco&number_property=7&will_you_come_to_the_party=Maybe&do_you_like_parties=true&date_of_party=2018-10-24
- Inizio della stringa di query e campo di testo su una sola riga:?firstname=John
- Campo di testo su una riga: &lastname=Smith
- Campo di testo a riga singola: &email=jsmith@email.com
- Campo a selezione a tendina: &favorite_season=Winter%20Season
- Campo con più caselle di selezione: &favorite_fast_food=Burger;Tacos
- Campo numerico: &favorite_number=7
- Campo di selezione con pulsanti di opzione: &verrai_alla_festa=Forse
- Campo con casella di controllo singola: &do_you_like_parties=true
- Campo con selettore di date: &date_of_party=2018-10-2
Crea stringhe di query dinamiche con token di personalizzazione
Abbonamento richiesto Per creare stringhe di query dinamiche è necessario un abbonamento a Marketing Hub Professional o Enterprise.
Utilizza i token di personalizzazione per creare stringhe di query dinamiche che compilano automaticamente i campi dei moduli in base alle proprietà note dei contatti.
Nota bene:
- Le stringhe di query dinamiche con token di personalizzazione funzioneranno correttamente solo se l’URL rimanda a una pagina ospitata da HubSpot contenente un modulo HubSpot.
- Questa funzionalità non funzionerà se l'URL rimanda a una pagina di modulo HubSpot autonoma.
- L’URL con le stringhe di query dinamiche deve inoltre essere inserito nei tuoi contenuti HubSpot o in una pagina esterna con il tuo codice di tracciamento HubSpot.
Recupera il token di personalizzazione
Recupera i token di personalizzazione necessari per creare le stringhe di query.
- Nel tuo account HubSpot, fai clic su Altro, quindi vai a Marketing > E-mail. Se Altro non compare nel tuo account, vai direttamente a Marketing > E-mail.
- Fare clic su Crea email oppure sul nome di una bozza di email.
- Nella barra degli strumenti di testo formattato, fare clic su "Personalizza".
- Configura i token di personalizzazione:
- Nella finestra di dialogo, seleziona un token di personalizzazione da inserire automaticamente nel modulo.
- Seleziona la casella di controllo "Usa il valore predefinito globale di questa proprietà " quando inserisci il token di personalizzazione.
- Continua ad aggiungere ulteriori token di personalizzazione secondo necessità.
- Nella barra degli strumenti di testo formattato, fare clic su "Altro" e selezionare l’icona del codice sorgente "codef " per visualizzare il codice HTML dell’e-mail.
- Nel codice sorgente vedrai il codice grezzo di ciascun token di personalizzazione aggiunto al corpo dell’e-mail. Ogni token sarà racchiuso tra doppie parentesi graffe {{ }}. Evidenzia un token (ad es.,
{{ contact.firstname }}), quindi fai clic con il tasto destro del mouse e seleziona "Copia". - Ripeti questa operazione per tutti i token di personalizzazione che desideri precompilare nel tuo modulo.
- Nella parte inferiore della finestra di dialogo, fare clic su Annulla e poi su Chiudi per uscire dal codice sorgente.

Crea l'URL con stringhe di query dinamiche
Utilizza i token di personalizzazione per creare un URL con stringhe di query dinamiche. Questo URL può essere utilizzato come link nei tuoi contenuti HubSpot, ad esempio nelle email e nelle pagine, oppure su una pagina esterna con il tuo codice di tracciamento HubSpot. Un contatto che clicca sul link vedrà il modulo sulla pagina compilato automaticamente con le proprie informazioni, se sono presenti valori noti per i campi nella stringa di query.
Per creare un URL con stringhe di query dinamiche:
- Nel browser, vai alla pagina in cui si trova il tuo modulo. Quindi, copia l’URL.
- Utilizzando l'URL della pagina e i token di personalizzazione, formattare la stringa di query dinamica:
- Aggiungi un punto interrogativo (?) alla fine dell’URL della pagina. Se l’URL della pagina contiene già parametri di query, aggiungi invece una e commerciale (&).
- Aggiungi il nome interno della proprietà, seguito da un segno di uguale e dal token di personalizzazione. Assicurati di rimuovere tutti gli spazi dal token (ad es., {{contact.firstname}} ).
- Separa più proprietà con una e commerciale (&).
Di seguito è riportato un esempio di URL con stringhe di query dinamiche formattate correttamente:
http://www.domain.com/marketing-offer?firstname={{contact.firstname}}&lastname={{contact.lastname}}&email={{contact.email}}
Prossimi passi
Scopri come passare i valori delle proprietà di contatto tramite campi nascosti del modulo.
