Comprehensive guide to GA4 event architecture including automatically collected events, enhanced measurement, recommended events, and custom events. Use when understanding GA4 event structure, implementing event tracking, configuring event parameters, working with event scopes (event/user/item), or troubleshooting event collection. Covers event naming conventions, parameter limits (25 parameters, 40 char names), and the four event categories.
/plugin marketplace add henkisdabro/wookstar-claude-code-plugins/plugin install ga-suite@wookstar-claude-code-pluginsThis skill inherits all available tools. When active, it can use any tool Claude has access to.
assets/event-structure-examples.jsreferences/event-naming-conventions.mdreferences/event-parameters-guide.mdreferences/event-types-complete.mdreferences/parameter-scopes.mdGoogle Analytics 4 uses an event-based architecture where every user interaction is tracked as an event. Understanding GA4's event structure, parameter system, and scoping model is fundamental to successful implementation. This skill provides comprehensive guidance on the four event categories, parameter configuration, and best practices for event tracking.
Invoke this skill when:
1. Automatically Collected Events Events that fire without additional configuration once GA4 is installed.
Core automatic events:
session_start - User session beginsfirst_visit - User's first visit to siteuser_engagement - Page in focus for 1+ secondpage_view - Page loads (when enhanced measurement enabled)2. Enhanced Measurement Events Automatically tracked interactions that can be toggled on/off in GA4 settings.
Configurable enhanced measurement events:
scroll - User scrolls to 90% page depthclick - Outbound link clicksfile_download - Downloads of common file typesvideo_start, video_progress, video_complete - YouTube video engagementview_search_results - Site search performedform_start, form_submit - Form interactions3. Recommended Events Google-defined event names with standardized parameters for consistency.
Key recommended events:
login / sign_up - User authenticationpurchase - Ecommerce transaction (most critical)add_to_cart / remove_from_cart - Shopping cart actionsbegin_checkout - Checkout initiatedview_item / view_item_list - Product viewssearch - Site searchgenerate_lead - Lead generation4. Custom Events Business-specific events created for unique tracking needs.
Examples:
video_tutorial_watchedwhitepaper_downloadeddemo_requestedpricing_calculator_usedEvery GA4 event consists of:
Event Scope Applies to single event occurrence. Use for event-specific data. Example: button_name, form_id, video_title
User Scope Applies to all events from that user. Use for user attributes. Example: subscription_tier, customer_segment, loyalty_level
Item Scope Applies to products in ecommerce events. Use for product data. Example: item_color, item_size, supplier_name
Critical constraints:
Best Practices:
Pattern:
[action]_[object]_[context]
Examples:
- video_tutorial_started
- whitepaper_downloaded
- demo_request_submitted
- pricing_calculator_used
Avoid:
value - Monetary value
currency - ISO currency code (USD, EUR, GBP)
transaction_id - Unique transaction identifier
items - Array of product objects (ecommerce)
method - Login/signup method
search_term - User search query
Detailed documentation in references directory:
Code examples available in assets directory:
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.
Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.
Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.