# Hitsteps for ChatGPT Sites

> Hitsteps is hosted website analytics for live visitor insight. This page is a
> machine-readable install guide for AI builders adding Hitsteps to a Site built
> with ChatGPT Sites or Codex.

Canonical site: https://www.hitsteps.com/

Live install kit. English machine-readable guide, updated 2026-11-15.
The public install page is https://www.hitsteps.com/chatgpt-sites/.
Compatibility notes below describe bounded tests, including the remaining
rapid-route limitation.

## Install in one step

Add this script tag to the Site's shared layout (the head that loads on every
page), exactly once:

```html
<script async src="https://edgecdnplus.com/code?code=YOUR_SITE_CODE&spa=1"></script>
```

Requirements:

- Before you paste: open the Hitsteps dashboard, go to the site Settings page, and
  set the site's consent mode to match the notice your Site will show. Configure
  and check the consent choice before you drive traffic to the Site.
- Replace YOUR_SITE_CODE with the site's 32-character hexadecimal Hitsteps code
  (0-9 and a-f) from the dashboard tracking settings. Do not append the dashboard
  API suffix or anything else to the code value.
- Keep the tag in the shared layout so every existing and future page loads it,
  including new pages and later redesigns.
- The tag must appear exactly once per page. Do not duplicate it.
- `spa=1` enables page-change tracking for client-side navigation and must be
  kept in the URL.
- If the site defines a Content-Security-Policy, allow https://edgecdnplus.com
  in script-src, img-src and connect-src.

## Verify the install

- Open the site once in a normal browser after the tag is added.
- In the Hitsteps dashboard the site should show as tracking, and its first
  visit should appear within a few minutes.

## Compatibility

Tested on private, owner-only test Sites on 2026-11-14 and 2026-11-15 (a small
bounded sample, not a reliability rate):

- Static single-page Sites: one paste installs the tag once, page and hash
  routes record, and the tag survives a redesign.
- Vite-style Sites that navigate with the browser History API (pushState):
  one paste installs the tag once, client routes, back and forward record with
  route titles, and the tag survives a redesign.
- On one Vinext/RSC Site using the browser Navigation API, the shipped tag
  stored the first visit and paced client-side routes with settled titles and
  previous-page sources. Back, forward, same-URL deduplication and a hash-only
  change passed. The tag and CSP header survived a redesign. Route proof used
  router.push; native Link clicks in the test's background tab did not navigate
  and were not a passing check.
- Known rapid-route limitation: in the live Vinext test, the first of two
  completed routes was dropped at a 2.0-second navigation gap; at a 2.6-second
  gap both routes recorded. The next stored route skipped the dropped page in
  its previous-page source. These are observations from one bounded test, not
  a safe timing threshold. A repair is still pending; do not rely on complete
  rapid-route counts.
- No guarantee is made that every ChatGPT Sites framework or future framework
  works.

Strict Content-Security-Policy note: function-based presence timers and consent
callbacks are shipped; the earlier string-timer limitation is resolved. The live
Vinext test recorded visits and routes under a CSP response header without
'unsafe-eval', with https://edgecdnplus.com allowed in script-src, img-src and
connect-src. Do not add 'unsafe-eval'. A policy that blocks inline styles can
change the consent notice's layout; check its appearance on your Site.

## What Hitsteps provides

- Live visitor monitoring and page-by-page journeys
- Traffic sources, referrers, campaigns and AI-referral tracking
- Click heatmaps (Growth plan and above)
- Website live chat, uptime monitoring, funnels and ecommerce analytics
  (plan-dependent)

## Consent and privacy

- The tracker uses first-party cookies. The Site owner is the data controller
  for the Site and remains responsible for the notice, consent choices, and
  legal basis that apply to their situation.
- In the Hitsteps dashboard, the site's consent mode (settings page) has four
  choices: always ask for full tracking; ask only when identifying information
  is being sent; track identifiable information with no popup; or track only
  non-identifiable information with no popup. Mode 2, as used in the live test,
  keeps the popup off and disables identifying-data collection.
  Declining disables deeper identifying-data collection, including user-ID
  enrichment and typed form values. Core page views, visitor continuity and
  presence pings continue; this is not a cookie-free mode.
- Install prerequisite for owners: before pasting the prompt, open the Hitsteps
  site settings, set the consent mode, add a cookie notice or banner on the
  Site where their law requires one, and verify one real incognito visit shows
  the intended message. No automatic consent workaround is provided and no
  storage or compliance promise is made.
- The install does not change the site's consent mode or make the owner's
  consent decisions. The kit is published with the existing consent settings
  preserved.

## Previews and your own visits

- ChatGPT's preview pane can load the deployed Site and count as visits from
  chatgpt.com, labeled "AI · ChatGPT". Separate your own previews from genuine
  external referrals.
- Use the site's Settings controls to exclude your browser or work IP. These
  controls were verified on the deployment domain, not inside ChatGPT's preview
  embed, so preview views may still appear in a separate browsing context.
  Excluding your browser does not exclude other visitors referred by ChatGPT.

## Notes

- Hitsteps focuses on live visitor analytics: visitors right now, their
  journeys, traffic sources, heatmaps, uptime monitoring, funnels and chat,
  with plan limits on the features page.
- The tracker stores first-party cookies. Cookie consent and compliance stay
  the responsibility of the site owner, who is the data controller.
- Hitsteps is not affiliated with or endorsed by OpenAI. Nothing here relies on
  non-public behaviour of ChatGPT Sites.
