Skip to main content

​
Overview

When tracking isn’t working correctly, Tag Insight provides simple tools to help you identify and fix issues quickly. This guide shows you how to find problems without needing technical expertise.
Most tracking issues can be identified and fixed in under 15 minutes using Tag Insight’s visual tools.

​
Your debugging toolkit

Live Debugger

See what’s happening on your website in real-time

Chrome Extension

Visual overlay showing tracking on your pages

Audit Reports

Detailed reports of tracking issues found

Data Layer Collector

Historical view of your tracking data

​
Using the Live Debugger

The Live Debugger shows you exactly what tracking data is being collected as you browse your website.

​
Getting started

1

Open Live Debugger

In your Tag Insight dashboard, click Live Debugger from the menu
2

Visit your website

Open your website in a new browser tab
3

Browse normally

Click around your site as a normal visitor would
4

Watch events appear

See tracking events appear in real-time in the debugger

​
Understanding what you see

Each event in the debugger shows:
  • Event name: What action was tracked (e.g., “Product Viewed”)
  • Status icon:
    • ✅ Green = Everything is correct
    • ⚠️ Yellow = Minor issues (like optional data missing)
    • ❌ Red = Critical issues that need fixing
  • Timestamp: When the event happened
  • Details: What data was collected

​
Common issues to look for

If you performed an action but don’t see it in the debugger:
  • The tracking might not be set up for that action
  • There might be a delay (wait 5-10 seconds)
  • Try refreshing the debugger page
These mean required information is missing:
  • Click on the event to see what’s missing
  • Share the error details with your developer
  • Common missing data: transaction IDs, product IDs, prices
These are usually less critical:
  • Optional information is missing
  • Data format might be slightly wrong
  • Can often be fixed later

​
Using the Chrome Extension

The Tag Insight Chrome Extension adds a visual layer to your website showing what’s being tracked.

​
Installation and setup

1

Install the extension

Go to the Chrome Web Store and search for “Tag Insight”
2

Pin the extension

Click the puzzle piece icon in Chrome and pin Tag Insight
3

Visit your website

The extension automatically activates on your tracked sites

​
What the extension shows

  • Green highlights: Elements that are properly tracked
  • Red highlights: Elements that should be tracked but aren’t
  • Event badges: Small labels showing what events fire when clicked
  • Validation status: Real-time checking of your tracking

​
Common tracking problems

​
”I don’t see any events”

1

Check installation

Verify Tag Insight is installed (ask your developer)
2

Check the right project

Make sure you’re looking at the correct Tag Insight project
3

Clear browser cache

Sometimes old code gets stuck - clear cache and try again
4

Try a different browser

Test in Chrome, Firefox, or Safari to rule out browser issues

​
”Events show errors”

When you see red errors in the debugger:
  1. Click on the event to see error details
  2. Take a screenshot of the error information
  3. Note what you were doing when the error occurred
  4. Share with your developer or Tag Insight support

​
”Some pages aren’t tracked”

This usually means:
  • Tag Insight isn’t installed on those pages
  • The pages use a different tracking setup
  • There’s a technical issue preventing tracking
Solution: Share the list of untracked pages with your technical team.

​
Creating useful bug reports

When you find an issue, help your team fix it faster by providing:

Bug Report Template

What happened: Describe the issue in simple termsWhen it happened: Date, time, and what page you were onWhat you expected: What should have happened insteadSteps to reproduce:
  1. Go to [specific page]
  2. Click on [specific button]
  3. Fill in [specific information]
  4. See error
Screenshots: Include screenshots from the debuggerBrowser details: Chrome, Safari, Firefox, etc.

​
Working with your technical team

​
Information they need

When reporting issues to developers, include:
  • Screenshot of the Live Debugger showing the error
  • The exact URL where the problem occurs
  • What you clicked or did before the error
  • Any error messages you see

​
Questions to ask

  • “Is Tag Insight installed on all our pages?”
  • “Are we tracking all the events in our tracking plan?”
  • “When was tracking last working correctly?”
  • “Have there been recent website changes?”

​
Quick fixes you can try

Some issues can be resolved without technical help:
Settings → Privacy → Clear browsing data → Cached images and files
Ad blockers or privacy extensions can interfere with tracking
This rules out issues with your browser profile
Slow connections can cause timeouts

​
Getting help

If you can’t resolve an issue:
  1. Check the FAQ - Common issues and solutions
  2. Contact support - [email protected]
  3. Schedule a demo - Get personalized help
  4. Ask your implementation partner - They know your specific setup

​
Best practices

​
Regular checks

  • Weekly: Spend 10 minutes in the Live Debugger
  • After website updates: Always verify tracking still works
  • When issues are reported: Check immediately

​
Document issues

  • Keep a log of recurring problems
  • Note when issues started
  • Track which issues are resolved

​
Team communication

  • Share debugging findings with your team
  • Create a shared document for tracking issues
  • Schedule regular reviews with your developer

​
Next steps

Common Issues

Solutions to frequent tracking problems

Chrome Extension

Learn more about the visual debugging tool

Live Debugger

Master real-time debugging

FAQ

Quick answers to common questions