Storing Data from Widgets to Contact Fields
When creating subscription forms, you can add the following fields and send their data to mapped contact fields:
- Text input
- Text area
- Date
- Calendar
- Checkbox
- Dropdown
- Radio
This can enrich a contact profile with data gathered in a widget to improve message personalization.
These fields are available for all types of subscription forms:
- Inline
- Pop Up
- Floating box
- Floating bar
When a user enters data into the fields and subscribes using the widget, a new contact is created, or an existing contact is updated.
The information selected or entered into the widget fields is added to the corresponding contact fields.
To learn more about creating widgets, read Setting up Widgets for your Site.
Mapping the field data to a contact field
When you add one of the fields to your subscription form, the Process collected data as sidebar opens, offering two options:
- Contact field: This option allows you to map the data entered into this field to a contact field that you created in your account.
- Event parameter: This option allows collected data processing as event parameters.
To map the widget field to the contact field:
- Add one of the following fields to your subscription form.
- Text input
- Text area
- Date
- Calendar
- Checkbox
- Dropdown
- Radio
The Process collected data as sidebar opens.
- Select the Contact field option and click Next.
- Select the contact field existing in your account that you want to map the data to.
You can add a new field, see Adding a new field to learn more.
The fields that are not included in a list are displayed at the top of the menu. To see fields in a list, expand the list by clicking the down arrow.
Note
The field names displayed in gray cannot be added for the selected field type.
You can map the widget fields to the following types of contact fields:
Widget field | Contact field type |
---|---|
Text input | ● Text field ● Number ● Fractional number |
Text area | ● Text area |
Date | ● Date |
Calendar | ● Date |
Checkbox | ● Checkbox list |
Dropdown | ● Dropdown list |
Radio | ● Dropdown list |
After selecting the contact field for the checkbox, dropdown, or radio fields, the Edit options window opens. Edit the options as described below, then click Done:
- Change the names of the options. Enter the option name in the Names of options in the widget column.
- Show or hide options. Enable or disable the slide button in the Show option column to show or hide the option in the widget.
- Change the option position. Use the six dots icon to drag and drop the option to another position.
Adding a new field
To add a new field in the Select contact field window:
- Click + Add a field at the bottom of the window.
- In the Add a field window, select the radio button beside the existing list.
Or,
Select the radio button beside + Create a new list for this field and enter the list name to create a new list.
- Click Next.
- Enter the field name and select the field type from the Field type dropdown list.
Note
The personalization key is created automatically based on the list name. Point to the interrogation (?) icon to learn more.
- Click Done.
Configuring the added fields
After adding a field to your widget, you can edit its configuration in the General tab.
The sections available in the General tab depend on the widget type. The table below provides details about each section.
Section | Description | Available for fields |
---|---|---|
Placeholder | The text entered into the Placeholder field is shown as a placeholder in the field added to the widget. | ● Text input ● Text area ● Dropdown |
Collected data storage | This section displays the selected contact field. To choose another field, click the Change button and select another field. | ● Text input ● Text area ● Checkbox ● Dropdown ● Radio ● Calendar ● Date |
Validation | Displays validation parameters. | ● Text input ● Text area ● Checkbox ● Dropdown ● Radio ● Calendar ● Date |
Options | Shows the names of options in the selected field. Click the Edit for this widget button to edit options. | ● Calendar |
Updated 2 months ago