Invoker Analytics/Documentation
Support

Troubleshooting Guide

Common issues and solutions to get your analytics working correctly.

Analytics Not Tracking

If your analytics dashboard shows no data, follow these steps to diagnose the issue:

Step 1: Verify Script Installation

Open your website and check if the tracking script is present:

  1. 1. Right-click on your page and select "View Page Source"
  2. 2. Press Ctrl/Cmd + F and search for invoker
  3. 3. You should see the tracking script in the <head> section
Step 2: Check Browser Console

Open Developer Tools (F12) and check for errors:

  • Network tab: Look for requests to api.invoker.app. A 200 status means tracking is working.
  • Console tab: Check for JavaScript errors that might prevent the script from loading.
Step 3: Common Issues

Domain Mismatch

The data-domain attribute must exactly match the domain you registered in Invoker. Check for www vs non-www differences.

Ad Blockers

Some ad blockers may block analytics scripts. Try disabling your ad blocker or testing in incognito mode.

Content Security Policy (CSP)

If your site has a strict CSP, add api.invoker.app to yourscript-src and connect-src directives.

Caching

If you just added the script, clear your browser cache or CDN cache. Some CDNs cache HTML aggressively.

Custom Events Not Recording

If pageviews work but custom events aren't showing up:

  • Check the event name: Event names must be non-empty strings without special characters.
  • Verify the API call: Ensure you're calling invoker('event', 'Event Name')after the script has loaded.
  • Check the console: Look for any JavaScript errors when the event fires.
// Correct event tracking
invoker('event', 'Button Click', {
  variant: 'primary',
  location: 'header'
})

// Wait for script to load if calling immediately
window.invoker = window.invoker || function() {
  (window.invokerQueue = window.invokerQueue || []).push(arguments)
}

Real-time Data Delayed

Real-time analytics updates every 30 seconds. If you're not seeing immediate updates:

  • Wait 30-60 seconds for the dashboard to refresh
  • Try manually refreshing the page
  • Check if you have multiple browser tabs open (each may have different data)

Inaccurate Visitor Counts

Visitor counts may differ from other analytics tools due to:

  • Bot filtering: Invoker automatically filters known bots and crawlers, which other tools may count as visitors.
  • Unique visitor calculation: We use a combination of IP address and user agent for privacy-friendly visitor identification.
  • DNT headers: We respect Do Not Track preferences by default.

Session Duration Shows Zero

Session duration is calculated as the time between the first and last pageview in a session:

  • Single-page visits: If a visitor only views one page and leaves, the session duration will be 0.
  • Long idle times: Sessions expire after 30 minutes of inactivity.

Missing Geographic Data

Location data requires IP geolocation, which may be affected by:

  • VPN or proxy usage by visitors
  • Corporate networks with central exit points
  • Mobile carriers with dynamic IP allocation

Cannot Access Dashboard

Forgot Password

Use the password reset page to receive a reset link via email.

Email Verification

If you haven't verified your email, check your inbox (and spam folder) for the verification email. You can request a new verification email from the login page.

API Errors

Common API error codes and solutions:

401 Unauthorized
Your API key is invalid or expired
Generate a new API key from Settings > API Keys
403 Forbidden
You don't have permission to access this resource
Check that your API key has the required scopes for the endpoint
429 Too Many Requests
Rate limit exceeded
Wait a few minutes before retrying. Implement exponential backoff in your code.
500 Internal Server Error
Something went wrong on our end
Try again later. If the issue persists, contact support.

Still Need Help?