diff --git a/docs/data-access.md b/docs/data-access.md index 7ed4dcf1..bda5ce8e 100644 --- a/docs/data-access.md +++ b/docs/data-access.md @@ -17,7 +17,7 @@ Plausible gives you several ways to access your stats outside the dashboard. The | Download stats as a spreadsheet, one-off | [CSV export](#csv-export) | | Build a custom report in Google's visualization tool | [Data Studio](#data-studio) | | Pipe data into a data warehouse or BI tool | [Warehouse connectors](#data-warehouse-connectors) | -| Get event-level data for warehousing or compliance | [Scheduled raw exports](#scheduled-raw-event-exports) | +| Get event-level data for warehousing or compliance | [Scheduled raw event data exports](#scheduled-raw-event-data-exports) | | Query data in natural language through AI tools | [MCP server](#mcp-server) | | View stats from a mobile or desktop app | [Mobile and desktop apps](data-pipelines.md) | @@ -104,17 +104,17 @@ For the full list of community connectors, apps and integrations, see [Viewing P --- -## Scheduled raw event exports +## Scheduled raw event data exports -For cases where aggregated stats are not enough, Plausible offers scheduled raw event data exports. These give you access to event-level data delivered automatically on an agreed schedule, in a format and schema configured with our team. +For cases where aggregated stats are not enough, Plausible offers scheduled raw event data exports. These give you access to event- and session-level data delivered daily to your S3-compatible object storage, in a format and schema configured with our team. **Use this when:** - You need event-level data for data warehousing, internal analytics or compliance reporting - Aggregated stats from the CSV export or Stats API do not meet your needs -Raw event exports are not self-serve and are not real-time. They are part of our [Enterprise plans](https://plausible.io/enterprise-web-analytics). [Contact us](https://plausible.io/contact) to discuss your needs. +Raw event data exports are not self-serve and are not real-time. They are part of our [Enterprise plans](https://plausible.io/enterprise-web-analytics). [Contact us](https://plausible.io/contact) to discuss your needs. -[Scheduled raw event exports](raw-data-export.md) +[Scheduled raw event data exports](raw-data-export.md) --- diff --git a/docs/export-stats.md b/docs/export-stats.md index cb5e795f..b926acbf 100644 --- a/docs/export-stats.md +++ b/docs/export-stats.md @@ -42,6 +42,8 @@ As an alternative to exporting as CSV files or if you prefer a programmatic way ## Scheduled raw event data exports -If you need event-level data rather than aggregated stats, Plausible offers scheduled raw event exports as part of our [Enterprise plans](https://plausible.io/enterprise-web-analytics). These cover advanced use cases such as data warehousing, internal analytics and compliance reporting. +If you need event-level data rather than aggregated stats, Plausible offers scheduled raw event data exports as part of our [Enterprise plans](https://plausible.io/enterprise-web-analytics). These cover advanced use cases such as data warehousing, internal analytics and compliance reporting. + +Exports are delivered daily to your S3-compatible object storage. See the full guide for example Parquet files, supported formats and the policy on historical backfills. [See full details, use cases and how to get started →](raw-data-export.md) diff --git a/docs/raw-data-export.md b/docs/raw-data-export.md index 6ecdf08a..2320c41e 100644 --- a/docs/raw-data-export.md +++ b/docs/raw-data-export.md @@ -1,23 +1,54 @@ --- displayed_sidebar: someSidebar -title: Scheduled raw event exports -description: "Get event-level data from Plausible delivered automatically on a schedule. For data warehousing, compliance and internal analytics where aggregated stats are not enough." +title: Scheduled raw event data exports +description: "Get event-level data from Plausible delivered automatically every day. For data warehousing, compliance and internal analytics where aggregated stats are not enough." --- import PlanFeatureNote from '@site/src/components/PlanFeatureNote'; - + -The Stats API and CSV export give you aggregated data: totals, breakdowns and time series across your sites. For cases where you need the underlying event-level data, Plausible offers scheduled raw event exports. +The Stats API and CSV export give you aggregated data: totals, breakdowns and time series across your sites. For cases where you need the underlying event-level data, Plausible offers scheduled raw event data exports. ## What it is -A scheduled raw export delivers event-level data from your Plausible account automatically, on an agreed schedule. Setup is configured with our team: we agree on the event data fields and schema, the export format (CSV or Parquet), the delivery interval (daily, weekly or other) and the delivery destination. We support uploading directly to your S3 bucket or Google Cloud Storage bucket. Once configured, exports are delivered automatically with no action needed on your end. +A scheduled raw export delivers event- and session-level data from your Plausible account to your object storage every day. -Unlike the Stats API, which returns pre-aggregated results, raw exports give you individual event records. This lets you run your own aggregations, apply custom attribution models, join analytics data with other business data, and meet compliance requirements that call for event-level audit trails. +Setup is configured with our team: we agree on the data fields and schema, the delivery destination and whether the export uses CSV, Parquet or JSON Lines (JSONL). + +We can deliver to any S3-compatible object storage service, including AWS S3 and Google Cloud Storage. Once configured, exports are delivered daily with no action needed on your end. + +Unlike the Stats API, which returns pre-aggregated results, raw exports give you individual event records. + +This lets you run your own aggregations, apply custom attribution models, join analytics data with other business data, and meet compliance requirements that call for event-level audit trails. Raw exports are intentionally scoped to keep Plausible fast, privacy-friendly and predictable. They are not real-time and not self-serve. +## Explore an example export + +Download an example export for plausible.io covering July 2026: + +- [events.parquet](https://edlvc.upcloudobjects.com/plausible-io-example/2026-07/events.parquet) contains the individual event records +- [sessions.parquet](https://edlvc.upcloudobjects.com/plausible-io-example/2026-07/sessions.parquet) contains the sessions those events belong to + +Use these files to inspect the Parquet schema and example values before planning how you will load the data into your own systems. + +## What's included + +Alongside the event-level file, exports include a companion session-level file, so you get both individual events and the sessions they belong to. + +Custom properties are delivered as a single JSON object per row rather than a fixed set of columns, so you don't need to declare property names in advance and can change your instrumentation over time without breaking the export schema. + +Plausible-generated identifiers are an anonymous session ID and a daily-rotating anonymous user ID used for unique-visitor calculations. + +Delivery to Google Cloud Storage goes through GCS's S3-compatible endpoint using static (HMAC) credentials, the same as an S3 bucket. Authenticating with a native GCP service account isn't supported out of the box. + +## Historical data and backfills + +Daily exports start after setup. Historical backfills are not included by default. Because backfills are prepared manually, only short backfills may be possible case by case. + +If you need historical data, include the date range when contacting us so we can confirm what is possible. + ## When to use it Raw exports are the right choice when: @@ -41,4 +72,4 @@ Before requesting raw exports, check whether a simpler option covers your needs: ## How to get it -Raw event exports are part of our [Enterprise plans](https://plausible.io/enterprise-web-analytics) and are not self-serve. [Contact us](https://plausible.io/contact) to discuss your data volume, delivery schedule and format requirements. +Raw event data exports are part of our [Enterprise plans](https://plausible.io/enterprise-web-analytics) and are not self-serve. [Contact us](https://plausible.io/contact) to discuss your data volume, export format, storage provider and any historical date range you need. diff --git a/docs/subscription-plans.md b/docs/subscription-plans.md index 4eb726b4..a785e1d4 100644 --- a/docs/subscription-plans.md +++ b/docs/subscription-plans.md @@ -39,7 +39,7 @@ Enterprise includes everything in Business plus additional features and higher l - **SSO (Single Sign-On)**: log in via your existing identity provider using SAML 2.0. See [SSO documentation](sso.md). - **Sites API**: create and manage sites programmatically. See [Sites API documentation](sites-api.md). - **Managed proxy**: we handle the proxy setup and maintenance for you. See [proxy options](proxy/introduction.md). -- **Scheduled raw event exports**: event-level data delivered automatically on an agreed schedule. See [raw event exports](raw-data-export.md). +- **Scheduled raw event data exports**: event- and session-level data delivered daily to your S3-compatible object storage. See [raw event data exports](raw-data-export.md). Limits that can be increased on Enterprise beyond standard plan tiers: