Agent skill

google-analytics

Comprehensive Google Analytics 4 guide covering property setup, events, custom events, recommended events, custom dimensions, user tracking, audiences, reporting, BigQuery integration, gtag.js implementation, GTM integration, Measurement Protocol, DebugView, privacy compliance, and data management. Use when working with GA4 implementation, tracking, analysis, or any GA4-related tasks.

Stars 46
Forks 8

Install this agent skill to your Project

npx add-skill https://github.com/henkisdabro/wookstar-claude-plugins/tree/main/plugins/google-analytics/skills/google-analytics

SKILL.md

Google Analytics 4 Complete Guide

Overview

Google Analytics 4 (GA4) is Google's event-based analytics platform for measuring user interactions across websites and applications. Every user interaction is tracked as an event with associated parameters, providing flexible cross-platform measurement.

When to Use This Skill

Invoke this skill for any GA4-related task:

  • Setting up GA4 properties, data streams, and Measurement IDs
  • Installing GA4 via gtag.js, GTM, or CMS plugins
  • Implementing event tracking (automatic, recommended, custom, ecommerce)
  • Creating custom dimensions, audiences, and reports
  • Exporting data to BigQuery for SQL analysis
  • Server-side tracking via Measurement Protocol
  • User ID and cross-device tracking
  • Privacy compliance, Consent Mode, and GDPR/CCPA
  • Testing and debugging with DebugView

Quick Start

  1. Create property: analytics.google.com -> Admin -> Create -> Property
  2. Create data stream: Add web stream, note Measurement ID (G-XXXXXXXXXX)
  3. Install tracking (choose one):
    • GTM (recommended): Install container, create Google Tag with Measurement ID, trigger on All Pages, publish
    • gtag.js direct:
      html
      <script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
      <script>
        window.dataLayer = window.dataLayer || [];
        function gtag(){dataLayer.push(arguments);}
        gtag('js', new Date());
        gtag('config', 'G-XXXXXXXXXX');
      </script>
      
  4. Verify: Enable GA Debugger extension, check Admin -> DebugView for session_start, page_view
  5. Send custom events:
    javascript
    gtag('event', 'button_click', { button_name: 'Subscribe', button_location: 'header' });
    

Decision Tree: Which Reference Do I Need?

What are you trying to do?

Setting up GA4 for the first time?         -> references/setup.md
Understanding how events work?              -> references/events-fundamentals.md
Implementing standard tracking events?      -> references/recommended-events.md
Creating business-specific custom events?   -> references/custom-events.md
Making parameters appear in reports?        -> references/custom-dimensions.md
Implementing User ID / cross-device?        -> references/user-tracking.md
Building audiences for remarketing?         -> references/audiences.md
Analysing data in GA4 reports?              -> references/reporting.md
Exporting to BigQuery for SQL analysis?     -> references/bigquery.md
Installing via gtag.js directly?            -> references/gtag.md
Setting up GA4 in Google Tag Manager?       -> references/gtm-integration.md
Sending events from server/backend?         -> references/measurement-protocol.md
Testing and debugging implementation?       -> references/debugview.md
Implementing GDPR/Consent Mode?             -> references/privacy.md
Configuring Admin settings?                 -> references/data-management.md

Core Concepts

Event-Based Model

GA4 tracks everything as events in four categories:

Category Description Examples
Automatic Fire without configuration session_start, first_visit
Enhanced Measurement Toggle on/off in settings scroll, click, file_download
Recommended Google-defined with standard parameters purchase, login, sign_up
Custom Business-specific tracking demo_requested, trial_started

Key Limits

Limit Value
Event names per property 500 distinct
Parameters per event 25
Event name length 40 characters
Parameter name/value length 40 / 100 characters
Custom dimensions (event/user/item) 50 / 25 / 10
Audiences per property 100

Measurement ID

  • Format: G-XXXXXXXXXX (G- prefix + 10 alphanumeric characters)
  • Location: Admin -> Data Streams -> Web Stream
  • Used in: gtag.js config, GTM tags, Measurement Protocol

Common Workflows

Ecommerce Tracking

  1. Review recommended events for the purchase funnel: view_item -> add_to_cart -> begin_checkout -> purchase
  2. Structure items array (required: item_id OR item_name; recommended: price, quantity, item_category)
  3. Test with DebugView, then register custom item parameters as custom dimensions

Cross-Device Tracking

  1. Implement User ID and configure Reporting Identity (Admin -> Data Settings)
  2. Set user properties and build cross-device audiences

GDPR Compliance

  1. Set up Consent Mode with default denied state
  2. Integrate with CMP (OneTrust, Cookiebot, etc.), update consent on user acceptance
  3. Test consent implementation with DebugView

Custom Reports

  1. Understand available data in reporting
  2. Register custom parameters as dimensions, create Explorations
  3. For unsampled data, export to BigQuery

Best Practices

  • Naming: Use snake_case, be descriptive and action-oriented, keep under 40 characters, avoid generic names
  • Implementation order: Enhanced Measurement -> recommended events -> custom events -> custom dimensions
  • Data quality: Separate test/production properties, set up internal traffic filters from day one, document all custom events, audit regularly with DebugView, export to BigQuery for backup

Expand your agent's capabilities with these related and highly-rated skills.

henkisdabro/wookstar-claude-plugins

tampermonkey

Write Tampermonkey userscripts for browser automation, page modification, and web enhancement. Use when creating browser scripts, writing greasemonkey scripts, automating user interactions, injecting CSS or JavaScript into web pages, modifying website behaviour, building browser extensions, hiding unwanted page elements, adding form auto-fill, scraping website data, intercepting requests, detecting URL changes in SPAs, or storing persistent user preferences. Covers userscript headers (@match, @grant, @require), synchronous and async GM_* API functions, common patterns (DOM mutation, URL change detection, element waiting), security sandboxing, and cross-browser compatibility (Chrome, Firefox, Edge).

46 8
Explore
henkisdabro/wookstar-claude-plugins

pdf-processing-pro

Production-ready PDF processing with forms, tables, OCR, validation, and batch operations. Use when working with complex PDF workflows in production environments, processing large volumes of PDFs, or requiring robust error handling and validation. Do NOT use for simple text extraction - use pdf-extract for quick reads.

46 8
Explore
henkisdabro/wookstar-claude-plugins

docx

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. Use when working with professional documents (.docx files) for creating new documents, modifying or editing content, working with tracked changes, adding comments, or any other document tasks. Do NOT use for creating proposals, letters, or client-facing business documents from scratch - use document-builder for those.

46 8
Explore
henkisdabro/wookstar-claude-plugins

xlsx

Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualisation. Use when working with spreadsheets (.xlsx, .xlsm, .csv, .tsv) for creating new spreadsheets with formulas and formatting, reading or analysing data, modifying existing spreadsheets while preserving formulas, data analysis and visualisation, or recalculating formulas.

46 8
Explore
henkisdabro/wookstar-claude-plugins

prp-generator

Generate comprehensive Product Requirement Plans (PRPs) for feature implementation with thorough codebase analysis and external research. Use when the user requests a PRP, PRD, or detailed implementation plan for a new feature. Conducts systematic research, identifies patterns, and creates executable validation gates for one-pass implementation success. Do NOT use for client discovery, requirements gathering, or scope definition - use scope-clarifier for those.

46 8
Explore
henkisdabro/wookstar-claude-plugins

webapp-testing

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behaviour, capturing browser screenshots, and viewing browser logs. Use when user asks to test a web app, verify UI, capture screenshots, check browser logs, or debug frontend issues.

46 8
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results