This guide provides steps to troubleshoot tracking methods in the Burst WordPress plugin. The article does not address issues with collected data but rather the methods of tracking data.
Settings excluding your own visits
Make sure your own IP and user role are not blocked otherwise this will not work. These settings can be found in Dashboard > Statistics > Settings > Advanced. If the administrator role is excluded, and you are logged in as administrator, not hits will be tracked. If you have excluded your own ip, this will also block your visits from getting tracked. If only the role exclusion is active, you can bypass it by opening a browser window in private mode (In the browser, select “archive”, “new private window”. This opens a window where you are not logged in as administrator.
Javascript errors on your front-end
Often, there is a javascript error on the front-end of the website. You can check this by going to your website (in private mode, so you’re not logged in as administrator). Then right click on the screen, click “inspect element”, “console”. If you see any errors here, the first thing you should check, is if you have a caching plugin enabled. If so, deactivate to check if this resolves the issue.
If that is the cause, please ensure you don’t minify or combine these two Javascript files:
- burst.min.js (or burst-cookieless.min.js depending on if you have enabled cookieless tracking.)
- timeme.min.js
- burst-goals.min.js (This file only loads when there is a goal set on the current page.)
Be aware: When you have enabled WP_DEBUG the above files become just ‘.js’ instead of .min.js’.
In most caching plugins you can add these two files to an ‘exclusion list’. We recommend checking the documentation of the plugin you are using and look for a way to exclude JS files. Most plugins will clear the cache after changing settings, but make sure to clear all caches after.
Endpoints blocked
Issues arise when both the primary and fallback tracking methods (Endpoint & REST-API) are disabled or when you receive a “Tracking error.” in the Burst Dashboard.
If there is no tracking error, but statistics are not showing up in the dashboard, there is presumably a problem on the ‘front-end’ of your website. Which is most likely caused by a plugin conflict or a caching issue.
Two main tracking methods in Burst
- Endpoint (Primary method)
- REST-API (Fallback method)
Burst selects a method based on your server configuration and provides a notification if there’s a problem.
While tracking with REST-API isn’t problematic and ensures your plugin works correctly, for optimal speed, we recommend using the endpoint method.
What to do in case of a complete tracking failure
If a “Tracking error” surfaces, it signifies that both the Rest API and endpoint are malfunctioning. Start troubleshooting with the endpoint and consider REST-API as a secondary solution.
Endpoint issues & solutions:
- Blocked by security software:
The endpoint might be blocked by mod security, or by a security plugin on your site.
Solution: Allow the endpoint.php in the security settings. .- Ensure that the path wp-content/plugins/burst-pro (or burst-statistics) is in the allow list for your security plugins.
REST-API issues & solutions:
- Pretty permalinks:
If Burst indicates your permalinks aren’t configured properly, adjust them to a setting other than ‘plain’. - Security plugin interference:
Some security plugins restrict the REST-API.
Solution: Temporarily disable your security plugin to see if REST-API works. If successful, identify and disable the specific setting in the security plugin that restricts REST-API usage.
If this doesn’t rectify the issue, contact your hosting provider.
Other causes: Resolving plugin conflicts with WordPress Health Check & Troubleshooting plugin
- Install & activate: First, go to WordPress Plugins Repository and install the “Health Check & Troubleshooting” plugin. Activate it.
- Access the tool: In your WordPress dashboard, go to Tools > Site Health > Troubleshooting.
- Enter troubleshooting mode: Click on the “Enter Troubleshooting Mode” button. This will disable all plugins and use a default theme, but only for you as the logged-in user. Other visitors will see the site as normal.
- Test plugins individually:
– First reactivate Burst Statistics or Burst Pro.
– Reactivate each plugin one by one.
– After each activation, check the site’s functionality to identify which plugin causes the conflict. - Once the problematic plugin is identified, you can:
– Deactivate and delete it.
– Seek an alternative plugin.
– Contact the plugin developer for support. - Exit troubleshooting mode: Once you’ve resolved the conflict, go back to the Site Health > Troubleshooting tab and click “Exit Troubleshooting Mode”.
Conclusion
By configuring your caching plugins correctly, adjusting permissions or adjusting security settings, you can resolve most Bursts’ tracking issues. If problems persist, inspect REST-API settings and consult with your hosting provider. Remember to always keep ‘burst’ and ‘timeme’ excluded from JS cache in other plugins for smooth operation. Is your issue error still not resolved after following these steps? Feel free to open a support ticket, we’re happy to help!
