When to use Web Form Mappings

Do you have forms on your website that leverage a different form building software (like Gravity Forms)?

If yes, you have the possibility of using the Web Form Mappings tool we provide! The Web Form Mappings tool allows you to map forms that are created on other form building software to Net-Results. When a contact submits that form, the information will also be sent to Net-Results and we will update or create a contact in your instance!

Mapping Your Existing Web Form

To create a new web form mapping, go to Marketing Center Web Form Mapping Create New.

1. On the left column you will see the names of the fields as set within your web page code. Select the appropriate match for each field using the drop down boxes on the right. For example, if your form on your website says ‘Company’, you would want to match that with Company Name in the drop down box.
2. Unnecessary fields may also be read by Net-Results. If that information is not important to use, leave the drop down option as ‘Do Not Record’.
3. Your web form may also include custom fields. You will need to set up custom fields on the Custom Fields page before creating a new form mapping, or you can continue saving this form mapping and editing it later.
   • When using a drop-down menu in your form, make sure each option has a value attribute (i.e. <option value=”California”>California</option>).

   Note that by default, contact names are divided into First Name and Last Name fields. We do not offer a standard field for ‘Full Name’ and we recommend that contacts are entered and uploaded using First Name and Last Name fields. However, you may elect to create a custom field for Full Name using the Custom Field page. Understand that doing so may compromise the uniformity of contact records and make filtering, segmenting, and creating lists difficult.

4. Select a list or multiple lists to associate with this web form. Visitors who complete the web form will be automatically added to that list.
5. Remember to click the Save button and save your work before navigating away from this page.
6. We recommend you test your web form mapping by filling out the form on your website and then checking for list membership.
   • Remember, you might already be a contact on your own account, so you will not be added as a new contact if you complete your own web form on your computer.
   • You may want to have someone who has never been tracked by Net-Results on your website as a defined contact (personally identified) test the form mapping on another computer.

Web Form Troubleshooting

Testing & Troubleshooting FAQ

1. Testing is best performed in private browsing mode. Private browsing will not use any of your existing cookies, nor will it store any cookies or history once you close the session. Submitting a form in this way confirms whether Net-Results is able to collect data from the form.
2. When troubleshooting, it’s sometimes necessary to reproduce an issue on multiple browsers to identify the source of the issue.
3. Once you submit, check the My Visitors area for the details you entered using the All Contacts segment. If you don’t see them there, the cause may be one of these issues:

Setup Issues

1. Is the Capture Code in place?
   1. View source of your web form and search for the tracking code provided under your My Account tab. If the capture code is not on the page, no page views or submitted data can be captured.
2. Is the mapping set up complete and enabled?
   1. Make sure that your mapping is saved by confirming it is listed when you access the My Web Form Mappings page under the Forms section of the Marketing Center.
3. Is the product enabled?
   1. Confirm with the Customer Success team that your instance of Net-Results has not been canceled or otherwise suspended.
4. Does the URL match exactly what is in the setup?
   1. Some browsers will “hide” a trailing slash on a URL for cosmetic reasons. The best practice is to copy and paste the full URL from the address bar of your browser. Note that this must be the exact URL, minus any GET variables (below), that will be accessed by a website visitor.
5. Does the URL begin with HTTP or HTTPS?
   1. If it can be reached by both, two different mappings will need to be created.
6. Are GET variables being appended onto the form URL by your links?
   1. If the destination URL contains variables that are not unique to each visitor, you will need to map the “static” portion of the URL (meaning everything prior to the question mark) and select the “Ignore Additional GET variables” checkbox. Example of GET string in form URL:

http://www.mydomain.com/contactus?field1=value1&field2=value2&etc.

Form Issues

1. Is there an email address field mapped?
   1. Check the mapping to make sure your email address field is mapped properly. If this is incorrect, Net-Results will not be able to associate a form submission to a contact.
2. Does each field to be mapped have a name attribute in the HTML tag?
   1. The name attribute is how Net-Results knows which fields to use. Note: the use of array syntax with empty values is not currently supported.
3. Is the for page composed of an iFrame?
   1. We discourage the use of iFrames because they require additional javascript to be built into the form. Typically you would not need an iFrame for this function.
   2. Is the form composed of AJAX?
      1. For the same reason as iFrames, we discourage the use of AJAX on web forms to be mapped. While it is possible, it requires additional scripting to be created by your development team.
   3. Is the browser using a cached copy of the form?
      1. Especially when testing, it is important to be using a fresh version of the form page. If any changes are made (to the form or the Web Form Mapping) make sure to force a refresh in your browser (usually Ctrl+Shift+R).
   4. Are any other javascript libraries being included on the form page?
      1. These can be responsible for interrupting the capture operation. To check if there are any other javascript libraries, do the following:
         1. Right Click on the form
         2. Hit “Inspect”
         3. Navigate to the “Console” tab.
         4. Refresh the page, & note if there are any javascript errors on the page.
         5. If there are errors, take a screenshot and send it in to support. Our team will explain more about what is going on!
      2. Is the form page composted of Flash?’
         1. Flash does not function at all with our web form mapping

FAQ

FAQ

1. Do web form mappings work with third-party form generators like MailChimp, Formstack and Wufoo?
   1. Web Forms Mapping works with basic forms. If your form generator uses a special/custom Javascript submission method, we are unable to capture information entered into it.
2. If the form is “hosted” on a site that is not yours, such as yoursite.wufoo.com, it cannot be tracked because a domain you don’t own cannot be added to a domain group.
3. Currently, forms created through Unbounce.com can be mapped using our Unbounce Forms integration even though a custom submit is used for these forms. But for other sites like MailChimp, Formstack, Wufoo and WebToLead Forms generated by SugarCRM are not supported by Web Form Mappings.
4. If you are looking for a form generator and use WordPress, we recommend Gravity Forms as it has worked consistently for our customers with both mapping and capture. [/ht_toggle]