From 09b1b1cfc1c1d26ff24acb39a46bdc3c0500f103 Mon Sep 17 00:00:00 2001 From: Marko Saric Date: Tue, 22 Sep 2026 10:23:27 +0200 Subject: [PATCH] updated details --- docs/bot-traffic-filtering.md | 2 +- docs/raw-data-export.md | 2 ++ docs/troubleshoot-integration.md | 10 ++++++++-- 3 files changed, 11 insertions(+), 3 deletions(-) diff --git a/docs/bot-traffic-filtering.md b/docs/bot-traffic-filtering.md index 5a1f7a0f..40bbe546 100644 --- a/docs/bot-traffic-filtering.md +++ b/docs/bot-traffic-filtering.md @@ -11,7 +11,7 @@ We use multiple layers to filter non-human traffic: - **User-Agent filtering.** We block known bots and crawlers by their User-Agent header, including search engine crawlers, scrapers and monitoring tools. - **Referrer spam filtering.** We filter out traffic from known referrer spam domains. -- **Data center IP filtering.** We filter traffic from approximately 32,000 known data center IP ranges commonly used by bots and automated tools. +- **Data center IP filtering.** We filter traffic from approximately 40,800 known data center IP ranges commonly used by bots and automated tools. - **Traffic pattern detection.** We use our own algorithm to detect and exclude unnatural traffic patterns that don't match human browsing behavior. In [a server log comparison we ran](https://plausible.io/blog/server-log-analysis), we saw 18x more pageviews in server logs than in Plausible, which illustrates how much non-human traffic Plausible excludes. In a [separate test comparing Plausible to Google Analytics](https://plausible.io/blog/testing-bot-traffic-filtering-google-analytics), we ran three bot traffic scenarios against both tools. GA4 recorded all of them as legitimate traffic. Plausible rejected all three. diff --git a/docs/raw-data-export.md b/docs/raw-data-export.md index 54fd2658..093e1b49 100644 --- a/docs/raw-data-export.md +++ b/docs/raw-data-export.md @@ -47,6 +47,8 @@ Delivery to Google Cloud Storage goes through GCS's S3-compatible endpoint using Daily exports start after setup. During setup, we can include a one-time backfill covering up to the 30 days immediately before the first scheduled export. Earlier historical data cannot be included. +This backfill is intended to cover data collected during the free trial when new subscribers set up scheduled exports. We do not offer raw data exports of your full history. + If you need this backfill, include the requested start date when contacting us. ## When to use it diff --git a/docs/troubleshoot-integration.md b/docs/troubleshoot-integration.md index 159c8e33..e7bca266 100644 --- a/docs/troubleshoot-integration.md +++ b/docs/troubleshoot-integration.md @@ -55,7 +55,7 @@ description: "Troubleshoot your Plausible Analytics installation. Diagnose why v "name": "Why are Events API events not appearing in the dashboard?", "acceptedAnswer": { "@type": "Answer", - "text": "Plausible always returns HTTP 202 Accepted, even when an event is not recorded. Check the response headers for x-plausible-dropped: 1. The most common cause is a misconfigured X-Forwarded-For header forwarding a server IP instead of the real visitor IP." + "text": "Plausible can return HTTP 202 Accepted even when an event is not recorded. Check the response headers for x-plausible-dropped: 1. Bot filtering and site exclusion rules can cause events to be dropped. The most common cause is a misconfigured X-Forwarded-For header forwarding a server IP instead of the real visitor IP." } }, { @@ -250,6 +250,12 @@ If the verification tool has already confirmed that tracking is working, the res See the [WordPress plugin issues](#wordpress-plugin-issues) section above for admin exclusion, proxy problems and cache conflicts. +### Is your visit being filtered out? + +Open your browser’s developer tools, select **Network** and reload the page. Find the event request to `/api/event` or your proxy’s equivalent and check its response headers. + +If you see `x-plausible-dropped: 1`, your event reached Plausible but was not recorded, even if the response says **202 Accepted**. Check your site’s exclusion rules. If you use a VPN, try temporarily disconnecting it: some VPN IP ranges overlap with data centers and are filtered out. + --- ## Some visitors are not being counted @@ -310,7 +316,7 @@ This same mechanism keeps payment gateways and other redirect domains out of you ## Events API events not appearing -If you are using the [Events API](events-api.md) or a proxy for server-side tracking, Plausible always returns HTTP 202 Accepted, even when an event is not recorded. To check whether an event was actually counted, inspect the response headers for `x-plausible-dropped: 1`. When that header is present, the event was rejected by bot filtering. +If you are using the [Events API](events-api.md) or a proxy for server-side tracking, Plausible can return HTTP 202 Accepted even when an event is not recorded. To check whether an event was dropped, inspect the response headers for `x-plausible-dropped: 1`. When that header is present, the event was not recorded. Bot filtering and site exclusion rules can cause events to be dropped. The most common cause is a misconfigured `X-Forwarded-For` header. If your proxy or backend forwards its own server IP instead of the real visitor's IP, Plausible's bot filter will drop the event. Make sure `X-Forwarded-For` is set to the real client IP before the request reaches Plausible.