Install Javascript for Forms Tracking

Reo.Dev’s JavaScript beacon works consistently across all your assets — website, documentation, and product. If the JS is already installed on any of these properties, you don’t need to re-install it to track form activity.

However, if you're using separate platforms for landing pages or lead capture (e.g., HubSpot, Unbounce), you’ll need to manually add the JS snippet to those assets to track form opt-ins effectively.

circle-info

Form tracking is currently supported for:

  • HubSpot forms

    • Hubspot form

    • Non-HubSpot forms utilizing the HubSpot API

  • Ninja Forms

  • Standalone form with semantic HTML <form> tag and <input type="submit" />

If you’re using a different form library, please reach out to your account manager.


Installation Methods

You can install JavaScript to track the user activity on the documentation webpages in two ways.

Using CDN

To install JavaScript code using our CDN, follow the instructions below:

1. Get the JavaScript Snippet:

Copy the JavaScript code snippet from Reo.Dev Dashboard. Go to Integrations >> Tracking Beacon >> Documentations >>Method 1: Using CDN

https://web.reo.dev/dashboard/integration/documentationarrow-up-right

2. Integrate the JavaScript into Your Web Project:

Go to the root index.html page of documentation web pages

3. Locate the <head> Tag:

For optimal performance, it’s recommended to place the script within the <head> tags of your HTML document. This ensures it's loaded early in the page's lifecycle.

4. Insert the JavaScript Snippet:

Insert the JavaScript snippet provided within the <head> section of your HTML file.

5. Save and Deploy:

Save the changes to your HTML file and deploy it to your server.

6. Verification:

  • Go to any screen after login and right-click anywhere

  • In the dropdown menu, select Inspect.

In the elements tab, Use the Ctrl + F or Cmd + F and search for “reo”

If the tracking code appears, verify that the code matches


Error Scenarios

  • Script initiation

    Script initiation has been modified to rely on code initiation only on successful callback post download from CDN. So it will only initiate if successfully downloaded. In case the download fails, the javascript won’t get enabled but this eliminates the likelihood of an error scenario of page breaking

  • API failure on token delete

    On deletion of all Reo tokens, the most recent event tracking data will likely fail, but subsequent API calls will work fine

  • Any inadvertent code failure on JavaScript

    This should not be an issue since the code is wrapped in a try-catch block, the console may throw errors, which won’t be visible even on the console since logger would be disabled on the script

circle-info

Cookie Management and Compliance

To learn more about Reo.Dev's cookie usage, categorization, and best practices for implementation, refer to this guide.


Adding Form URLs in Reo.Dev

Once your JS is installed and deployed, go to:

Settings → Integrations → Tracking Beacon → Forms

Here you can:

  1. Add the URL of the page where your form lives (e.g., /contact).

  2. Give the form a custom name for easier identification later.

Once saved, this name becomes available in the Segment builder under:

Activity Group → Forms → Key Pages: Forms

You can then use this to create segments of users who visited those pages.

circle-info

Note: This filter currently identifies all visitors to the page, not just form submitters. We’re working on enhancing this feature so you’ll soon be able to filter users who specifically filled out the form on a configured page.


Content Security Policy (CSP) Considerations

If your website uses a strict Content Security Policy (CSP), you may need to update it to allow our script to load and execute correctly. Please ensure the following directives are updated to include our domains:

Required CSP Directives


FAQs

Last updated

Was this helpful?