Adding Marketo Measure Script adding-marketo-measure-script
Marketo Measure JavaScript that you’d like tracked by Marketo Measure should be added to all web properties as soon as possible. Once the JavaScript is deployed, Marketo Measure starts collecting your digital data. This article outlines the methods for deploying Marketo Measure JavaScript and additional considerations.
When getting started with Marketo Measure, there are two ways you can add the Marketo Measure JavaScript to your website:
- Hard-Coding
- Tag Management Systems
Hard-Coding hard-coding
As a best practice, we strongly recommend hardcoding Marketo Measure JavaScript to your web properties. To hardcode the script, you need to place the script before the closing </head> on every page of your site.
<script type="text/javascript" src="https://cdn.bizible.com/scripts/bizible.js" async=""></script>
Hardcoding the JavaScript into the <head> of your pages ensures the Marketo Measure script loads first and referral information is not missed. The Marketo Measure JavaScript loads asynchronously. If hardcoding, the JavaScript must be manually added to Marketing Automation.
Tag Management Systems tag-management-systems
If adding Marketo Measure JavaScript via hardcoding is not possible, another option is to add the Marketo Measure script using a Tag Management System such as Google Tag Manager (GTM) or Tealium.
Using tag management systems to deploy Marketo Measure JS can result in a potential 5-10% data loss due to script load time latency. Essentially, if the tag management tool does not load quickly enough, Marketo Measure JS also cannot load quickly enough and could lose first referrer information.
A common practice is to deploy Marketo Measure JS via a tag management tool until timing/resourcing is better to move to hardcoding.
To add Marketo Measure script through a tag management solution, you need to create a tag and add our JavaScript within it. Apply this tag to all the pages on your website that you want tracked.
Marketo Measure recommends that any page view should cause the tag to fire. Also, it’s best to give Marketo Measure the highest priority in the firing order and make sure that there are no synchronous scripts in front of the Marketo Measure tag to ensure the highest data quality.
More information can be found here.
Additional Considerations additional-considerations
Marketo Measure JavaScript is domain-based so it is automatically able to handle any subdomains as long as the JavaScript is on the pages and the root domain is the same as the domain used to create the Marketo Measure account.
However, if you are using any separate or international domains, be sure to let your Marketo Measure Consultant know. The domains must be manually added to your account on the Marketo Measure end so that Marketo Measure knows to tie the additional domains’ data to your account. So, send any separate/international domains to your Marketo Measure Consultant.
If you use any third-party pages, have a conversation about your use case with your Marketo Measure Consultant. In general, you will want to know if you can add a custom version of Marketo Measure JavaScript to track those pages if appropriate. If this is not possible, tracking via CRM Campaign touchpoints will be explored with your Marketo Measure Consultant.
Do you have any forms that should NOT be tracked by Marketo Measure since they don’t necessarily make sense for attribution (for example, unsubscribe forms, customer logins, and so on,)? If so, you will want to add the exclude code in this article to each form
Do you have any non-secure pages? You should secure them as navigating between a secure/non-secure page breaks the tracking session.
Be sure to have a conversation with your web team so they know Marketo Measure JavaScript should always be on the appropriate web properties. If new pages/forms/sites are introduced, make sure deploying Marketo Measure JavaScript is part of the protocol.
If a Web Application Firewall (WAF) warning is triggered during the JavaScript setup, users can either disable that WAF rule or allowlist the cookies, as the below example:
Forms to Pay Extra Attention To forms-to-pay-extra-attention-to
Multi-form submission
- Issue: If you have multiple linked forms as part of a single form submission, it’s possible that the first form generates a touchpoint even if the complete form is not submitted.
- Solution: you need to force one of the forms to report the user to Marketo Measure based on cached data and discuss abandonment practices. Generally, report user code can solve for this.
Account login (not creation)
- Issue: Marketo Measure recommends not creating touchpoints for subsequent account logins, as these tend to dilute the attribution story.
- Solution: Add Exclude Code to the account/customer/partner login form.
Download of asset
- Issue: If your assets are gated, Marketo Measure tracks downloads as form fills. If your assets are not gated, there are limitations to what we can report on without customization.
- Solution: Gate the asset if you’d like it to be tracked by Marketo Measure JavaScript. If this is not an option and you’d still like a touchpoint for it, consider syncing a CRM Campaign instead.
iFrames
- Issue: iFrames essentially function as pages within pages.
- Solution: The Marketo Measure JS must be deployed directly within the iFrame header for us to attach to the form correctly.
Lightboxes
- Lightboxes are typically pop-ups that contain iFrames
- Solution: the Marketo Measure JS must be deployed within the header of that hosted iFrame.
Multiple forms on a page
- Issue: If there are multiple forms hosted on a page, you might not be able to tell which specific form was filled out with the Marketo Measure Form URL field.
- Solution: If you must know which form was filled out, explore setting up dynamic URL hashing with your web team.
Forms organized in <div> format
- Issue: Marketo Measure JS has a hard time recognizing forms organized in
<div>format so custom code can be needed. - Solution: These report user templates can be used by your web dev team to add the needed code.
Chat
- Issue: If you use a chat provider, special handling may be required.
- Solution: Marketo Measure integrates with Drift, Olark, Livechat, LivePerson, and SnapEngage. All other platforms need to be tracked through CRM campaign membership.
Second Domain
- Issue: Marketo Measure JavaScript is domain specific so extra steps must be taken for any separate or international domains. Marketo Measure JS can handle subdomains on the same root domain.
- Solution: If you own multiple root domains, that you’d like to be tracked by Marketo Measure be sure to add JS to the domains AND let your Marketo Measure Consultant know which domains should be manually associated to your Marketo Measure account.
Testing Marketo Measure JavaScript testing-marketo-measure-javascript
Your Marketo Measure Consultant will help you to spot-test the website to ensure that Marketo Measure JavaScript is present across all pages. Part of this testing is submitting a few form fills with clearly indicated test details to ensure that tracking returns properly.
However, your Marketo Measure Consultant is likely not as familiar with your website as your web team is. For this reason, it’s very important that your web team or other appropriate team, thoroughly checks the website especially if there are complex forms in use like the ones mentioned above. Your team will ultimately be responsible for ensuring that all needed web properties are properly tracking but if you are aware of any complex forms or situations, you are welcome to ask your Marketo Measure Consultant for assistance in testing.
To test a form yourself, follow these steps:
-
Always use an incognito browser or clear your cache between each form submission test AND use a different email address each time.
a. A best practice is to use a fake email that contains something indicating it is a test and the time of day. For example: testing830am@test.com.
-
Record the URL of the page that you are submitting the form and the email used.
-
Locate the record created in your CRM (Lead or Contact) for that form submission and verify that a touchpoint was appropriately created.
a. You can use a Marketo Measure stock report such as Leads with Buyer Touchpoints or look at the Lead/Contact page layout if you chose to update your page layouts with Marketo Measure details.
b. This could take some time for the data to process.