> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taginsight.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Tag Manager setup

> How to set up Tag Insight with Google Tag Manager

## Overview

Google Tag Manager (GTM) is the most popular way to manage tracking on websites. If your website uses GTM, setting up Tag Insight is straightforward - your technical team just needs to add one tag.

## What you'll need

Before starting, make sure you have:

* ✅ Someone with access to your Google Tag Manager account
* ✅ Your Tag Insight Project ID (found in your dashboard)
* ✅ About 15 minutes for setup

<Note>
  Don't have GTM access? Ask your web developer or digital marketing team - they'll have it!
</Note>

## Setup process

### Step 1: Access Google Tag Manager

<img src="https://mintcdn.com/taginsight/poFMsZzsIjoQTyP7/images/16_1_gtm_integration_step1@2x.png?fit=max&auto=format&n=poFMsZzsIjoQTyP7&q=85&s=8046a9f39c1e2b0043856abeb3c5e364" alt="Google Tag Manager Interface" style={{borderRadius: "8px", margin: "20px 0"}} width="2854" height="1546" data-path="images/16_1_gtm_integration_step1@2x.png" />

Your technical team member should:

<Steps>
  <Step title="Log into GTM">
    Go to tagmanager.google.com and sign in
  </Step>

  <Step title="Select your container">
    Choose the container for your website
  </Step>

  <Step title="Navigate to Tags">
    Click "Tags" in the left menu
  </Step>

  <Step title="Create new tag">
    Click "New" to create a tag for Tag Insight
  </Step>
</Steps>

### Step 2: Configure Tag Insight

<img src="https://mintcdn.com/taginsight/poFMsZzsIjoQTyP7/images/16_2_gtm_integration_step2@2x.png?fit=max&auto=format&n=poFMsZzsIjoQTyP7&q=85&s=13fa51b399c023b6573f4d40a7ef2ac7" alt="Tag Configuration" style={{borderRadius: "8px", margin: "20px 0"}} width="2860" height="1692" data-path="images/16_2_gtm_integration_step2@2x.png" />

Your developer will:

1. Name the tag "Tag Insight - Monitoring"
2. Choose "Custom HTML" as the tag type
3. Add the Tag Insight code (they can get this from our support team)
4. Replace YOUR\_PROJECT\_ID with your actual project ID

<Warning>
  Make sure to use your specific Project ID from the Tag Insight dashboard - each project has a unique ID.
</Warning>

### Step 3: Set where it runs

<img src="https://mintcdn.com/taginsight/poFMsZzsIjoQTyP7/images/16_3_gtm_integration@2x.png?fit=max&auto=format&n=poFMsZzsIjoQTyP7&q=85&s=2430bf8fcd7bdbe27196ddf53878b617" alt="Trigger Setup" style={{borderRadius: "8px", margin: "20px 0"}} width="2862" height="1698" data-path="images/16_3_gtm_integration@2x.png" />

Choose when Tag Insight should run:

<Tabs>
  <Tab title="All pages (Recommended)">
    **Best for most websites**

    * Tracks everything automatically
    * No pages missed
    * Easiest to maintain
  </Tab>

  <Tab title="Specific pages only">
    **If you only want to track certain sections**

    * Just product pages
    * Only checkout process
    * Excluding admin areas
  </Tab>

  <Tab title="Single-page applications">
    **For modern web apps**

    * React, Vue, Angular sites
    * Dynamic content
    * No page reloads
  </Tab>
</Tabs>

### Step 4: Test before going live

<Steps>
  <Step title="Preview mode">
    Your developer will test using GTM's Preview mode
  </Step>

  <Step title="Browse your site">
    They'll click around to ensure tracking works
  </Step>

  <Step title="Check Tag Assistant">
    GTM shows which tags are firing correctly
  </Step>

  <Step title="Verify in Tag Insight">
    You can check the Live Debugger to see data flowing
  </Step>
</Steps>

## Different setups

### Multiple environments

If you have staging and production sites:

* Create separate Tag Insight projects for each
* Your developer will configure GTM to use the right project ID
* This keeps test data separate from real data

### E-commerce websites

For online stores:

* Tag Insight automatically works with standard e-commerce tracking
* No special configuration needed
* Compatible with Google Analytics 4 e-commerce

### Multiple websites

Managing several sites? You can:

* Use one GTM container for all sites
* Create separate Tag Insight projects for each
* Or combine them into one project (ask support for guidance)

## Working with your team

### For marketing managers

Share this guide with your developer and ask them to:

1. Install Tag Insight in GTM
2. Test it's working properly
3. Publish the changes
4. Confirm when it's live

### Questions to ask your developer

* "Is Tag Insight installed on all our pages?"
* "Did you test it in Preview mode?"
* "When will it be published to the live site?"
* "Are staging and production using different project IDs?"

### What happens after installation

Once installed, you'll see:

* Data appearing in your Tag Insight dashboard within minutes
* The Live Debugger showing real-time activity
* Audit reports starting to generate

## Common questions

<AccordionGroup>
  <Accordion title="Do I need to know how to use GTM?">
    No, your technical team handles GTM. You just need to provide them with your Tag Insight Project ID and this guide.
  </Accordion>

  <Accordion title="Will this affect my other tags?">
    No, Tag Insight works alongside your existing tags (Google Analytics, Facebook Pixel, etc.) without interference.
  </Accordion>

  <Accordion title="How do I know it's working?">
    Check your Tag Insight Live Debugger - you should see events appearing as people browse your site.
  </Accordion>

  <Accordion title="What if we don't use GTM?">
    No problem! Tag Insight can be installed directly on your website or through other tag managers like Commander Act.
  </Accordion>
</AccordionGroup>

## Best practices

<CardGroup cols={2}>
  <Card title="Test first" icon="flask">
    Always test in staging before going live
  </Card>

  <Card title="Document setup" icon="book">
    Keep notes about your configuration
  </Card>

  <Card title="Regular checks" icon="check-circle">
    Verify tracking after website updates
  </Card>

  <Card title="Team communication" icon="users">
    Keep marketing and tech teams aligned
  </Card>
</CardGroup>

## Troubleshooting

If tracking isn't working:

<AccordionGroup>
  <Accordion title="No data in dashboard">
    * Check the tag is published in GTM (not just saved)
    * Verify you're using the correct Project ID
    * Wait 5 minutes and refresh
    * Contact support if issues persist
  </Accordion>

  <Accordion title="Data missing from some pages">
    * The GTM container might not be on all pages
    * Check if triggers are excluding certain pages
    * Some pages might load differently (like checkout)
  </Accordion>

  <Accordion title="Seeing test data in production">
    * Make sure staging uses a different Project ID
    * Check GTM isn't published to the wrong environment
    * Use Tag Insight's environment features
  </Accordion>
</AccordionGroup>

## Getting help

Need assistance with GTM setup?

1. **Check our FAQ** - Common setup questions answered
2. **Contact support** - [support@taginsight.com](mailto:support@taginsight.com)
3. **Book a demo** - Get guided setup help
4. **Ask your GTM consultant** - They're familiar with tag installation

## Next steps

<CardGroup cols={2}>
  <Card title="View Live Data" icon="chart-line" href="/tools/live-debugger">
    See your tracking in real-time
  </Card>

  <Card title="Import Tracking Plan" icon="file-import" href="/tracking-plans/import-methods">
    Set up what you want to track
  </Card>

  <Card title="Configure Alerts" icon="bell" href="/monitoring/alerts">
    Get notified of tracking issues
  </Card>

  <Card title="Install Extension" icon="chrome" href="/tools/chrome-extension">
    Debug tracking visually
  </Card>
</CardGroup>