FAQ & troubleshooting
My visits don't show up
Add data-debug="true" to the script tag and open the browser console: the tracker logs every event it sends or skips, with the reason. The most common ones:
| Console message | Fix |
|---|---|
missing data-website-id | Copy the snippet again from Website settings → General. |
localhost | Add data-allow-localhost="true" while testing locally. |
dataeasy_ignore flag | Run localStorage.removeItem("dataeasy_ignore"). |
bot detected | Automated browsers (Puppeteer, Playwright, Lighthouse…) are never tracked. |
If events are sent but don't appear, check that the page's hostname matches your website domain (or one of its additional domains), and that it isn't covered by an exclusion rule.
Content-Security-Policy
If your site sends a CSP header, allow the script and the events endpoint:
script-src 'self' https://dataeasy.app; connect-src 'self' https://dataeasy.app;
When you proxy DataEasy through your own domain, 'self' is enough.
Ad blockers
Privacy extensions (uBlock Origin, Brave Shields…) may block third-party analytics. You'll typically lose a share of visitors on developer-heavy audiences. Serving the script from your own domain with a proxy fixes most cases.
Revenue isn't attributed
- Make sure
dataeasy_visitor_idis present in the payment metadata (check the payment in your provider dashboard). - The cookie is only readable on the same root domain: set
data-domainif your checkout runs on a subdomain. - Check the webhook delivery logs in your provider: DataEasy returns 400 for an invalid signature.
Do I need a cookie banner?
The default script sets first-party cookies to recognise returning visitors and attribute revenue. Under GDPR and ePrivacy rules this may require consent depending on your visitors' location and your legal basis. Read our data processing agreement and ask your counsel if unsure.
Can I import data from another tool?
Website settings → Import lists the sources currently supported. Imports for Google Analytics, Plausible and Umami are being rolled out progressively.
Still stuck?
Email us at ravasini.aziendale@gmail.com with your website domain and what the debug console shows.