Troubleshooting

Solutions to common issues with Ghost Metrics.

No Data Appearing

The most common issue — your dashboard shows no visitors or data.

Step 1: Verify Tracking Code Installation

Check that the tracking code is on your website:

1. Open your website in a browser
2. Right-click → View Page Source
3. Press Ctrl+F (or Cmd+F on Mac)
4. Search for ghostmetrics or _mtm
5. Confirm the tracking code is present

If tracking code is missing:

• Re-install following Installation Guide
• Check if code was added to the correct template/location
• Verify changes were published (especially for CMS platforms)

Step 2: Check for JavaScript Errors

1. Open your website
2. Press F12 to open Developer Tools
3. Go to the Console tab
4. Look for red error messages related to tracking

Common errors:

• Script blocked by Content Security Policy → Update CSP settings
• Script not found (404) → Check tracking code URL
• JavaScript errors in your site code → May prevent tracking from loading

Step 3: Verify Network Requests

1. Open Developer Tools (F12)
2. Go to the Network tab
3. Refresh your page
4. Filter by typing container_ or your Ghost Metrics domain
5. Check for successful requests (status 200)

If requests are blocked or failing:

• Check for ad blockers (disable temporarily to test)
• Verify firewall isn’t blocking requests
• Check Content Security Policy settings

Step 4: Test in Incognito Mode

Browser extensions and cached data can interfere:

1. Open an incognito/private browser window
2. Visit your website
3. Check Ghost Metrics Real-time report
4. You should see your visit within seconds

Step 5: Clear Caching

If your site uses caching:

1. Clear your caching plugin’s cache
2. Clear CDN cache (Cloudflare, etc.)
3. Wait a few minutes
4. Test again in incognito mode

Data Discrepancies

Your Ghost Metrics numbers don’t match other tools or expectations.

Ghost Metrics vs Google Analytics

Numbers will differ due to:

• Different tracking methods — Each platform counts differently
• Ad blockers — May block one platform but not another
• Bot filtering — Different approaches to filtering bot traffic
• Sampling — GA4 samples data; Ghost Metrics doesn’t
• Session definitions — Slightly different timeout rules

A 10-20% difference is normal between any two analytics platforms.

Sudden Traffic Drops

If traffic suddenly decreased:

1. Check tracking code — Was it accidentally removed?
2. Website changes — Did a redesign or update affect tracking?
3. Caching changes — New caching might be interfering
4. Actual traffic change — Sometimes traffic legitimately drops

Sudden Traffic Spikes

If traffic suddenly increased:

1. Bot traffic — Check visitor details for suspicious patterns
2. New campaign — Expected traffic from marketing?
3. Viral content — Content shared widely?
4. Referral spam — Check referrer report for suspicious sources

Missing Recent Data

If very recent data isn’t appearing:

1. Real-time data should appear within seconds
2. Some reports may take a few minutes to update
3. Check if your date range includes today
4. Verify timezone settings

Tracking Issues

Events Not Recording

If custom events aren’t appearing:

1. Verify event code — Check syntax is correct
2. Check trigger — Is the event trigger firing?
3. Console logging — Add console.log() to verify code runs
4. Tag Manager — If using TM, check tag is firing

Test event tracking:

// Add this temporarily to verify events work
_mtm.push({
  'event': 'trackEvent',
  'eventCategory': 'Test',
  'eventAction': 'Test Action',
  'eventName': 'Test Name'
});
console.log('Event sent');

Goals Not Converting

If goals aren’t recording conversions:

1. Verify goal setup — Check configuration in Goals → Manage
2. Test the trigger — Manually trigger the goal condition
3. Check URL matching — For page-based goals, verify URL patterns
4. Event matching — For event-based goals, verify event fires correctly

Campaign Parameters Not Showing

If UTM parameters aren’t appearing in reports:

1. Verify URL format — Parameters must be properly formatted
2. Check for redirects — Redirects may strip parameters
3. Form submissions — Some forms strip URL parameters
4. Case sensitivity — utm_source vs UTM_SOURCE matters

Feature-Specific Issues

Heatmaps Not Loading

If heatmaps won’t display:

1. Sufficient data — Need enough visits to generate heatmap
2. Page changes — If page changed significantly, heatmap may not overlay correctly
3. Dynamic content — Some dynamic elements may not capture correctly
4. JavaScript errors — Check console for errors

Session Recordings Missing

If recordings aren’t appearing:

1. Feature enabled — Verify recordings are enabled for the website
2. Sample rate — If sampling is set, not all sessions record
3. Page exclusions — Check if the page is excluded from recording
4. Session length — Very short sessions may not record
5. Plan level — Verify your plan includes Session Recordings

Form Analytics Empty

If form data isn’t appearing:

1. Form detection — Some custom forms may not auto-detect
2. Sufficient data — Need form interactions to show data
3. Form changes — Major form changes may affect tracking
4. Feature enabled — Verify Form Analytics is enabled

Performance Issues

Dashboard Loading Slowly

If the dashboard is slow:

1. Date range — Shorter date ranges load faster
2. Browser — Try a different browser
3. Internet connection — Test your connection speed
4. Clear browser cache — May help with loading issues

Reports Timing Out

If reports take too long or time out:

1. Reduce date range — Shorter periods process faster
2. Simplify segments — Complex segments take longer
3. Try later — Server load varies throughout the day
4. Contact support — May indicate a larger issue

Access Issues

Can’t Log In

If you can’t access your account:

1. Verify credentials — Check username and password
2. Password reset — Use “Forgot password” link
3. Account status — Contact your admin to verify account is active
4. Browser issues — Try incognito mode or different browser
5. Bookmarks — Ensure you’re using the correct URL

Can’t See a Website

If a website is missing from your list:

1. Permissions — You may not have access to that website
2. Contact admin — Request access if needed
3. Correct account — Verify you’re logged into the right account

Can’t Edit Settings

If you can’t modify configurations:

1. Role level — View role cannot edit anything
2. Website permissions — You may not have edit access to this website
3. Feature access — Some features require higher plan levels

Getting More Help

Before Contacting Support

Gather this information:

1. Screenshot of the issue
2. Browser and version you’re using
3. Steps to reproduce the problem
4. When it started happening
5. What you’ve already tried
6. Any error messages (exact text)

When to Contact Support

Contact support when:

• You’ve tried troubleshooting steps without success
• You see error messages you don’t understand
• You need configuration help
• You suspect a system issue

How to Contact Support

See Contact Support for:

• Support hours
• Response time expectations
• Contact methods

Common Error Messages

”No data available for this date range”

• Date range may be before tracking was installed
• Website may not be receiving traffic
• Tracking may not be properly configured

”You don’t have permission to access this”

• Your user role doesn’t allow this action
• Contact your admin for appropriate permissions

”Report could not be generated”

• Try a shorter date range
• Wait and try again
• Contact support if persistent

Quick Fixes Checklist

Try these common fixes first:

• Clear browser cache
• Test in incognito mode
• Disable ad blocker temporarily
• Verify tracking code in page source
• Check for JavaScript console errors
• Verify correct date range selected
• Confirm timezone settings
• Try a different browser