Unbounce Answers/Integrations/General Integrations

Field Mapping

Aaron Oman
posted this on July 25, 2011 11:34 am

 Contents

1. Overview

2. Fields

2.1 Unbounce Fields

2.2 Integration Fields

2.3 Adding Integration Fields

3. How to Enable

3.1 MailChimp

3.2 WebHooks

4. Limitations

5. Related

 

Overview

A regular Unbounce MailChimp integration will search for any Unbounce form field with email in it's name and send this as MailChimp's EMAIL merge var.  We also try to extract the first and last name form an Unbounce form submission and send these to MailChimp's FNAME and LNAME merge vars if they exist.  Additionally, you can manually configure your MailChimp integration to capture the Page ID, Variant and Submission Time.

Field mapping allows you to break free of this mold and configure things how you like.  Let's walk through an example:

Say you have the following form on your page:

field-mapping-form.png

 

Field Mapping will allow you to send First Name to FIRSTNAME in MailChimp, Favorite Color to FAVCOLOR in MailChimp, and any other combination you can think of!

 

Fields

If you have an input form on your Unbounce page, then you are already familiar with form fields.  Field mapping deals with explicitly sending form fields to 3rd party integrations in a manner of your choosing.

Unbounce Fields

unbounce_fields.png

Unbounce fields come from your page's form.  We also include four properties from a given form submission: Submitter IP, Submission Time, Page ID and Page Variant.

Integration Fields

integration_fields.png

Integration fields are the fields that exist for a given 3rd party integration.  For instance, MailChimp allows you to define merge vars to hold custom information identifying a specific lead.

 

Adding New Integration Fields

 It's possible with some integrations to add integration fields from within the Unbounce interface.  Please see the related links for information specific to the integration you are using.

Regardless of which integration you're using, to add a new integration field, simply select (+) Add new field from the dropdown:

field-mapping-add-new-integration-field.png


How to Enable

In order to use field mapping, you must first enable it through Unbounce Labs.  Once enabled, you will be able to access field mapping from the specific integration you wish to enable it for.

You can find Unbounce Labs in your Account Details:

unbounce-labs.png

MailChimp

Simply finish setting up a MailChimp integration, then you will be able to access field mapping by clicking on the integration again to access it's settings page:

field-mapping-mailchimp.png

 

WebHooks

Like MailChimp, simply set up a WebHook, then you will be able to access field mapping when you click on that WebHook again to access it's settings:

field-mapping-webhook.png

 

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.

 

Related Articles

 

Comments

User photo
Michele Kincaid

Tried to access these related articles, but the links are broken. Have they been posted somewhere else?

Related Articles

April 18, 2012 02:24 pm
User photo
Leigh Scherer

Same here!

April 19, 2012 07:31 am
User photo
Ryan Engley
Unbounce

Hello Michele and Leigh - thank you for letting us know!  The two articles you mentioned have been published correctly and the links should work.  If you run into any further difficulties be sure to let us know.

May 08, 2012 02:04 pm