JavaScript Overview

Prev Next

📚 Web Form Attribution Series - Part 2 of 3

Part 1: Web Form Attribution Tracking - Implementation guide  

Part 2: JavaScript Overview (you are here)

Part 3: JavaScript Testing Guide - Validation and troubleshooting  

The Integrous JavaScript passes web source Attribution into the marketing automation platform, and ultimately to Salesforce, for web form submitters. It can also be configured for other kinds of web submissions like chat and other form implementations.

This Document Will Cover:


Overview

The Integrous attribution system is designed to store web source information in users’ local browsers, and then to pass that information into hidden form fields when a form is submitted, only using client-side storage, not writing to or from external sources (for security/privacy compliance). Because it runs as a first-party script and doesn’t rely on cookies, it’s less likely to get blocked by browser ad-blockers (though some small percent will get blocked with any tracking system).

It also passes this information for a given user between domains and sub-domains to ensure no data is lost for visitors who navigate between your web properties before submitting a form.

Each time a visitor arrives on the website, the JS writes the user’s source attribution into their local browser storage with the following logic:

  • It uses UTM Parameters in the page URL if present

  • If no UTM parameters are present, it attempts to determine whether the visit is from Organic Search, Organic Social, or other Referral (along with the source domain of each)

  • Otherwise it writes “Direct”

The intention is to capture source information for each user into their local browser, however they got to the site, as long as their browser allows such tracking.

This information is saved in the user’s local browser storage for a configurable amount of time (it is pre-configured to save it for 30 days, after which it expires). Each time the user returns to the website, it writes the new source attribution to their local storage (except “Direct,” which is only captured if there isn’t already attribution stored for the user), building a history of attribution stored within their browser, each expiring after the configured duration.

To pass the attribution data into form submissions, the system looks for specific hidden form fields and automatically updates the fields with the attribution data (both the oldest attribution and the most recent non-direct attribution, i.e., first-click and last-click), as well as the current page URL and the date. If any UTMs are blank, it fills a value of “Undefined”.

If the user’s browser allows JS to run but blocks the ability of the JS to access the local storage, it will parse UTM values out of the current page URL if possible, or if none are present, it will fall back to UTMs in the previous page visited in order to reduce the incidence of blank attribution due to individual browser security settings.

When the user submits a form, this data will pass into the marketing automation platform (controlled in the form posting, not in this JS) and ultimately into Salesforce. This information will layer valuable source attribution information onto the sales process, ultimately allowing the connection of front-end campaign data (including cost) with sales process data in Salesforce (including revenue) in order to report on return on investment.


Web Tracking Compliance Considerations

Here are a few things to keep in mind when considering web tracking/cookie compliance:

  • The Integrous JS runs as a first-party script, not a third-party script

    • It runs just like any other JS on the website that is used for basic website functionality

  • We don't use cookies

    • This data is stored in the user's local browser storage, not in cookies

  • If they submit a form, the data only posts to the client systems, along with the user-entered fields like name and email address

    • We don’t store web session information for our clients

  • There is no PII in the data that is tracked

    • The only data stored is UTM fields, page URL, and date

  • Many of our clients do not give users the option to block this tracking and don't include our script in their cookie/tracking management options

    • This is because the tracking data only leaves the user's browser if they submit a form

    • These clients include a note in their privacy policy that says submitting a form constitutes consent to passing basic source tracking info


JavaScript Settings Configuration

The Integrous Analytics team manages the JavaScript configuration. For questions, please contact your Integrous point of contact.


Implementation and Testing Resources

Ready to implement JavaScript tracking on your website? Use these comprehensive guides:

Web Form Attribution Tracking Guide - Step-by-step implementation instructions including:

  • Detailed JavaScript installation via Google Tag Manager

  • Complete hidden form field requirements and configuration

  • Engagement Type and Engagement Date field setup

  • Cross-domain tracking setup

  • Troubleshooting common implementation issues

JavaScript Testing Guide - Verify your implementation is working correctly:

  • Quick reference for technical users

  • Detailed testing methodology for all skill levels  

  • Salesforce verification steps

  • Advanced debugging techniques

  • Complete testing checklist

These guides provide the detailed implementation and validation steps needed to successfully deploy the attribution tracking described in this overview.