GuidesVerify Your Setup

Verify Your Setup

Check collection-hostname readiness and verify browser and agent events separately.

How verification works

Onboarding tracks workspace setup and each source's hostname, browser events, and agent events. Browser and agent readiness are separate; a pending agent check does not mean browser tracking has failed.

Open Onboarding

Open Configure, then Onboarding. Review the Organization, Tenant, and Sources status.

Open the source setup

Find your source and open its setup. Use the generated Tenant ID, Source ID, and active collection URL.

Check the collection hostname

Use Check hostname. If a custom URL shows DNS or TLS pending, confirm its CNAME record and wait for Ready.

Install and verify browser events

Install the tracker from Setup → Tracker, then visit your site. Return to Onboarding and use Check incoming data to check browser-event verification.

Install and verify agent events

If you need AI Visibility, install the server-side forwarding example from Setup → AI Visibility. Use Check incoming data to check agent verification separately.

Check automatic interactions

With the web tracker installed and automatic tracking enabled:

  • Open a page without scrolling: expect a page_view, with no scroll events yet.
  • Scroll the page: expect one scroll and a scroll_depth for each reached milestone (25%, 50%, 75%, 90%, and 100%).
  • Activate an external HTTP(S) link: expect outbound_click with linkUrl and linkDomain.
  • Check Engagement → Events, open an occurrence, and verify its page and event data.

Internal links can appear as candidates in collection requests but are excluded from stored outbound events. Review the source's Internal domains if a domain should be treated as internal.

Read readiness states

StateWhat it means
Setup requiredThe source still needs installation or verification.
DNS/TLS pendingThe collection hostname is not ready yet.
Browser readyBrowser-event verification is complete.
Agent readyAgent-event verification is complete.
Partially verifiedThe hostname is ready and one of browser or agent verification is complete.
Fully readyThe hostname is ready and both browser and agent verification are complete.

Agent verification may remain pending until a genuine recognized crawler visits from an allowlisted IP. Changing a browser's user agent alone does not guarantee verification.

If data is not verified

ProblemWhat to check
The tracker does not loadConfirm that the script URL, Tenant ID, and Source ID match the source's generated snippet.
The custom hostname is pendingCheck the CNAME values and use Check hostname again after DNS propagation.
Browser events are pendingVisit the site and inspect the browser Network panel for collection requests to the active URL. Then use Check incoming data.
Agent events are pendingConfirm that server-side forwarding preserves the original request's IP, user agent, and path. Allow time for a genuine recognized crawler visit.

Sources

Open Setup or manage the source configuration.