Skip to main content

Overview

The Event Library is like a recipe book for your tracking. Instead of creating the same tracking events over and over, you can save them as templates and reuse them across all your websites and projects.
Think of the Event Library as your company’s tracking standards - ensuring everyone tracks things the same way.

Why use an event library?

Event Library Browser

The problem it solves

Without a library:
  • Each team tracks differently
  • Same events have different names
  • Data doesn’t match across sites
  • Updates are time-consuming
  • Quality varies widely
With a library:
  • Everyone uses the same templates
  • Consistent naming everywhere
  • Data matches perfectly
  • Update once, apply everywhere
  • Proven quality standards

How the library works

Two levels of libraries

Shared across everything
  • Standards for the whole company
  • Core events everyone uses
  • Approved by leadership
  • Managed centrally
Example: All brands use the same “purchase” event template

Creating library templates

What’s in a template?

Each event template includes:
  1. Basic information
    • Event name (like “product_viewed”)
    • Friendly name (like “Product Page View”)
    • Description of when it fires
    • Category (E-commerce, User, Content, etc.)
  2. Required data
    • What information must be collected
    • Rules for each piece of data
    • Examples of correct values
  3. Documentation
    • When to use this event
    • Implementation notes
    • Sample data
    • Common mistakes to avoid

Building your first template

1

Choose an important event

Start with something critical like purchases or signups
2

Define the basics

  • Name it clearly (product_viewed)
  • Describe when it happens
  • Pick a category
3

List required information

What data is essential?
  • Product ID
  • Product name
  • Price
  • Category
4

Add helpful details

  • Examples of good data
  • Common errors to avoid
  • Business purpose
5

Save to library

Choose company-wide or project-specific

Common library templates

E-commerce templates

Shopping events

  • Product viewed
  • Added to cart
  • Checkout started
  • Purchase completed
  • Product reviewed

Browse events

  • Search performed
  • Category viewed
  • Filter applied
  • Sort changed
  • Results clicked

Content templates

Engagement events

  • Article read
  • Video watched
  • Content shared
  • Comment posted
  • Rating given

Navigation events

  • Page viewed
  • Menu clicked
  • Tab switched
  • Section scrolled
  • Link followed

User templates

Account events

  • User registered
  • Login completed
  • Profile updated
  • Password changed
  • Account deleted

Preference events

  • Settings changed
  • Notifications updated
  • Language selected
  • Theme switched
  • Consent given

Using library templates

In your tracking plan

1

Browse the library

See what templates are available
2

Select templates

Choose the ones you need
3

Import to your plan

Add them with one click
4

Customize if needed

Adjust for your specific needs

Benefits of using templates

Saves time
  • No need to reinvent the wheel
  • Proven templates ready to use
  • Faster implementation
Improves quality
  • Best practices built in
  • Common errors avoided
  • Consistent data structure
Easier maintenance
  • Update template once
  • Changes apply everywhere
  • Version tracking included

Managing your library

Organization tips

Group by purpose
  • E-commerce events together
  • User events together
  • Marketing events together
  • Technical events together
Name clearly
  • Use descriptive names
  • Follow naming conventions
  • Include version numbers
  • Add helpful prefixes
Document everything
  • Why this event exists
  • When to use it
  • What data it needs
  • Example implementations

Template lifecycle

1

Draft stage

Template created but not approved
2

Active stage

Approved and ready for use
3

Updated stage

New version available
4

Retired stage

No longer recommended

Best practices

Do’s

Start simple
  • Begin with core events
  • Add complexity gradually
  • Test thoroughly
  • Get feedback
Be consistent
  • Use standard naming
  • Follow the same structure
  • Apply uniformly
  • Document clearly
Think ahead
  • Plan for growth
  • Consider variations
  • Allow flexibility
  • Version properly

Don’ts

Avoid these mistakes
  • Creating too many templates
  • Making them too complex
  • Skipping documentation
  • Not getting buy-in
  • Ignoring feedback

Working with your team

Marketing’s role

  • Define business needs
  • Review template names
  • Approve event purposes
  • Ensure completeness

Developer’s role

  • Implement templates correctly
  • Suggest technical improvements
  • Report implementation issues
  • Maintain consistency

Analytics team’s role

  • Create initial templates
  • Update based on needs
  • Monitor usage
  • Train others

Industry templates

Available starting points

Tag Insight provides pre-built templates for:

Online retail

Standard e-commerce events based on industry best practices

Media sites

Content engagement tracking for publishers

SaaS products

User behavior and feature usage tracking

Lead generation

Form submissions and conversion tracking

Customizing templates

Start with industry templates, then:
  1. Review what’s included
  2. Remove what you don’t need
  3. Add your specific events
  4. Adjust naming to match your style
  5. Test with real scenarios

Common questions

Typically a shared responsibility:
  • Analytics team creates templates
  • Marketing reviews and approves
  • Developers implement
  • All teams provide feedback
Start with 10-20 core events. Most businesses need:
  • 5-10 user events
  • 5-10 commerce events
  • 5-10 content events
  • Some custom events
Yes, but carefully:
  • Version your changes
  • Communicate updates
  • Test thoroughly
  • Update gradually
No. Create templates for:
  • Frequently used events
  • Critical business events
  • Cross-team events Skip one-off or experimental events

Getting started checklist

Before building your library:
  • List your most important events
  • Review current tracking
  • Identify common patterns
  • Get team alignment
  • Plan governance process
  • Start with 5-10 templates
  • Test thoroughly
  • Document everything

Next steps