You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/troubleshoot-integration.md
+25-10Lines changed: 25 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ import useBaseUrl from '@docusaurus/useBaseUrl';
6
6
7
7
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.
8
8
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.
10
10
11
11
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.
12
12
@@ -16,14 +16,6 @@ Our testing tool will launch automatically from the blinking green dot screen to
16
16
17
17
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.
18
18
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
-
27
19
## Have you added the Plausible snippet into your site?
28
20
29
21
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
56
48
57
49
## Did you insert multiple Plausible snippets into your site?
58
50
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.
60
52
61
53
## Are you using an older version of our script?
62
54
63
55
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.
64
56
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
+
65
66
## Has some other plugin altered our snippet?
66
67
67
68
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
74
75
75
76
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).
76
77
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
+
77
92
## I don't see my own referral source
78
93
79
94
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