Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/bot-traffic-filtering.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
2 changes: 2 additions & 0 deletions docs/raw-data-export.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
10 changes: 8 additions & 2 deletions docs/troubleshoot-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -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."
}
},
{
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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.

Expand Down
Loading