Dokumentation
Gennemse dokumentationen

Real-time visitors and wallboard

See real-time visitors, a live activity stream and top pages from the last 30 minutes, and put a full-screen wallboard on an office TV with a secret link.

Vis som Markdown

Live#

The Live page with the visitors on the site right now and a stream of their activity.
The Live page with the visitors on the site right now and a stream of their activity.

The Live page refreshes itself every 5 seconds while its tab is visible.

  • Visitors right now: distinct visits seen in the last 5 minutes, with a bar per minute for the last 30 minutes.
  • Activity stream: the latest pageviews and events (up to 50), with the relative time, event name, page, channel, country, device and browser. Hidden events are left out.
  • Right now (last 30 minutes): the top 8 pages, referrers, countries and events. A page opens its page detail for today.
Control What it does
Pause / Resume Stops and restarts the refresh
Filter Narrows the whole page with the same filters as the dashboard: the visitor count, the bars, the stream and the top lists then cover only matching hits. The filter stays while the page refreshes
All / Pageviews / Events What the activity stream shows
Wallboard Opens the wallboard for this site
TV links Manages wallboard links. Needs sites.manage
JSON The same data from the API (live_get, with feed, filters and limit up to 100)

What you'll never see here, by design: IP addresses, cities, names, or any trail of what one visitor did.

Wallboard#

/sites/<site id>/live/wallboard shows big numbers full screen, for an office TV:

  • visitors right now with the 30-minute bars, today's visitors, pageviews and bounce rate, and the top 5 pages, countries and referrers right now,
  • refreshed every 10 seconds,
  • always dark, and the whole board shifts a few pixels each minute so nothing burns into the screen.
URL parameter What it does
site_ids The sites to rotate through (site_ids[]=pa_…, up to 12). Without it the wallboard shows the site in the URL
rotate_seconds Seconds per site, 5 to 300 (default 20)

A TV shouldn't be signed in to your account. Create a wallboard link (Live → TV links): a secret URL (/wallboard/<token>) that shows the wallboard without signing in. It is read-only and shows only live numbers and today's totals. Creating and revoking links needs sites.manage.

Field What it does
Name Optional label for the list, such as "Office TV"
Sites to rotate through The sites the link shows. The site you created it from is always included, up to 12 in total
Seconds per site How long each site stays on screen, 5 to 300 (default 20)
Expires (optional) The link stops working at the end of that day, in the site's timezone

Revoke turns a link off for good. The API operations are wallboard_links_list, wallboard_links_create and wallboard_links_delete.