Skip to content

FAQ

This page includes a list of possible issues, categorized, and possible solutions.

General Tracking Issues

What version of the JavaScript SDK is my site using?

You can check your JavaScript SDK version by running the following snippet on your webpage:

oa.__VERSION__
If the output says 1.x you are using 1.x version of the JavaScript SDK.

A part of a page cannot be tracked at all by a JavaScript SDK Extension

Many security breaches can occur when javascript, CSS, and HTML can have access to the same content across different frames and domains in the browser, and therefore browsers explicitly prohibit anything reaching across these frame boundaries directly.

Orbee tackles these issues by providing the Event Sync solution, which installs a second script within the IFrame, and syncs the events from within the IFrame to the tracker and user on the main site. This solution provides a secure way to share data using domain name aliasing (CNAME) and cookies to only sync between the two trackers that agree to share data with each other. Learn more

Form Tracking Issues

Form Submission is not tracking

There are a couple reasons form submissions might not track at all on a website:

  1. The form is within an IFrame
  2. There exists a listener on the form that is calling e.stopPropagation or e.stopImmediatePropagation on the event before Orbee's listeners get the event

Each of these are detailed below.

1. The form is within an IFrame

See A part of a page cannot be tracked at all by the JavaScript SDK Extension.

2. The form callback is not triggered

HTML, by default, will ping the server again on form submissions, causing the page to reload. Many times, programmers want to stop this default action and do something else, like ping another endpoint instead, or validate the form. This can be done using the e.preventDefault function, and does not need to stop propagation of the event to other listeners. On older browsers that do not support e.preventDefault, returning false from the listener should also do this.

Warning

We strongly suggest that all usage of e.stopPropagation and e.stopImmediatePropagation should be removed, since it prohibits robust and non-obtrusive tracking from occurring.

If one must stop propagation of the event for whatever reason, please use one of our tracking libraries to trigger the event instead of our default tracking listener. This will allow the event to still fire, while providing you with a way to stop event propagation. This also allows you to provide additional context, such as {valid: false} that might be applicable to the event.