Advanced Configurations

Overview

While most of the installation and configurations for the website visits tracking are relatively straightforward, below are a few advanced configurations that may help you if you need further control.

Disabling Automatic Tracking

If you prefer manual control over tracking, update the _opts passed to the Object.assign call in the tracking snippet on your website:

window.signals = Object.assign(
  [], {
    _opts: {
      // disable automatic tracking
      autoTracking: false,
      // include any existing options below...
    }
  },
  // the rest of the initialization code is unchanged
  ['page', 'identify', 'form'].reduce(function (acc, method){
    acc[method] = function () {
      signals.push([method, arguments]);
      return signals;
    };
    return acc;
  }, {})
);

Manual Page View Tracking

To manually track page views:

window.signals.page();
// or with a specific URL
window.signals.page('https://example.com/specific-page');

Form Submit Listeners

For third-party form providers, use event listeners to capture submissions. Here's an example for HubSpot forms:

window.addEventListener("message", function(event) {
  if (event.data.eventName === "onFormSubmitted" && window.signals) {
    const values = event.data.data.submissionValues;
    if (values) {
      window.signals.form({
        email: values.email,
        name: values.firstname + ' ' + values.lastname,
      });
    }
  }
});

Troubleshooting

If you're not seeing any data:

1. Check your website's Content Security Policy (CSP) headers. You will typically need to edit both the connect-src and the script-src-elem policies. Refer to the website visit settings page in your room for more details on the exact CSP header changes required.
2. If you're using a Consent Management Platform, make sure to configure the necessary permissions for Common Room tracking.

For further assistance, please contact our support team through the Common Room Slack channel.