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
scrolland ascroll_depthfor each reached milestone (25%, 50%, 75%, 90%, and 100%). - Activate an external HTTP(S) link: expect
outbound_clickwithlinkUrlandlinkDomain. - 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
| State | What it means |
|---|---|
| Setup required | The source still needs installation or verification. |
| DNS/TLS pending | The collection hostname is not ready yet. |
| Browser ready | Browser-event verification is complete. |
| Agent ready | Agent-event verification is complete. |
| Partially verified | The hostname is ready and one of browser or agent verification is complete. |
| Fully ready | The 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
| Problem | What to check |
|---|---|
| The tracker does not load | Confirm that the script URL, Tenant ID, and Source ID match the source's generated snippet. |
| The custom hostname is pending | Check the CNAME values and use Check hostname again after DNS propagation. |
| Browser events are pending | Visit the site and inspect the browser Network panel for collection requests to the active URL. Then use Check incoming data. |
| Agent events are pending | Confirm 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.