The Visual Form listener in BlueConic helps you quickly and easily configure Form Listening on your site. You can use Form Listening to set a value for a property in a visitor's profile based on that visitor's input. By collecting input a visitor submits to a web form, you can use the listener in three ways:
To set the value of an existing profile property to a particular value, based on the visitor's input
To add a value to a profile property that supports multiple values
To create a timeline event when a visitor submits the form, with event properties filled in from the form's fields
Setting up Visual Form Listening in BlueConic
Navigate to the page that has the form you would like to collect data from. BlueConic automatically highlights forms with a dotted line. To bring up the configuration menu, select the blue Select Form button that corresponds to the form you would like to listen to:
Use the blue checkbox to include or exclude form fields from the listener.
The number in the orange box corresponds to the similarly numbered form field to help identify which field you're working with.
In the search box you can specify which profile property should store data for the corresponding form field. You can choose an existing profile property or create a new one.
Click the gear icon to the right of the search bar to select the storage rules for the data.
Once everything is configured, press the blue Save button, close the visual form picker, and your listener will be ready to turn on and run. For more information on collecting data with BlueConic Listeners, see Listeners Overview.
Creating timeline events from form submissions
Besides storing form input in profile properties, the Visual Form listener can create a Timeline event when a visitor submits a form. You set this up on the same form, using the fields you already selected. For a native form submit, you do not need a separate Timeline Event Behavior listener for that form.
Timeline event settings are optional. A form with no Timeline event type keeps working as it does today. Update the Visual Form listener from the plugin gallery to version 1.5.1 or later before you use this option.
To create a Timeline event from a form:
Open the form in the visual form picker.
Enable Create a timeline event when this form is submitted.
Select the Timeline event type to create. Choose an existing event type.
For each form field you want on the event, map it to a property of that event type.
A field can be mapped only to an event property, without a profile property. If an input’s name or id matches an event property, that mapping is prefilled.
Click Save.
The listener creates a Timeline event only when an event type is selected and at least one field is mapped to an event property. If several fields are mapped to the same event property, those values are stored as an array.
How it works
Profile properties still update as soon as the visitor changes a field’s value.
The Timeline event is created once, when the form fires a native browser submit. It uses the field values present at that moment. The value source (HTML value or visible label) and conversion settings you set with the gear icon also apply to the value written on the event.
The listener also attaches to forms that appear after the page loads, such as pop-up forms or forms added by embedded scripts. When one of those forms fires a native submit, the Timeline event is still created.
Forms that submit through AJAX or a single-page application, and never fire a native submit, do not create a Timeline event. Their profile properties still update when fields change.
Privacy management
Listeners can be added to Objectives, allowing for privacy management of the information that is being picked up. The listener will only update a profile if the visitor consented to at least one of the objectives that it is linked to.