Setting Up Field Mapping

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 the page overview for the page whose integration you want to customize through field mapping.
        3. If you haven't already enabled your integration, enable it by following the instructions for the given service.
        4. Click the integration you want to customize through field mapping. This will open the integration's dialog box.

Integration_Field_Mapping.png

  • In the integration's dialog box, click Configure Field Mapping. This will open the Field Mapping configuration dialog.

configure_field_mapping.png

  • In the Field Mapping configuration dialog, choose the fields you want to map from the appropirate drop down menu.

field_mapping_dropdown.png

  • Click Done to update your field mapping settings

You must click "Done" to correctly set up your Field Mapping. Even though you can see the mapping and it looks like it's all set up, it's not actually configured until you click "Done" to save it.

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.

Limitations

You can only have one Unbounce field map to any given integration field. For instance: with the given Unbounce and MailChimp fields above, you cannot have Submission Time map to UBDATE and also have Page ID map to UBDATE at the same time.


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.

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 the page overview for the page whose integration field mapping you want to customize.
  3. Click the integration you want to customize through field mapping. This will open the integration's dialog box.
  4. In the integration's dialog box, click Configure Field Mapping. This will open the Field Mapping configuration dialog.

configure_field_mapping.png

    1. In the Field Mapping configuration dialog, open the drop down menu for the field you want to map over. Select (+) Add a New Field. This will take you to the Add a New Field dialog.

field-mapping-add-new-field-dropdown.png

    1. Follow the instructions in the dialog and click Add Remote Field to add the new field to the target integration.

field-mapping-mailchimp-new-field-error.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

Overview

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

From the field mapping configuration page you'll see the following button:

field_mapping_add_custom_field.png

Click on this to add a new field map row:

field-mapping-custom-field-row-empty.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.