14 KiB
14 KiB
GA4 Custom Events: Industry-Specific Patterns
Complete Industry Event Catalogs
SaaS (Software as a Service)
Core SaaS Events
Free Trial & Conversion:
// User initiates free trial
gtag('event', 'trial_start', {
'trial_plan': 'professional',
'trial_days': 30,
'utm_source': 'landing_page',
'utm_medium': 'organic'
});
// User converts trial to paid
gtag('event', 'trial_conversion', {
'trial_plan': 'professional',
'paid_plan': 'professional_annual',
'trial_duration_days': 28,
'feature_used': 'advanced_reporting',
'conversion_value': 999
});
// User lets trial expire
gtag('event', 'trial_expired', {
'trial_plan': 'professional',
'trial_days_used': 15,
'reason_not_converted': 'price_too_high'
});
Feature Adoption & Usage:
// User discovers premium feature
gtag('event', 'feature_discover', {
'feature_name': 'team_collaboration',
'feature_category': 'premium',
'discovery_source': 'help_article'
});
// User activates premium feature
gtag('event', 'feature_enable', {
'feature_name': 'team_collaboration',
'feature_category': 'premium',
'current_plan': 'professional'
});
// User first uses premium feature
gtag('event', 'feature_first_use', {
'feature_name': 'team_collaboration',
'success': true,
'time_to_first_use_hours': 3
});
Account & Subscription Management:
// User upgrades subscription
gtag('event', 'subscription_upgrade', {
'from_plan': 'starter',
'to_plan': 'professional',
'upgrade_value': 50,
'reason': 'more_users_needed'
});
// User downgrades subscription
gtag('event', 'subscription_downgrade', {
'from_plan': 'professional',
'to_plan': 'starter',
'refund_amount': 50,
'reason': 'reduced_usage'
});
// User pauses/cancels subscription
gtag('event', 'subscription_cancel', {
'plan': 'professional',
'tenure_months': 12,
'reason': 'switching_competitor'
});
// User adds team member/seat
gtag('event', 'seat_add', {
'current_seats': 5,
'new_seats': 6,
'cost_per_seat': 10
});
Engagement & Activation:
// User invites teammate
gtag('event', 'team_invite_send', {
'invitees_count': 2,
'email_domains': 'acme.com',
'invite_source': 'onboarding'
});
// User completes onboarding
gtag('event', 'onboarding_complete', {
'onboarding_duration_minutes': 45,
'steps_completed': 8,
'data_imported': true
});
// User creates first report
gtag('event', 'first_report_created', {
'report_type': 'marketing_dashboard',
'days_to_first_report': 2
});
Integration & Extensions:
// User connects third-party integration
gtag('event', 'integration_connect', {
'integration_name': 'slack',
'integration_category': 'communication',
'reason': 'team_notifications'
});
// User uses API
gtag('event', 'api_first_call', {
'api_endpoint': 'reports_v4',
'api_auth_type': 'oauth',
'user_type': 'developer'
});
Support & Feedback:
// User opens support ticket
gtag('event', 'support_ticket_open', {
'ticket_category': 'billing',
'severity': 'medium',
'user_plan': 'professional'
});
// User submits feature request
gtag('event', 'feature_request_submit', {
'requested_feature': 'custom_branding',
'use_case': 'white_label_solution'
});
SaaS Event User Properties
Set these user-level properties:
gtag('set', {
'subscription_plan': 'professional',
'subscription_status': 'active',
'monthly_recurring_revenue': 99,
'subscription_created_date': '2023-11-10',
'user_role': 'admin',
'company_size': 'mid-market',
'use_case': 'marketing_analytics',
'feature_tier': 'professional',
'integration_count': 3,
'onboarding_complete': true
});
E-commerce / Retail
Product Discovery Events
// User performs product search
gtag('event', 'product_search', {
'search_term': 'running shoes',
'search_results_count': 45,
'filters_applied': ['size', 'brand', 'price']
});
// User applies product filter
gtag('event', 'product_filter_apply', {
'filter_type': 'price',
'filter_value': '50-100',
'filtered_results_count': 12
});
// User views product list
gtag('event', 'product_list_view', {
'list_name': 'summer_sale',
'list_category': 'apparel',
'products_visible': 20
});
// User reads product review
gtag('event', 'product_review_view', {
'product_id': 'SHOE_001',
'review_rating': 4,
'review_helpful_count': 15,
'reviewer_verified_buyer': true
});
// User submits product review
gtag('event', 'product_review_submit', {
'product_id': 'SHOE_001',
'review_rating': 5,
'review_length': 250,
'includes_photo': true
});
Purchase Journey Events
// User views shopping cart
gtag('event', 'cart_view', {
'items_count': 3,
'cart_value': 150,
'last_modified_minutes_ago': 5
});
// User updates cart
gtag('event', 'cart_update', {
'action': 'quantity_increase',
'product_id': 'SHOE_001',
'quantity_before': 1,
'quantity_after': 2
});
// User starts checkout
gtag('event', 'checkout_start', {
'items_count': 2,
'cart_value': 99.98,
'estimated_shipping': 10,
'coupon_applied': false
});
// User selects shipping method
gtag('event', 'shipping_select', {
'shipping_method': 'express',
'shipping_cost': 25,
'delivery_days': 2
});
// User enters payment information
gtag('event', 'payment_info_enter', {
'payment_method': 'credit_card',
'billing_same_as_shipping': true,
'save_payment_method': true
});
// User completes purchase
gtag('event', 'purchase', {
'transaction_id': 'TXN_12345',
'value': 134.98,
'currency': 'USD',
'tax': 10.00,
'shipping': 10.00,
'coupon': 'SAVE10',
'items': [
{
'item_id': 'SHOE_001',
'item_name': 'Running Shoe Pro',
'item_category': 'Apparel/Shoes',
'item_brand': 'SportBrand',
'item_variant': 'Blue/Size 10',
'price': 119.99,
'quantity': 1
}
]
});
Post-Purchase Events
// User initiates return
gtag('event', 'return_initiate', {
'transaction_id': 'TXN_12345',
'return_item_count': 1,
'return_reason': 'wrong_size'
});
// User requests refund
gtag('event', 'refund_request', {
'transaction_id': 'TXN_12345',
'refund_amount': 119.99,
'refund_reason': 'product_quality'
});
// User views order tracking
gtag('event', 'order_tracking_view', {
'transaction_id': 'TXN_12345',
'days_since_order': 2,
'current_status': 'in_transit'
});
// User receives order
gtag('event', 'order_delivered', {
'transaction_id': 'TXN_12345',
'delivery_time_days': 3
});
Loyalty & Engagement
// User joins loyalty program
gtag('event', 'loyalty_join', {
'program_name': 'VIP Rewards',
'tier': 'silver',
'referral_code': 'REF_ABC123'
});
// User adds to wishlist
gtag('event', 'wishlist_add', {
'product_id': 'SHOE_002',
'wishlist_size': 8,
'item_in_stock': true
});
// User receives and opens email
gtag('event', 'email_campaign_open', {
'campaign_name': 'summer_sale_2024',
'email_type': 'promotional',
'click_count': 2
});
// User makes repeat purchase
gtag('event', 'repeat_purchase', {
'repeat_purchase_number': 3,
'days_since_last_purchase': 45,
'customer_lifetime_value': 450
});
E-commerce User Properties
gtag('set', {
'customer_value': 'high',
'purchase_frequency': 'monthly',
'average_order_value': 150,
'customer_lifetime_value': 3000,
'loyalty_tier': 'gold',
'preferred_category': 'shoes',
'total_purchases': 15,
'last_purchase_days_ago': 30
});
Education / EdTech
Enrollment & Course Events
// User enrolls in course
gtag('event', 'course_enroll', {
'course_id': 'PYTHON_101',
'course_name': 'Python Fundamentals',
'instructor_id': 'INSTR_001',
'course_price': 99,
'course_level': 'beginner',
'payment_method': 'credit_card'
});
// User starts course
gtag('event', 'course_start', {
'course_id': 'PYTHON_101',
'enrollment_to_start_days': 2
});
// User completes course
gtag('event', 'course_complete', {
'course_id': 'PYTHON_101',
'course_completion_percent': 100,
'days_to_completion': 30,
'final_score': 92
});
// User drops course
gtag('event', 'course_drop', {
'course_id': 'PYTHON_101',
'completion_percent': 45,
'reason': 'time_constraints'
});
Learning Activities
// User completes lesson
gtag('event', 'lesson_complete', {
'course_id': 'PYTHON_101',
'lesson_id': 'LESSON_005',
'lesson_title': 'Functions and Loops',
'time_spent_minutes': 45,
'lesson_completion_percent': 100
});
// User takes quiz
gtag('event', 'quiz_submit', {
'course_id': 'PYTHON_101',
'quiz_id': 'QUIZ_003',
'quiz_title': 'Module 3 Assessment',
'questions_correct': 8,
'questions_total': 10,
'quiz_score_percent': 80,
'attempts': 2
});
// User watches video lesson
gtag('event', 'video_watch', {
'course_id': 'PYTHON_101',
'video_id': 'VID_001',
'video_title': 'Introduction to Functions',
'video_duration_minutes': 12,
'watch_time_minutes': 11,
'playback_speed': '1.0x',
'replays': 1
});
// User downloads resource
gtag('event', 'course_resource_download', {
'course_id': 'PYTHON_101',
'resource_type': 'code_files',
'resource_size_mb': 25
});
// User accesses discussion forum
gtag('event', 'forum_post_create', {
'course_id': 'PYTHON_101',
'post_category': 'technical_question',
'post_upvotes_received': 3
});
Progress & Achievements
// User earns certificate
gtag('event', 'certificate_earn', {
'course_id': 'PYTHON_101',
'certificate_type': 'completion',
'final_grade': 'A',
'certificate_sharable': true
});
// User earns badge
gtag('event', 'badge_unlock', {
'badge_name': 'Quick Learner',
'badge_type': 'achievement',
'criteria_met': 'complete_3_courses_in_month'
});
// User reaches learning milestone
gtag('event', 'learning_milestone_reach', {
'milestone_name': 'proficiency_level_2',
'courses_completed': 3,
'total_learning_hours': 50
});
Education User Properties
gtag('set', {
'student_tier': 'premium',
'total_courses_enrolled': 5,
'total_courses_completed': 3,
'average_course_rating': 4.5,
'total_learning_hours': 50,
'specialization': 'python_development',
'progress_percent': 60
});
Media & Publishing
Content Consumption
// User views article
gtag('event', 'article_view', {
'article_id': 'ART_001',
'article_title': 'GA4 Complete Guide',
'article_category': 'analytics',
'article_author': 'John Doe',
'publication_date': '2024-11-01',
'article_word_count': 5000
});
// User reaches scroll depth
gtag('event', 'article_scroll_depth', {
'article_id': 'ART_001',
'scroll_depth_percent': 75,
'time_on_page_seconds': 300
});
// User reads entire article
gtag('event', 'article_read_complete', {
'article_id': 'ART_001',
'reading_time_seconds': 1200,
'estimated_reading_time_seconds': 1500
});
// User watches video
gtag('event', 'video_watch_start', {
'video_id': 'VID_001',
'video_title': 'GA4 Tutorial',
'video_duration_minutes': 15,
'video_category': 'tutorial'
});
// User listens to podcast
gtag('event', 'podcast_listen', {
'episode_id': 'EP_123',
'episode_title': 'Analytics Trends 2024',
'listen_time_minutes': 45,
'listened_to_end': true
});
Engagement & Interaction
// User shares content
gtag('event', 'content_share', {
'content_id': 'ART_001',
'content_type': 'article',
'share_method': 'email'
});
// User comments on content
gtag('event', 'content_comment', {
'content_id': 'ART_001',
'comment_length': 250,
'comment_helpful_votes': 5
});
// User likes/claps content
gtag('event', 'content_engage', {
'content_id': 'ART_001',
'engagement_type': 'like',
'engagement_value': 1
});
// User bookmarks content
gtag('event', 'content_bookmark', {
'content_id': 'ART_001',
'content_type': 'article',
'bookmark_folder': 'analytics'
});
Subscription & Monetization
// User subscribes to newsletter
gtag('event', 'newsletter_subscribe', {
'newsletter_name': 'Weekly Analytics',
'subscription_frequency': 'weekly',
'email_validated': true
});
// User upgrades to premium
gtag('event', 'paywall_cross', {
'article_id': 'ART_001',
'paywall_type': 'subscription',
'conversion_value': 99
});
// User purchases single article
gtag('event', 'article_purchase', {
'article_id': 'ART_001',
'purchase_price': 4.99,
'currency': 'USD'
});
// User renews subscription
gtag('event', 'subscription_renew', {
'subscription_plan': 'annual',
'renewal_value': 99,
'tenure_years': 2
});
Media User Properties
gtag('set', {
'subscriber_status': 'premium',
'subscription_plan': 'annual',
'favorite_categories': 'analytics,marketing',
'total_articles_read': 45,
'average_article_completion': 0.75,
'engagement_level': 'high'
});
Cross-Industry Event Patterns
Common to All Industries
User Registration & Authentication:
gtag('event', 'user_signup', {
'signup_method': 'email',
'email_verified': true,
'signup_source': 'landing_page'
});
gtag('event', 'user_login', {
'login_method': 'password',
'login_platform': 'web'
});
Account Management:
gtag('event', 'profile_update', {
'fields_updated': 3,
'completion_percent': 100
});
gtag('event', 'preference_change', {
'preference_type': 'language',
'new_value': 'spanish'
});
Help & Support:
gtag('event', 'help_search', {
'search_query': 'how to export data',
'results_count': 5
});
gtag('event', 'live_chat_start', {
'chat_topic': 'billing',
'wait_time_seconds': 30
});
Custom Event Templates by Use Case
Sign-Up Funnel Tracking
gtag('event', 'signup_step_1_view'); // Email input
gtag('event', 'signup_step_2_view'); // Password
gtag('event', 'signup_complete'); // Confirmation
Feature Adoption Funnel
gtag('event', 'feature_discover'); // See feature
gtag('event', 'feature_enable'); // Turn on
gtag('event', 'feature_use'); // Actually use
gtag('event', 'feature_value_realize'); // Sees benefit
Conversion Value Path
gtag('event', 'awareness_content_view'); // Top of funnel
gtag('event', 'consideration_comparison'); // Middle
gtag('event', 'decision_contact'); // Bottom
gtag('event', 'purchase'); // Conversion