Optimly Developer Documentation

Site Analytics

Site Analytics troubleshooting

In short

Diagnose collection, origin, CSP, duplication, and goal-matching problems.

Start with the browser Network panel and Optimly's installation health. Do not debug by adding extra payload fields or logging visitor data.

No events arrive

  1. Confirm the production page contains exactly one Optimly snippet.
  2. Confirm the script request succeeds.
  3. Confirm the configuration request uses the expected public site key and browser origin.
  4. Check CSP script-src and connect-src.
  5. Check that the Site Insights site is not disabled.
  6. Verify the exact configured scheme, hostname, and port.

HTTP responses

StatusMeaningNext action
202Event accepted; inspect accepted and duplicateContinue to goal matching if needed
400Invalid key, configuration request, or event schemaCopy the canonical snippet and remove custom payload fields
403Origin not authorized or collection disabledCorrect the allowed origin or site state
429Bounded collector rate exceededStop synthetic loops and retry after the window

Data arrives but a goal stays at zero

  • Confirm the goal is active for the event time.
  • Confirm the tested path, hostname, destination, form key, or event type matches the rule.
  • Remember that link_click and form_submit are engagement signals unless a stronger success signal

is also observed.

  • Confirm test traffic is not being compared with live reporting.

Unexpected duplicates

Search the shared layout, tag manager, page embeds, and platform custom-code areas for another copy of the snippet. Do not install a route-level copy in a single-page application.