Formuliervelden automatisch invullen met een query-string

Vul formuliervelden automatisch in door query-strings aan de URL van de pagina toe te voegen voordat je het formulier naar je contactpersonen verstuurt. Formuliervelden, inclusief verborgen velden, worden automatisch ingevuld op basis van de toegevoegde query-string. Je kunt bijvoorbeeld aangepaste UTM-eigenschappen aanmaken en UTM-parameters gebruiken om een verborgen formulierveld automatisch in te vullen.

Voordat u aan de slag gaat

• Query-strings kunnen geen afhankelijke formuliervelden automatisch invullen.
• Afhankelijke formuliervelden kunnen niet worden geactiveerd op basis van meerdere waarden binnen een queryreeks.

Maak statische query strings met vooraf gedefinieerde waarden

Om een URL met een statische query-string te maken, moet u de interne eigenschapsnaam kopiëren van de velden die u automatisch wilt invullen en deze vervolgens toevoegen aan het einde van de URL van uw pagina.

Kopieer de interne naam van de eigenschap

1. Klik in je HubSpot-account op het instellingen-pictogram in de bovenste navigatiebalk.
2. Ga in het menu in de linkerzijbalk naar Eigenschappen.
3. Klik op de naam van een eigenschap om waarden automatisch in te vullen.
4. Kopieer de interne naam van de eigenschap. Lees meer over interne eigenschapsnamen.
5. Herhaal dit voor alle andere eigenschappen waarvoor u waarden automatisch wilt invullen in uw formulier.

Maak de URL met statische query-strings

Nadat u de interne eigenschapsnamen hebt gekopieerd, kunt u de pagina-URL instellen die u naar uw contactpersonen gaat sturen:

1. Ga in je browser naar de pagina waarop je formulier staat. Kopieer vervolgens de URL.
2. Voeg een vraagteken (?) toe aan het einde van de pagina-URL. Als de pagina-URL al queryparameters bevat, voeg dan in plaats daarvan een ampersand (&) toe.
3. Voeg de interne naam van de eigenschap toe, gevolgd door een gelijkteken en de waarde die automatisch in het veld moet worden ingevuld. Houd rekening met de regels voor het toevoegen van waarden, afhankelijk van het veldtype van de eigenschap:
   • Enkelvoudig selectievakje: query-strings moeten een waarde ‘true’ of ‘false ’ bevatten, niet ‘ja’ of ‘nee’.
   • Datumkiezer: query-strings moeten een datumwaarde bevatten in de indeling JJJJ-MM-DD.
   • Meerdere selectievakjes: de waarden van de query-string moeten exact overeenkomen met de waardeopties van de eigenschap, waarbij meerdere waarden worden gescheiden door een puntkomma.
   • Keuzerondjes/dropdown-menu: de waarden in de query-string moeten exact overeenkomen met de waardeopties van de eigenschap.
   • Voor alle veldtypen: bij het maken van query-strings gelden deze regels voor alle veldtypen.
     • Spaties in een eigenschapswaarde moeten worden gescheiden met %20.
     • Meerdere verschillende eigenschappen moeten worden gescheiden door een ampersand (&).

Voorbeeld-URL met een statische queryreeks

Nadat u de URL met statische query-strings hebt aangemaakt, kunt u deze gebruiken als link in uw content, zoals e-mails en pagina's. Een contactpersoon die op de link klikt, ziet het formulier op de pagina automatisch ingevuld met de vooraf gedefinieerde waarden in de query-string. Hier volgt een voorbeeld en een uitsplitsing van een URL met correct opgemaakte statische query-strings:

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

• Begin van de queryreeks en tekstveld van één regel:?firstname=John
• Tekstveld van één regel: &lastname=Smith
• Tekstveld van één regel: &email=jsmith@email.com
• Keuzelijst: &favorite_season=Winter%20Season
• Veld met meerdere selectievakjes: &favorite_fast_food=Burger;Tacos
• Getalveld: &favorite_number=7
• Keuzeknopveld: &kom_je_naar_het_feest=Misschien
• Veld met één selectievakje: &do_you_like_parties=true
• Datumkiezerveld: &date_of_party=2018-10-2

Maak dynamische query-strings met personalisatietokens

Gebruik personalisatietokens om dynamische query-strings te maken die formuliervelden automatisch invullen op basis van bekende contactkenmerken.

Haal het personalisatietoken op

Haal de personalisatietokens op die nodig zijn om uw query strings te maken.

1. Klik in je HubSpot-account op Meer en navigeer vervolgens naar Marketing > E-mail. Als Meer niet in je account verschijnt, navigeer dan direct naar Marketing > E-mail.
2. Klik op E-mail maken of klik op de naam van een concept-e-mail.
3. Klik in de werkbalk voor opmaaktekst op 'Personaliseren'.
4. Stel uw personalisatietokens in:
   
   • Selecteer in het dialoogvenster een personalisatietoken dat automatisch in uw formulier moet worden ingevuld.
   • Schakel het selectievakje 'De algemene standaardwaarde van deze eigenschap gebruiken' in wanneer u uw personalisatietoken invoegt.
   • Ga door met het toevoegen van extra personalisatietokens indien nodig.

5. Klik in de werkbalk voor opmaaktekst op 'Meer' en selecteer het pictogram 'codef -broncode' om de HTML-code van uw e-mail te bekijken.
6. In de broncode ziet u de ruwe code voor elk personalisatietoken dat aan de e-mailtekst is toegevoegd. Elk token wordt omsloten door dubbele haakjes {{ }}. Selecteer een token (bijv. {{ contact.firstname }}), klik met de rechtermuisknop en selecteer ‘Kopiëren’.
7. Herhaal dit voor alle personalisatietokens die je vooraf in je formulier wilt invullen.
8. Klik onderaan het dialoogvenster op ‘Annuleren’ en ‘Sluiten’ om de broncode te verlaten.

Maak de URL met dynamische query-strings

Gebruik de personalisatietokens om een URL met dynamische query-strings aan te maken. Deze URL kun je gebruiken als link in je HubSpot-content, zoals e-mails en pagina's, of op een externe pagina met je HubSpot-trackingcode. Een contactpersoon die op de link klikt, ziet het formulier op de pagina automatisch ingevuld met zijn of haar gegevens, mits er bekende waarden zijn voor de velden in de queryreeks.

Een URL met dynamische query-strings maken:

1. Ga in je browser naar de pagina waarop je formulier staat. Kopieer vervolgens de URL.
2. Stel je dynamische query string samen met behulp van de pagina-URL en personalisatietokens:
   • Voeg een vraagteken (?) toe aan het einde van de URL van de pagina. Als de URL van de pagina al queryparameters bevat, voeg dan in plaats daarvan een ampersand (&) toe.
   • Voeg de interne naam van de eigenschap toe, gevolgd door een gelijkteken en het personalisatietoken. Zorg ervoor dat alle spaties uit het token zijn verwijderd (bijv. {{contact.firstname}} ).
   • Scheid meerdere eigenschappen met een ampersand (&).

Hieronder volgt een voorbeeld van een URL met correct opgemaakte dynamische query-strings:

http://www.domain.com/marketing-offer?firstname={{contact.firstname}}&lastname={{contact.lastname}}&email={{contact.email}}

Volgende stappen

Ontdek hoe u waarden van contact-eigenschappen kunt doorgeven met verborgen formuliervelden.