Legacy: Troubleshoot Legacy Clearbit Forms for Marketo
Last Updated: November 15, 2022
🔍 Please note: This article is for customers on Standard Bundle, Enrichment, or Clearbit Platform plans.
❗Disclaimer: This guide is for troubleshooting Marketo forms Enrichment. If you are troubleshooting Marketo Database enrichment (via a webhook), use this guide instead.
If you are experiencing any of the below issues with Clearbit Marketo Forms Enrichment, follow each of the recommended troubleshooting steps.
Symptoms:
- One or more fields are failing to get enriched no matter what email is filled into the form.
- New leads are getting created through my form, but not all required fields are filled in (only happens for some emails).
- Hidden fields are appearing when they should not.
- Hidden fields are not appearing when they should.
Skip Ahead to:
- Make Sure Allowed Referrers are Set on Your Clearbit Account
- Make Sure Clearbit is Connected to Your Marketo Account
- Make Sure Your Clearbit-Marketo Field Mappings are Configured
- Make sure Clearbit's Marketo forms JavaScript snippet is added to the page
- Make sure the form's visibility rules are configured correctly (for form shortening issues only)
Make Sure Allowed Referrers are Set on Your Clearbit Account
Your Allowed Sites is a list of domains that are allowed to use your Clearbit account's publishable API key. This allows us to protect your publishable API key and prevent others from finding it and using it on unauthorized domains.
- Log into your Clearbit account and go to Integration > Manage Marketo, in the Form Shortening section.
- Under Allowed Sites you should have one or more domains listed in the Allowed Sites box.
If you do not have Allowed Sites set, add any domains where you will have a Clearbit-Marketo form deployed (only one domain per line). Here are some examples:
- clearbit.com - This will whitelist the clearbit.com homepage and any page on the clearbit.com domain. For example, adding this also whitelists clearbit.com/advertising.
- dashboard.clearbit.com - This will whitelist only pages that exist on the dashboard subdomain of Clearbit's website.
- *.clearbit.com - This will whitelist any page on any subdomain of Clearbit's website.
💡 Clearbit Tip: If you wanted to add all three of these to your Allowed Referrers, here's how it would look:
Make Sure Clearbit is Connected to Your Marketo Account
- Log into your Clearbit account and go to your Clearbit-Marketo dashboard.
- Click the Connection tab and ensure all fields are filled in.
If the fields are not filled in, click the Setup tab and complete all the steps there.
Make Sure Your Clearbit-Marketo Field Mappings are Configured
- Log into your Clearbit account and go to your Clearbit-Marketo dashboard.
- Click the Fields tab and ensure you have some mappings set up. Here is an example of a few field mappings:
If there are no field mappings configured in your dashboard, add each of the form fields you want Clearbit to enrich. The attribute on the left is Clearbit's data, and the field on the right is the name of the form field that attribute will be written to. When you are done, click Save Field Mappings.
Make sure Clearbit's Marketo forms JavaScript snippet is added to the page
- If you're using Google Chrome, click View > Developer > Inspect Elements.
- Press Command + F (Mac) or Control + F (Windows).
- Search the elements for marketo.clearbit.com.
You may have to click the up and down arrows to cycle through the matches, but somewhere in the HTML, you should find this script tag:
Make sure the form's visibility rules are configured correctly (for form shortening issues only)
- Log into your Marketo account.
- Go to Design Studio.
- Click the name of the form.
- Click Edit Form.
- Click on a field that you want to dynamically hide/show.
- Click Enabled/Disabled next to Visibility Rules.
Each field that you want to dynamically hide/show should have visibility rules following this pattern:
The most common mistake here is to use the wrong field name in the "If Clearbit Form Status Contains FirstName" portion. In this example, FirstName is the SOAP API name for the first name field in Marketo. For these visibility rules, you must use the field's SOAP API name. To find that, follow these steps:
- Go to Marketo's Admin dashboard.
- Go to Database Management > Field Management.
- Click Field Actions > Export Field Names.
This will download a Fields.xls spreadsheet of all your Marketo fields. Each row has the REST API Name, SOAP API Name, and Friendly Label. When configuring a fields visibility rules, you must use the SOAP API name of the field. You do not have to use this name anywhere else, just for visibility rules.
If you are adding this form to a Marketo Landing Page, make sure you re-approve the landing page every time you make changes to the form.
Marketo Landing Pages will always reflect the content that was on the page when it was last approved, including the state of any Marketo Forms that were on the page at time of approval. This means if you approve a landing page that is using a Marketo Form and then make changes to the form, the updated form will not appear on the landing page until that page is re-approved.
If you have added your form to a Marketo Landing Page:
- Go to Marketo's Design Studio.
- Click the name of the landing page where you added your form.
- Click Edit Draft.
- Click Landing Page Actions > Approve and Close.
You do not need to make any changes before clicking Approve and Close. Clicking this will redeploy the same exact landing page but will ensure the page starts using your updated form.
Articles in this section
- Legacy: Getting Started with Clearbit Forms for Marketo
- Legacy: Set Up Clearbit Forms for Marketo
- Legacy: Set Up Clearbit Enrichment for Marketo Forms
- Legacy: Implement Identify Calls with Marketo Forms
- Legacy: Why are my Marketo forms being submitted with empty field values?
- Prevent Marketo form fields from being hidden if Clearbit’s JavaScript does not load (using Reveal)
- Legacy: Prevent Marketo forms field from being hidden if Clearbit JS doesn't load (No Reveal)
- Legacy: Clearbit Forms for Marketo FAQ
- Legacy: Advanced Use of Marketo Forms Code
- Legacy: Troubleshoot Legacy Clearbit Forms for Marketo