Skip to content

Commit 8d1213e

Browse files
Update troubleshoot-integration.md
1 parent 97318a4 commit 8d1213e

1 file changed

Lines changed: 25 additions & 10 deletions

File tree

docs/troubleshoot-integration.md

Lines changed: 25 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ import useBaseUrl from '@docusaurus/useBaseUrl';
66

77
After you've [added the Plausible snippet to your site](plausible-script.md), the dashboard will start displaying the stats in real-time as soon as the first visit is counted. There are no delays with data in Plausible.
88

9-
If you see the dashboard with graphs and numbers, it means everything is working. Congrats! Plausible is now tracking your website statistics while preserving the privacy of your visitors.
9+
If you see the dashboard with graphs and numbers, it means everything is working and we've counted your first visitor. Congrats! Plausible is now tracking your website statistics while preserving the privacy of your visitors.
1010

1111
Do you keep seeing a blinking green dot screen instead of the dashboard? The blinking green dot indicates that we’re listening for incoming visits in real-time but haven't recorded any yet.
1212

@@ -16,14 +16,6 @@ Our testing tool will launch automatically from the blinking green dot screen to
1616

1717
Did our testing tool detect an issue with your integration? Or is there something unusual about the data you're seeing? See how to troubleshoot the most common issues below.
1818

19-
## Verification tool says it's working but my own visit isn't counted
20-
21-
Are you blocking our script from your own device? Or perhaps using a VPN that is blocking scripts? If you are running a browser extension or another service that may be blocking our script, your own visits may not be recorded. Do disable extensions such as adblockers or whitelist our script within the settings of the extension you are using to start counting your own visits too.
22-
23-
Using WordPress and integrated Plausible using our official WordPress plugin? Our plugin excludes logged-in admin visits by default which is why you may not see your own visits being recorded in the dashboard.
24-
25-
But as the verification tool has confirmed, the tracking is working fine overall and is tracking your visitors. If you'd like to track those who use adblockers too, take a look at [our proxy solution](/proxy/introduction.md).
26-
2719
## Have you added the Plausible snippet into your site?
2820

2921
We've put together [many integration guides](integration-guides.md) that cover popular website builders and content management systems (CMS) such as WordPress and Ghost. Thanks to the members of our community, there are also community integrations and plugins for several frameworks such as Hugo and GatsbyJS. These can help you set up and start counting your site visitors in no time.
@@ -56,12 +48,21 @@ To track Google AMP pages with Plausible, you need to declare an AMP-analytics o
5648

5749
## Did you insert multiple Plausible snippets into your site?
5850

59-
This may affect the accuracy of the tracking. Please make sure to only insert one snippet.
51+
This may affect the accuracy of the tracking and can result in the stats being counted twice. Please make sure to only insert one snippet.
6052

6153
## Are you using an older version of our script?
6254

6355
In some cases when you’re using a custom proxy implementation, you may not be using the latest version of our tracking script. This doesn’t necessarily mean that the tracking won’t work but our automated verification tool won’t be able to confirm whether your integration is working correctly. Please update the script you're proxying to the latest version of our script.
6456

57+
If you're using [our WordPress plugin](https://plausible.io/wordpress-analytics-plugin) with the built-in proxy enabled, you'll need to:
58+
59+
1. Disable the proxy
60+
2. Clear your cache
61+
3. Re-enable the proxy
62+
4. Clear your cache again
63+
64+
This ensures the changes are fully applied and the latest version of our script is properly loaded.
65+
6566
## Has some other plugin altered our snippet?
6667

6768
Are you using WP Rocket, SiteGround Optimizer or other performance optimization plugins? Or some type of consent banner plugin that determines which scripts can run when? These plugins may affect our tracking as they try to optimize our script. If you're on WordPress, we recommend you use [our official WordPress plugin](https://plausible.io/wordpress-analytics-plugin) to avoid these issues as we've built-in resolutions to the most common plugin conflicts.
@@ -74,6 +75,20 @@ Are you using Cookiebot or a similar consent management platform? Have you set t
7475

7576
Plausible is built to be privacy-first and compliant with various privacy regulations so do raise this with your legal team as they could provide the green light to not require user consent. See more details in [our data policy](https://plausible.io/data-policy) and in [this legal assessment written by a data protection lawyer](https://plausible.io/blog/legal-assessment-gdpr-eprivacy).
7677

78+
## Is your website on a different URL than the one you added as your site?
79+
80+
Our testing tool visits the exact URL that you added to your Plausible account. For example, if you added `yourdomain.com` as your site, the tool will try to visit `yourdomain.com` directly.
81+
82+
If the URL you added doesn’t work or doesn’t point to your actual website, the tool won’t be able to reach it and can’t verify the integration. In that case, please use [our manual verification process instead](#how-to-manually-check-your-integration).
83+
84+
## Are you blocking our script or using a VPN that blocks us?
85+
86+
Are you blocking our script from your own device? Or perhaps using a VPN that is blocking scripts? If you are running a browser extension or another service that may be blocking our script, your own visits may not be recorded. Do disable extensions such as adblockers or whitelist our script within the settings of the extension you are using to start counting your own visits too.
87+
88+
Using WordPress and integrated Plausible using our official WordPress plugin? Our plugin excludes logged-in admin visits by default which is why you may not see your own visits being recorded in the dashboard.
89+
90+
If the verification tool has confirmed that the tracking is working fine, then you have nothing to worry about. If you'd like to track those who use adblockers too, take a look at [our proxy solution](/proxy/introduction.md).
91+
7792
## I don't see my own referral source
7893

7994
All referral sources are counted only when they start a new session on your site. This is why you don't see all your own referral sources if you for instance click to test several different [UTM tagged links](top-referrers.md) at the same time. Only the first one appears in the "**Top Sources**" report. You would need to start a new session—such as by waiting 30 minutes or using a different device, browser, or IP address, to have the subsequent sources counted too.

0 commit comments

Comments
 (0)