Setting Up Field Mapping

Follow

Unbounce allows you to map custom fields from your Unbounce form to many of our third party integrations. You can currently use field mapping with the following integrations:


What is Field Mapping?

Field mapping allows you to send custom Unbounce form fields over to your integration service. For example, you could map the first_name field in Unbounce over to MailChimp's name field or map a custom field like hair_colour to the target field of your choice.


How can I use Field Mapping with Unbounce?

Configuring Field Mapping is quite simple. Just follow the steps below to get up and running.

What you will need:

What it will do:

      When lead data is collected through an Unbounce form, Unbounce will send the form field data to the mapped fields in your integration.

Setting up Field Mapping

  1. Log in to Unbounce.
  2. Navigate to your Overview page and scroll to the bottom of the page where you’ll see all of the integrations.
  3. If you haven't already enabled your integration, enable and authorize it by following the instructions for the given service. Once your integration is enabled, the integration box will be green and you’ll see a check mark beside that integration.
  4. image5.png
  5. Click the integration you want to customize through field mapping. This will open the Unbounce Form Field dialog box.
  6. image3.gif
  7. In the Unbounce Form Field dialog, choose the fields you want to map from the appropriate drop down menu.
  8. Customize the destination fields with the appropriate drop down menu option.If you’d like to add a new field, you can select (+) Add a New Field to add a new field to target integration.
  9. Click the Save Changes button to update and save your field mapping settings.

That's it, you're all set! Once your field mapping is configured, your Unbounce form fields will be send to the selected target field in your integration.

 


 

Adding New Fields to Your Field Mapping

Adding a new field to your field mapping set up lets you map a value from Unbounce to a new field with your integration service.

How can I use the Add New Field Feature?

If you have a value in your Unbounce form that doesn't exist in your integration service, the Add New Field feature will automatically add a new field in your integration service. This is handy because you can manage the integration right within Unbounce without having to hop around from service to service.

Note

This functionality is only available when supported by the third party integration the form data is being sent to. Unbounce cannot guarantee this functionality for all it's integrations.

What you will need:

What it will do:

Add New Field will create a new field in your integration service and send data from your Unbounce form over to that field.

 

Adding a New Field to Your Field Mapping Setup

  1. Log in to Unbounce
  2. Navigate to your Overview page and scroll to the bottom of the page where you’ll see all of the integrations.
  3. Click the integration you want to customize through field mapping. This will open the Unbounce Form Field dialog box.
  4. In the Field Mapping configuration dialog, open the drop down menu for the field you want to map over. Select (+) Add New Field. This will take you to the Add New Field dialog box.
  5. image4.png
  6. Fill in the requested information in the new dialog box, and click Add Remote Field to add the new field to the target integration. This will close the Add New Field dialog box.
  7. image6.png

 

That's it, you're all set!

Once you add the remote field and select it in your field mapping setup, Unbounce will map the select form field over to that target.

 


 

Field Mapping Custom Fields

 Want to combine multiple form fields into a single value? Now you can!

  1. Follow the instructions above to navigate your way to the field mapping configuration page.
  2. Click the + Add Another Custom Field button.
  3. image2.png

This will add a new field map row:

 image10.png

 

You can enter any text here, and that text will be sent exactly "as is" to the selected integration field. One usage of this feature is the ability to specify a unique page identifier (to supplement the Page ID) to differentiate between leads from different pages.

That's fine and dandy, but the real power of custom fields comes from the ability to combine form fields together.

 


 

Including Form Fields

You can include the value of a form field inside your custom field by specifying a form field name in parentheses:

field-mapping-custom-field-first-name.png

Assuming you have a form field with the name "First Name", then this value will be substituted directly in during a form submission.

For instance, if you have the following form submission:

field-mapping-form-filled-out.png

And the following custom field:

field-mapping-custom-field-first-name-extra-text.png

When the above form submission in handled by Unbounce, "Aaron is super cool" (without the quotes) will be sent in place of the custom field you just specified.


Combining Form Fields

Since custom fields are simply text strings, you can include as many form fields as you like:

As long as the name in parentheses matches exactly with a form field, then the form field value will be substituted into the custom field during a form submission.

This is essentially the same as hour our WebHook parameter replacement works.With the custom field "(First Name) (Last Name)", the value: "Aaron Oman" would be sent, using the above form submission.

field-mapping-custom-field-row.png


Glossary

Field Mapping: allows you to send custom Unbounce form field to a different field in your integration.
Configure Field Mapping: opens the Field Mapping configuration dialog, where you can select which form field data will be sent to the mapped fields in your integration.
Limitations: can only have one Unbounce field map to any integration field.


Was this article helpful?
18 out of 23 found this helpful