Resolve browser-specific issues with the Zenovay dashboard and tracking script.
Supported Browsers
Dashboard (app.zenovay.com)
| Browser | Minimum Version | Notes |
|---|---|---|
| Chrome | 90+ | Recommended |
| Firefox | 88+ | Full support |
| Safari | 14+ | Full support |
| Edge | 90+ | Full support |
| Opera | 76+ | Full support |
Tracking Script
| Browser | Minimum Version | Notes |
|---|---|---|
| Chrome | 60+ | Full support |
| Firefox | 55+ | Full support |
| Safari | 11+ | Full support |
| Edge | 79+ | Full support |
| IE | 11 | Basic support only |
Chrome Issues
Dashboard Not Loading
Clear cache:
- Press
Ctrl+Shift+Delete(Windows) orCmd+Shift+Delete(Mac) - Select "All time"
- Check "Cached images and files"
- Click "Clear data"
Disable extensions:
- Open
chrome://extensions - Disable all extensions
- Reload dashboard
- Re-enable one by one to find culprit
Common Extension Conflicts
- Ad blockers: May block API calls
- Privacy Badger: Can block tracking script
- uBlock Origin: May need whitelist
- Dark Reader: Can affect charts
Whitelist Zenovay:
*.zenovay.com
Memory Issues
If Chrome becomes slow:
- Close other tabs
- Clear browsing data
- Disable unused extensions
- Check
chrome://memory-internals
Firefox Issues
WebGL Not Working (3D Globe)
Enable WebGL:
- Type
about:configin address bar - Search for
webgl.disabled - Set to
false - Restart Firefox
Check WebGL support:
- Visit
about:support - Look for "WebGL 1 Driver Renderer"
- Should show your graphics card
Tracking Prevention
Firefox Enhanced Tracking Protection may block:
Standard mode: Usually works Strict mode: May block
Allow Zenovay:
- Click shield icon in address bar
- Click "Protection Settings"
- Add exception for zenovay.com
Cookie Issues
If sessions not persisting:
- Settings → Privacy & Security
- Check "Delete cookies when Firefox closes"
- Add exception for zenovay.com
Safari Issues
Intelligent Tracking Prevention (ITP)
Safari aggressively limits tracking:
- 7-day cookie expiry for cross-site
- 24-hour expiry for script-set cookies
Impact:
- Returning visitors may appear as new
- Use first-party tracking mode
First-party setup:
<script
defer
src="https://analytics.yourdomain.com/z.js"
data-tracking-code="YOUR_TRACKING_CODE">
</script>
Private Relay (iCloud+)
iCloud Private Relay hides IP addresses:
- Geographic data may be approximate
- IP-based visitor identification affected
- Cannot be bypassed
Cross-Site Tracking Blocks
If dashboard can't connect:
- Safari → Settings → Privacy
- Uncheck "Prevent cross-site tracking"
- Or add exception for zenovay.com
WebGL in Safari
Safari WebGL limitations:
- Check System Preferences → Battery
- Disable "Automatic graphics switching" temporarily
- Or use Chrome for 3D Globe
Edge Issues
Legacy Edge vs Chromium Edge
Chromium Edge (current): Full support Legacy Edge (pre-2020): Limited support - please update
Check version:
- Settings → About Microsoft Edge
- Should be version 90+
SmartScreen Blocking
If Edge blocks Zenovay:
- Click "More info"
- Click "Run anyway"
- Or add to trusted sites
IE Mode
IE Mode in Edge has limited support:
- Dashboard may not work
- Tracking script has basic support
- Use modern Edge mode instead
Mobile Browsers
iOS Safari
Limitations:
- Same ITP restrictions as desktop
- WebGL may have issues on older devices
- Use Safari 14+
If app not loading:
- Settings → Safari
- Clear History and Website Data
- Disable "Prevent Cross-Site Tracking" if needed
Chrome Mobile
Full support on:
- Android 8+
- Chrome 90+
If issues:
- Chrome → Settings → Privacy
- Check "Preload pages" is enabled
- Clear browsing data
Samsung Internet
Limited testing:
- Generally works
- May have minor styling issues
- Use Chrome for best experience
WebGL/3D Globe
Requirements
The 3D Globe requires:
- WebGL 2.0 support
- Hardware acceleration enabled
- Adequate GPU memory
Check WebGL Support
Visit: get.webgl.org
- "Your browser supports WebGL" = OK
- If error, see fixes below
Enable Hardware Acceleration
Chrome:
- Settings → System
- Enable "Use hardware acceleration when available"
- Restart browser
Firefox:
- Settings → General → Performance
- Uncheck "Use recommended performance settings"
- Check "Use hardware acceleration when available"
Edge:
- Settings → System
- Enable "Use hardware acceleration when available"
Fallback Mode
If WebGL unavailable:
- Globe shows 2D map instead
- Or text "WebGL not supported"
- Core analytics still work
JavaScript Errors
Console Errors
Check browser console:
- Press
F12or right-click → Inspect - Click "Console" tab
- Look for red errors
Common errors:
| Error | Meaning | Fix |
|---|---|---|
Script blocked | Ad blocker | Whitelist |
CORS error | Cross-origin issue | Check domain config |
Timeout | Network issue | Check connection |
Script Not Loading
Verify script loads:
- Open Network tab (F12)
- Filter by "JS"
- Look for
z.jsfrom Zenovay - Check status is 200
Cookie/Storage Issues
Third-Party Cookies Blocked
Modern browsers block third-party cookies:
Solutions:
- Use first-party tracking (recommended)
- User grants exception
- Use cookieless mode
localStorage Blocked
Private browsing blocks storage:
- Sessions won't persist
- This is expected behavior
- Tracking still works for that session
Clear Site Data
Chrome:
- F12 → Application tab
- Left panel: Storage
- Click "Clear site data"
Firefox:
- F12 → Storage tab
- Right-click → Delete All
Performance Issues
Dashboard Slow
Check:
- Close other tabs
- Disable extensions
- Use Chrome (fastest)
- Check internet speed
Reduce load:
- Use smaller date ranges
- Disable real-time if not needed
- Use table view instead of globe
Script Affecting Site Speed
Zenovay script is optimized but:
- Loads async (non-blocking)
- ~5KB gzipped
- No impact on Core Web Vitals
If concerned:
<!-- Defer loading -->
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="...">
</script>
Testing Compatibility
Cross-Browser Testing
- Test in your target browsers
- Check major features work
- Verify tracking fires
BrowserStack/LambdaTest
For comprehensive testing:
- Test on real devices
- Check mobile browsers
- Verify tracking across browsers
Reporting Issues
If browser issue persists:
-
Browser details:
- Name and version
- Operating system
- Extensions installed
-
Issue details:
- What doesn't work
- Console errors
- Screenshots
-
Steps to reproduce:
- What you clicked
- What happened
- What you expected