Quick Reference Guide

Advanced https://datalayer-tracker.com/knowledge-base/quick-reference-guide/

Last updated: October 23, 2025 Getting Started Quick Setup

Fast lookup for events, metrics, and implementation priorities

Event Categories at a Glance

Core Events (2)

Event	Fires When	Key Value
`page_view`	Page loads	Foundation – page context
`session_engagement_milestone`	User reaches engagement threshold	Real-time segmentation

Engagement Events (6)

Event	Fires When	Key Metric	Business Use
`scroll_depth`	User scrolls 25%, 50%, 75%, 100%	Scroll %	Content consumption
`scroll_back_up`	User scrolls back up significantly	Scroll delta	Hesitation detection
`time_on_page`	Every 30s	Total seconds	Session duration
`active_time`	Every 30s of activity	Active seconds	TRUE engagement
`focus_blur`	Tab focus changes	Focus state	Multi-tab behavior
`hover_intent`	Hover over CTA 500ms+	Hover duration	Intent signaling

Learn More: Engagement Tracking Guide

Content Intelligence (5) – Premium

Event	Fires When	Insight
`content_intelligence`	Page analysis complete	Auto content type detection
`section_engagement`	User dwells on section 3s+	Section-level heatmap
`last_engaged_section`	User tabs away	Context preservation
`last_content_type_viewed`	Page exit	Content journey tracking
`cta_exposure`	CTA enters viewport	CTA visibility analysis

Form Events (4)

Event	Fires When	Drop-off Analysis
`form_start`	First field focused	Form intent
`form_submit`	Form submitted	Conversion
`form_field_interaction`	Field blur after use	Field-level friction
`field_interaction`	Focus/blur/change	Granular behavior

Video Events (4)

Event	Fires When	Completion Tracking
`video_start`	Video begins	Video engagement start
`video_progress`	0%, 25%, 50%, 75%, 90%, 100%	Drop-off analysis
`video_complete`	100% watched	Quality indicator
`video_pause`	User pauses	Interest/confusion points

E-Commerce Events (7) – Premium

Event	Fires When	Funnel Stage
`view_item`	Product page load	Browse
`view_cart`	Cart page load	Consider
`add_to_cart`	Item added	Intent
`remove_from_cart`	Item removed	Friction
`begin_checkout`	Checkout start	Commit
`checkout_progress`	Each checkout step	Progress
`purchase`	Transaction complete	Conversion

Learn More: E-Commerce Tracking Guide

Session Summary Events (5)

Event	Fires When	Contains
`session_engagement_summary`	Session exit	Engagement metrics, quality score
`session_content_summary`	Session exit	Content type, sections, intent
`session_attribution_summary`	Session exit	UTM, multi-touch attribution
`session_page_summary`	Session exit	Final page context
`session_video_summary`	Session exit	Video metrics, engagement score

Learn More: Session Management Guide

Attribution Events (3) – Premium

Event	Fires When	Attribution Data
`utm_captured`	UTM params detected	Campaign tracking
`utm_restored`	Stored UTM retrieved	Return visitor attribution
`attribution_ping`	During session	Continuous attribution

Consent Events (4)

Event	Fires When	Compliance
`consent_loaded`	CMP loads	CMP readiness
`consent_granted`	Consent given	Track allowed
`consent_revoked`	Consent removed	Track blocked
`consent_change`	Any consent change	Audit trail

Learn More: Consent Management Guide

Critical Metrics Explained

Active Time vs Time on Page

┌─────────────────────────────────────┐
│ TIME ON PAGE                        │
│ ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
│ 10 minutes total                    │
│ (includes background tab time)      │
└─────────────────────────────────────┘

┌─────────────────────────────────────┐
│ ACTIVE TIME                         │
│ ███████████░░░░░░░░░░░░░░░░░░░░░░░░ │
│ 4 minutes active (40% engaged)      │
│ (only when actually interacting)    │
└─────────────────────────────────────┘

Engagement Rate = 40%
Quality Score = Medium

High Quality Session:

Active Time: 280s / Time on Page: 320s = 87.5% engagement
Engaged user, reading content

Low Quality Session:

Active Time: 45s / Time on Page: 600s = 7.5% engagement
Background tab, not actually engaged

Quick Decision Matrix

Which Event Should I Use?

I Want To…	Use This Event	Key Metric
Measure TRUE engagement	`active_time`	Active seconds
Find where users drop off in forms	`form_field_interaction`	Field abandonment rate
See if my video works	`video_progress` → `video_complete`	Completion rate
Understand checkout abandonment	`checkout_progress`	Step-by-step drop-off
Track cross-page metrics	`session_*_summary`	Session-level aggregates
Do multi-touch attribution	`session_attribution_summary`	First & last touch
Find problematic content	`scroll_back_up` + `section_engagement`	Re-read patterns
Measure content quality	`content_intelligence`	Engagement score
Identify hesitation	`hover_intent` + `scroll_back_up`	Hover without click
Build quality audiences	`session_engagement_summary`	Quality score

Event Priority Framework

Must Have (Setup First)

page_view – Foundation
active_time – True engagement
scroll_depth – Content consumption
form_start + form_submit – Conversion funnel
session_engagement_summary – Session quality

High Value (Setup Second)

video_progress (if using video)
session_attribution_summary – Multi-touch attribution
hover_intent – Intent signals
content_intelligence (Premium) – Auto analysis
E-commerce events (if e-commerce)

Advanced (Setup Third)

section_engagement – Granular insights
form_field_interaction – Field-level optimization
scroll_back_up – Hesitation detection
session_video_summary – Video ROI
All remaining events

Reference: Complete Event Guide

Common Analysis Queries

1. Find Your Best Traffic Sources

SELECT 
  utm_source,
  COUNT(*) as sessions,
  AVG(active_time) as avg_active_time,
  AVG(page_quality_score) as avg_quality,
  SUM(conversions) as conversions
FROM session_engagement_summary
GROUP BY utm_source
ORDER BY avg_quality * conversions DESC

2. Form Abandonment Analysis

SELECT 
  form_name,
  COUNT(DISTINCT CASE WHEN event = 'form_start' THEN session_id END) as starts,
  COUNT(DISTINCT CASE WHEN event = 'form_submit' THEN session_id END) as submits,
  ROUND(100.0 * submits / starts, 2) as completion_rate
FROM form_events
GROUP BY form_name
ORDER BY completion_rate ASC

3. Video Performance

SELECT 
  video_title,
  COUNT(DISTINCT session_id) as views,
  AVG(CASE WHEN percent = 100 THEN 1 ELSE 0 END) as completion_rate,
  SUM(conversions) as conversions
FROM video_progress
GROUP BY video_title
ORDER BY conversions DESC

4. Content Type Performance

SELECT 
  content_type,
  AVG(engagement_score) as avg_engagement,
  AVG(active_time) as avg_active_time,
  ROUND(100.0 * SUM(conversions) / COUNT(*), 2) as conversion_rate
FROM content_intelligence
GROUP BY content_type
ORDER BY conversion_rate DESC

5. Session Quality Distribution

SELECT 
  CASE 
    WHEN page_quality_score >= 80 THEN 'High Quality'
    WHEN page_quality_score >= 60 THEN 'Medium Quality'
    WHEN page_quality_score >= 40 THEN 'Low Quality'
    ELSE 'Very Low Quality'
  END as quality_tier,
  COUNT(*) as sessions,
  ROUND(100.0 * COUNT(*) / SUM(COUNT(*)) OVER (), 2) as pct_of_traffic,
  SUM(conversions) as conversions
FROM session_engagement_summary
GROUP BY quality_tier
ORDER BY page_quality_score DESC

Implementation Checklist

Day 1: Foundation

[ ] Install ADT plugin
[ ] Export GTM container
[ ] Import to GTM
[ ] Publish container
[ ] Verify page_view fires
[ ] Enable engagement tracking
[ ] Test active_time event

Get Started: Installation Guide

Week 1: Core Setup

[ ] Enable form tracking
[ ] Enable video tracking
[ ] Enable scroll tracking
[ ] Set up basic GA4 reports
[ ] Test all events in GTM Preview
[ ] Document event naming

Setup Help: GTM Setup Guide

Week 2: Advanced Features

[ ] Enable Session Manager (Premium)
[ ] Mark sections for tracking
[ ] Set up session summaries
[ ] Enable content intelligence
[ ] Configure attribution tracking

Month 1: Analysis & Optimization

[ ] Analyze active_time by source
[ ] Review form abandonment
[ ] Check video completion rates
[ ] Build quality score segments
[ ] Create custom audiences
[ ] Optimize based on insights

Troubleshooting Checklist

Events Not Firing?

[ ] Plugin activated?
[ ] Feature enabled in settings?
[ ] GTM container published?
[ ] Consent granted (if using CMP)?
[ ] Check browser console for errors
[ ] Verify dataLayer: console.log(window.dataLayer)

Troubleshooting: First Successful Event Guide

Session Summaries Not Firing?

[ ] Session Manager enabled? (Premium)
[ ] Tracking scripts always loaded?
[ ] Exit hooks registered?
[ ] Test manually: window.ADTSession.triggerExit('test')

Low Event Volume?

[ ] User must actually interact with page
[ ] Check consent blocking
[ ] Verify feature settings
[ ] Review regex exclusions

ROI Quick Wins

Week 1 Wins (Easy)

1. Identify Bad Traffic Sources

Find sources with active_time < 30s
Stop spending on low-quality traffic
ROI: Immediate cost savings

2. Fix Obvious Form Issues

Check form_start vs form_submit
If <50% completion, urgent fix needed
ROI: Quick conversion lift

Month 1 Wins (Medium)

3. Optimize Checkout Flow

Analyze checkout_progress drop-offs
Fix biggest abandonment point first
ROI: Major revenue impact

4. Content Strategy Pivot

Compare active_time by content_type
Do more of what works
ROI: Better organic rankings

Quarter 1 Wins (Advanced)

5. Multi-Touch Attribution

Build proper attribution model
Reallocate budget to best performers
ROI: 2-4x ROAS improvement

6. Audience Segmentation

Build high-quality score audiences
Target engaged users differently
ROI: Higher conversion rates

Support Resources

Debug Commands

// Check ADT loaded
window.ADTData

// Check session
window.ADTSession?.id()

// View all events
window.dataLayer

// Trigger test exit
window.ADTSession?.triggerExit('manual_test')

// Check event count
window.dataLayer.length

Common Issues & Fixes

Issue	Cause	Fix
No events firing	Plugin not activated	Activate in WP admin
Some events missing	Feature disabled	Enable in settings
Summaries not firing	Scripts not always loaded	Remove conditional loading
Duplicate events	Multiple GTM containers	Use only one container
Performance slow	Too many events	Reduce event frequency

Key Formulas

// Engagement Rate
engagement_rate = (active_time / time_on_page) * 100

// Page Quality Score
page_quality_score = (
  engagement_rate * 0.30 +
  scroll_depth * 0.20 +
  (interactions / 20) * 0.20 +
  (pages_viewed / 5) * 0.15 +
  (form_starts > 0 ? 15 : 0)
)

// Video Engagement Score
video_engagement_score = (
  min(videos_started * 5, 20) +
  completion_rate * 0.40 +
  highest_completion * 0.25 +
  (videos_started > 1 ? min((videos_started - 1) * 5, 15) : 0)
)

// Form Abandonment Rate
form_abandonment = 1 - (form_submits / form_starts)

// Session Quality Classification
if (active_time > 60 && engagement_rate > 70) {
  return 'High Quality'
} else if (active_time > 30 && engagement_rate > 50) {
  return 'Medium Quality'
} else {
  return 'Low Quality'
}

Additional Resources

Documentation

Support

Plugin Settings: /wp-admin/admin.php?page=adt-settings
GTM Export: Settings → GTM Export tab
Debug Mode: Enable in settings (Premium)

Remember: Active Time is your most valuable metric. Start there.

Last Updated: October 22, 2025
Document Version: 2.0 (Professional Edition)

Event Categories at a Glance

Core Events (2)

Engagement Events (6)

Content Intelligence (5) – Premium

Form Events (4)

Video Events (4)

E-Commerce Events (7) – Premium

Session Summary Events (5)

Attribution Events (3) – Premium

Consent Events (4)

Critical Metrics Explained

Active Time vs Time on Page

Quick Decision Matrix

Which Event Should I Use?

Event Priority Framework

Must Have (Setup First)

High Value (Setup Second)

Advanced (Setup Third)

Common Analysis Queries

1. Find Your Best Traffic Sources

2. Form Abandonment Analysis

3. Video Performance

4. Content Type Performance

5. Session Quality Distribution

Implementation Checklist

Day 1: Foundation

Week 1: Core Setup

Week 2: Advanced Features

Month 1: Analysis & Optimization

Troubleshooting Checklist

Events Not Firing?

Session Summaries Not Firing?

Low Event Volume?

ROI Quick Wins

Week 1 Wins (Easy)

Month 1 Wins (Medium)

Quarter 1 Wins (Advanced)

Support Resources

Debug Commands

Common Issues & Fixes

Key Formulas

Additional Resources

Documentation

Support

Related Articles

Advanced DataLayer Tracker

Product

Documentation

Company