Audience
Who visits, from where, and on what browsers, systems and screen sizes.
Audience answers three questions about the people who visit: how many came and how they behaved (visitors, page views, bounce rate and time spent), where they came from (countries and regions), and what they used (browsers, operating systems and browser sizes).
Every query here takes the Analytics arguments: view or websiteId, a period, and filters.
Over time#
The queries named "over time" answer with a series: one step per hour, day, week or month, oldest first, with every step present even when nothing was recorded in it. They need a period with a start, so send any period but all, the default: with all they answer with an error.
How long a step is depends on the period:
| Period | Each step |
|---|---|
today, or custom with from and to the same day | An hour |
last-12-months, or custom covering exactly twelve months | A month |
| Any other | A day |
With period=custom, interval chooses the step instead: PT1H, P1D, P7D, P1M or P1Y. Weeks start on Monday, so start a weekly range on a Monday: when from is another day, the visits before the first Monday are left out of the steps, though not out of total.
Send previousPeriod=1 to compare: each step gains the figure from the same step of the period before, which is as long as yours and ends where yours starts.
Visitors and page views#
A visitor is one person, counted once however many pages they read. A visit (a session) is one stay on the website, from arriving to leaving. A page view is one page loaded.
Traffic collected at the Basic consent level records page views but no visitor and no visit. It counts in page views, and nowhere else: not in visitors, visits, bounce rate or time spent. A website that collects at Basic before visitors consent can show many page views and few visitors.
In Silktide itself: Audience, in Help.
- GETGet how many people visited, step by step over a period
/v1/results/analytics/visitorsReturns how many people visited in each step of a period, and across the whole of it, for an analytics view or a website. - GETGet how many pages were viewed, step by step over a period
/v1/results/analytics/page-viewsReturns how many pages were viewed in each step of a period, and across the whole of it, for an analytics view or a website. - GETGet the share of visits that bounced, step by step over a period
/v1/results/analytics/bounce-rateReturns the share of visits that bounced in each step of a period, and across the whole of it, for an analytics view or a website. - GETGet how long visits lasted, step by step over a period
/v1/results/analytics/duration-over-timeReturns how long the average visit lasted in each step of a period, and across the whole of it, for an analytics view or a website. - GETList the countries visitors came from
/v1/results/analytics/countriesLists the countries visits came from, with each country's visitors and page views, most visitors first. - GETList the regions within countries that visitors came from
/v1/results/analytics/regionsLists the regions within countries that visits came from, such as states, provinces or the nations of the United Kingdom, with each region's visitors and page views, most visitors first. - GETList the browsers visitors used
/v1/results/analytics/browsersLists the browsers visitors used, with each one's visitors and page views, most visitors first. - GETList the operating systems visitors used
/v1/results/analytics/operating-systemsLists the operating systems visitors used, with each one's visitors and page views, most visitors first. - GETList the sizes of browser window visitors used
/v1/results/analytics/browser-sizesLists how wide visitors' browser windows were, grouped into sizes, with the visitors and page views at each, smallest first. - GETGet visitors at each browser size, step by step over a period
/v1/results/analytics/browser-sizes-over-timeReturns one series per browser size, with the visitors at that size in each step of a period, for an analytics view or a website.