PureStats
Sign in

PureStats documentation

Historical analytics imports

Import aggregate history from GA4, Plausible, Matomo or a CSV file without creating artificial visitors or sessions.

PureStats can bring historical aggregate analytics into a site from Google Analytics 4, Plausible, Matomo or a CSV file. Imports are useful when you want charts to retain context from before the PureStats tracker was installed.

How imported data is handled

Imported values are stored separately from native PureStats pageviews, sessions, events and visitor profiles. PureStats never turns provider aggregates into artificial people or journeys.

The standard Overview uses imported values only for dates before the first native PureStats hit. If providers overlap, PureStats keeps both sources available but selects only the latest imported source for each day. It never silently adds overlapping providers together.

Imported aggregates are not applied to detailed traffic-mode or dimension-filter views because upstream providers cannot reproduce PureStats bot classification and visitor-level filters.

Start an import

  1. Open Site settings and select Historical imports.
  2. Choose GA4, Plausible, Matomo or CSV.
  3. Select the historical date range.
  4. Enter the read-only provider credential and property identifier, or upload a CSV and map its columns.
  5. Select Connect and import.

Credentials are encrypted before storage and are never returned to the browser. CSV files are private and removed after a successful import.

Resume or remove data

Provider imports save a checkpoint after every completed API page. A failed or cancelled job can continue from that checkpoint. Deleting a connection removes its credentials, jobs and imported aggregates, but does not modify native PureStats data.

CSV format

The first row must contain headers. A date column is required and accepts YYYY-MM-DD, YYYY/MM/DD, MM/DD/YYYY or DD.MM.YYYY. Metric columns can include visitors, visits, pageviews, bounces, duration, events, conversions and revenue. Optional dimension columns include page, source, country, device, browser and operating system.

CSV jobs accept up to 25 MB and 250,000 data rows. Split larger exports into separate date ranges.