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.

Autopopolazione dei campi del modulo con una stringa di query

Ultimo aggiornamento: 17 settembre 2025

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

È possibile autopopolare i campi dei moduli in una pagina aggiungendo stringhe di query all'URL della pagina prima di inviarla ai contatti. I campi si popoleranno in base alla stringa di query aggiunta. Questo funziona anche per i campi modulo nascosti. Ad esempio, è possibile creare proprietà UTM personalizzate e utilizzare i parametri UTM per autopopolare un campo modulo nascosto.

Limiti e considerazioni

  • Le stringhe di query non possono autopopolare i campi modulo dipendenti.
  • I campi modulo dipendenti non possono essere attivati in base a più valori all'interno di una stringa di query.

Creazione di 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 autopopolare, quindi aggiungerli alla fine dell'URL della pagina.

Copiare il nome interno della proprietà

  1. Nel tuo account HubSpot, fai clic sulle settings icona delle impostazioni nella barra di navigazione principale.
  2. Nel menu della barra laterale sinistra, spostarsi su Proprietà.
  3. Fare clic sul nome di una proprietà per pre-popolare i valori.
  4. Copiare il nome interno della proprietà. Per saperne di più sui nomi interni delle proprietà.
  5. Ripetere l'operazione per tutte le altre proprietà che si desidera inserire automaticamente nel form.

The contact property editor, displaying the property's internal name for the first name contact property.

Creare l'URL con stringhe di query statiche

Dopo aver copiato i nomi delle proprietà interne, è possibile impostare l'URL della pagina da inviare ai contatti:

  1. Nel browser, navigare nella pagina in cui si trova il modulo. Quindi, copiare l'URL.
  2. Aggiungere un punto interrogativo (?) alla fine dell'URL della pagina.
  3. Aggiungete il nome interno della proprietà, seguito da un segno di uguale e dal valore da inserire automaticamente nel campo. Osservare le regole per l'aggiunta 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.
    • Selezionatore di date: 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 che separa i valori multipli.
    • Selezione via radio/selezione a discesa: i valori delle stringhe di query devono corrispondere esattamente alle opzioni di valore della proprietà.
    • Per tutti i tipi di campo: quando si creano le stringhe di query, queste regole si applicano a tutti i tipi di campo.
      • Gli spazi nel valore di una proprietà devono essere separati con %20.
      • Più proprietà diverse devono essere separate con un ampersand (&).

Esempio di URL con una query string statica

Dopo aver creato l'URL con stringhe di query statiche, è possibile utilizzarlo come link nei contenuti, ad esempio nelle e-mail e nelle pagine. Un contatto che fa clic sul link vedrà il modulo della pagina popolato automaticamente con i valori predefiniti nella stringa di query. Ecco un esempio e una ripartizione 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 a riga singola:?firstname=John
  • Campo di testo a riga singola: &lastname=Smith
  • Campo di testo a riga singola: &email=jsmith@email.com
  • Campo di selezione a discesa: &favorite_season=Winter%20Season
  • Campo a caselle multiple: &favorite_fast_food=Burger;Tacos
  • Campo numerico: &numero_favorito=7
  • Campo radio select: &verrai_alla_partita=Maybe
  • Campo checkbox singolo: &do_you_like_parties=true
  • Campo date picker: &date_of_party=2018-10-2

Creare 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.

È possibile utilizzare i token di personalizzazione per creare stringhe di query dinamiche che popoleranno automaticamente i campi dei moduli in base alle proprietà note dei contatti.

Attenzione:

  • Le stringhe di query dinamiche con token di personalizzazione funzionano correttamente solo quando l'URL è diretto a una pagina ospitata da HubSpot con un modulo HubSpot.
  • Questa funzionalità non funziona se l'URL è diretto a una pagina di modulo indipendente di HubSpot.
  • L'URL con le stringhe di query dinamiche deve essere inserito nei contenuti di HubSpot o in una pagina esterna con il codice di tracciamento di HubSpot.

Recuperare il token di personalizzazione

Per prima cosa, recuperate i token di personalizzazione necessari per creare le stringhe di query. Per recuperare un token di personalizzazione per una proprietà:

  1. Nel tuo account HubSpot, vai a Marketing > E-mail.
  2. Fare clic su Crea e-mail o sul nome di una bozza di e-mail.
  3. Nella barra degli strumenti del testo ricco, fare clic su Personalizza.
  4. Impostare i token di personalizzazione:
    • Nella finestra di dialogo, selezionare un token di personalizzazione da inserire automaticamente nel modulo.
    • Selezionare la casella di controllo Usa il valore predefinito globale di questa proprietà quando si inserisce il token di personalizzazione.
    • Continuare ad aggiungere altri token di personalizzazione, se necessario.
The marketing email editor, highlighting the "Personalize" option in the rich text toolbar. The dialog box to edit the personalization token displays the token type, token name, and the fallback value.
  1. Nella barra degli strumenti del testo ricco, fare clic su Altro e selezionare l'iconacodef per visualizzare il codice sorgente dell'e-mail.
  2. Nel codice sorgente, si vedrà il codice grezzo di ogni token di personalizzazione aggiunto al corpo dell'email. Ogni token sarà racchiuso tra doppie parentesi {{ }}. Evidenziare un token (ad esempio, {{ contact.firstname }}), quindi fare clic con il pulsante destro del mouse e selezionare Copia.
  3. Ripetere questa operazione per tutti i token di personalizzazione che si desidera pre-popolare nel modulo.
  4. In fondo alla finestra di dialogo, fare clic su Annulla e chiudi per uscire dal codice sorgente.

The marketing email editor's source code, highlighting the personalization token internal name.

Creare l'URL con stringhe di query dinamiche

Utilizzate i token di personalizzazione per creare un URL con stringhe di query dinamiche. Questo URL può essere utilizzato come link nei contenuti di HubSpot, come e-mail e pagine, o in una pagina esterna con il codice di tracciamento di HubSpot. I contatti che cliccano sul link vedranno il modulo della pagina popolato automaticamente con le loro informazioni, se hanno valori noti per i campi della stringa di query.

Per creare un URL con stringhe di query dinamiche:

  1. Nel browser, navigare fino alla pagina in cui si trova il modulo. Quindi, copiare l'URL.
  2. Utilizzando l'URL della pagina e i token di personalizzazione, formattare la stringa di query dinamica:
    • Aggiungere un punto interrogativo (?) alla fine dell'URL della pagina.
    • Aggiungere il nome interno della proprietà, seguito da un segno di uguale e dal token di personalizzazione. Assicurarsi che tutti gli spazi siano rimossi dal token (ad esempio, {{contatto.nome}} ).
    • Separare più proprietà con un ampersand (&).
  3. Ecco 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}}

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