punchline!

Use

Reports

Punchline has the reports you'd expect from any web analytics tool, plus the ones only it has: which visitors are AI agents, and what they do.

Standard reports show people by default (including people sent by AI assistants). Switch to Everyone or Agents & crawlers at the top of each report. Hiding agents is the point: on many sites they're a large share of raw traffic, and they'd skew bounce rates and session lengths.

The reports

  • Overview: visitors, sessions, page views, bounce rate, average session and pages per session, against the previous period, then the people/agent split.
  • Realtime: the last 30 minutes, updated every 30 seconds: who's on the site now, pages, sources, countries and which agents are active.
  • Acquisition: channels, referring sites and campaigns (utm_*), each with engagement and goal conversions.
  • Pages: every page (views, visitors, time on page, exits), landing pages (with their sessions' bounce rate and length), exit pages, and people vs agents per page.
  • Audience: countries, device types, browsers and operating systems.
  • Goals & events: see Events and goals.
  • Accounts: which companies' agents and people researched you, for sales. See Accounts.
  • Where agents run (under AI & agents): agent sessions by where they ran. In someone's own browser, an agent joins that person's visit the same day and often a company; in the cloud, it can only be counted. Also how many agent sessions are connected by each method: same browser and day, a work email's domain, an opened handoff link, and (later) IP-to-company lookup. Agents in a browser are mostly spotted by the browser snippet's agent signals, so add the snippet next to your edge install to measure this well.
  • Explore: build your own view. Pick a metric, break it down by any dimension, add filters, and choose a line, area or column chart by day, week or month. Download it as CSV or PNG.
  • Saved reports. Save any Explore view with a name. Saved reports are private to you by default; choose Everyone with access to show one to everyone who can see the site (and to GET /v1/reports).
  • Dashboards. Put up to 24 saved reports on one page and reorder them. A dashboard's date picker applies to every report on it.
  • Share links. Admins and owners can give any saved report or dashboard of theirs a read-only link that works without signing in. Anyone with the link can see it, so treat it like a password. Shared pages follow the same privacy rules as the API: groups of fewer than 5 people are withheld. Pages aren't indexed by search engines and send no referrer. Turn a link off at any time and it stops working at once; links also stop when the person who made them leaves the site. We store only a hash of each link, so we can't show it to you again; make a new one if you lose it.

What the numbers mean

Metric Definition
Visitors Distinct visitors per day. Without cookies or stored IDs, the same person on two days counts as two. A visitor whose browser sends Global Privacy Control counts once per session.
Sessions Page views from one visitor with gaps under 30 minutes. A session belongs to the day, page and source it started with.
Bounce rate Sessions with a single page view.
Avg. session Time from a session's first page view to its last. A one-page session counts as 0 seconds.
Pages / session Page views divided by sessions.
Engaged sessions Sessions with 2+ page views or 10+ seconds.
Time on page Time until the next page view in the same session, up to 30 minutes. A session's last page has none (like GA's classic time on page).
Exits, exit rate Page views that ended a session, and their share of the page's views.

Differences from Google Analytics

  • No new vs returning visitors, and no visitor counts that span days. These need an ID that persists on the visitor's device; Punchline deliberately has none.
  • Agents are separated, not dropped. GA4 filters known bots silently; Punchline labels every visitor and lets you choose what to count.
  • Time measures end at the last page view. Without in-page pings, time on a session's last page isn't measured, so sessions look shorter than GA4's engagement time.

All of these are also in the API and to your AI assistant: metrics visitors, bounce_rate, avg_session_duration, pages_per_session, engagement_rate, exits, exit_rate, avg_time_on_page, dimensions country, device_class, browser_family, os_family and exit_path.

Ask the docs

Answers come from these docs only, written by Claude (Anthropic). Your question is sent to answer it, and isn't stored.