Unbounce Answers/Integrations/General Integrations
How to Use Field Mapping
Aaron Oman
posted this on July 25, 2011 11:34 am
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:
- An Unbounce landing page with a form
- A valid integration with either:
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
- Log in to Unbounce.
- Navigate to the page overview for the page whose integration you want to customize through field mapping.
- If you haven't already enabled your integration, enable it by following the instructions for the given service.
- Click the integration you want to customize through field mapping. This will open the integration's dialog box.
- In the integration's dialog box, click Configure Field Mapping. This will open the Field Mapping configuration dialog.
- In the Field Mapping configuration dialog, choose the fields you want to map from the appropriate drop down menu.
- 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.
Related Articles
If you are experiencing difficulties with field mapping, please send us an email at support@unbounce.com.
Comments
Tried to access these related articles, but the links are broken. Have they been posted somewhere else?
Related Articles
Same here!
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.
Hi Troy!
You can create a custom field, see here: http://support.unbounce.com/entries/20516286-field-mapping-custom-f...
Simply don't use parentheses to include the value of a form field.
I'm trying to map lead source from Unbounce to Hubspot. I created a hidden field on my page with the lead source. When I click on the hubspot integration button, and then click configure field mapping, there is no drop down on the Hubspot column for lead source. Above it says that you can add one but I don't see that option.
Hi Brent - Unfortunately the HubSpot integration only supports a specific list of target fields. You can see that list in our HubSpot integration set up article. Sorry for the confusion on this one.
I had the same issue as Brent - trying to send custom fields to our HubSpot API which is needed for our HubSpot to Salesforce integration. Since the functionality exists in Unbounce to add a new target field for other integration types, it seems like this would be a simple (and much needed) improvement to the HubSpot integration. I was eventually able to send the extra data to HubSpot, but I had to modify the landing page with hidden form fields and javascript to grab the HubSpot usertoken. I then had to create a custom web page/webhook to process the data from Unbounce and send it along to HubSpot.
(btw - I was very impressed with the ability to add custom code to the Unbounce landing pages and the wysiwyg editor is exceptionally cool)
Hi Nick,
We're currently investigating custom field mapping support for HubSpot. Conceptually it is simple, but there are many confounding factors which make it more difficult in practice.
Regarding the HubSpot usertoken; we already modify your page to capture the HubSpot usertoken when you complete a hubspot integration. I'm curious why you added custom javascript as well. Could you elaborate?
As for how you're getting leads to HubSpot: if I understand correctly, you've created an external page that receives webhook messages from Unbounce, then communicates this across to HubSpot via their API? If so, well done! And, unfortunately, that will have to be the way to send custom fields to HubSpot for the time being.
Thanks for the reply, Aaron. You're correct - my external page captures the webhook post from Unbounce which includes additional hidden fields that I need, then builds a post to push to HubSpot.
Unless I missed something, I believe Unbounce passes the HubSpot usertoken only when using the HubSpot integration. However, for my custom webhook, I had to use javascript to snag the usertoken from the HubSpot cookie and pass it along to my page via a hidden field. (The HubSpot API requires usertoken and IP address) There's always a chance I made this harder than it needed to be, but it works!
Ah, you're exactly right. Sorry about that, Nick!
Very cunning on your behalf. Well done! It will be excellent when we can reply here and say "Nick! It automatically works for you now." :)