Complete guide to implementing Google-defined recommended events in GA4 including purchase, add_to_cart, login, sign_up, and full ecommerce journey. Use when implementing ecommerce tracking, tracking user authentication, implementing conversion events, working with the items array, or setting up standard event tracking. Covers all recommended events with required parameters, items array structure, and gtag.js/GTM implementation examples. Includes purchase events, add_to_cart tracking, checkout funnel events, and items array structure for ecommerce transactions. Works with .js, .jsx, and GTM container implementations.
/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/recommended-events-templates.jsreferences/ecommerce-events-guide.mdreferences/engagement-events.mdreferences/implementation-examples.mdreferences/items-array-reference.mdreferences/recommended-events-complete.mdGA4 provides a set of recommended event names and parameter structures defined by Google for consistency across analytics implementations. These standardized events enable key features like ecommerce reports, conversion modeling, and Google Ads integration. Recommended events follow best practices and are compatible with all GA4 features, making them the preferred approach for standard user interactions.
Invoke this skill when:
GA4 organizes recommended events into three main categories:
Engagement Events:
login - User authentication (with method parameter)sign_up - New account creation (with method parameter)search - Site search performed (search_term parameter)view_item - Product page viewed (items array)view_item_list - Product list viewed (items array)select_item - Item selected from list (items array)view_promotion - Promotion/offer displayed (promotion_id, promotion_name)select_promotion - Promotion clicked (promotion_id, promotion_name)Monetization Events (Ecommerce):
add_to_cart - Item added to cart (items array required)remove_from_cart - Item removed from cart (items array)view_cart - Shopping cart viewed (items array)begin_checkout - Checkout initiated (items array, value, currency)add_shipping_info - Shipping method selected (shipping_tier parameter)add_payment_info - Payment method added (payment_type parameter)purchase - Transaction completed (transaction_id, value, currency, items)refund - Purchase refunded (transaction_id, value, items)add_to_wishlist - Item added to wishlist (items array)Other Recommended Events:
generate_lead - Lead generated (value, currency optional)select_content - Content selected (content_type, item_id)share - Content shared (method, content_type)The items array is critical for ecommerce tracking. Each item object can contain:
Required (at least one):
item_id - Product SKU or unique identifieritem_name - Product display nameHighly Recommended:
price - Individual unit pricequantity - Number of unitsitem_category - Primary product categoryOptional:
item_brand, item_variant, coupon, discountitem_category2 through item_category5 - Hierarchical categoriesitem_list_id, item_list_name - List identifiersaffiliation, location_id, index - Additional contextThe purchase event is the most important recommended event. Structure includes:
gtag('event', 'purchase', {
'transaction_id': 'TXN_12345', // Required: unique per purchase
'value': 299.99, // Recommended: total value
'currency': 'USD', // Recommended: currency code
'tax': 20.00, // Optional: tax amount
'shipping': 10.00, // Optional: shipping cost
'coupon': 'SUMMER20', // Optional: discount code
'affiliation': 'Online Store', // Optional: store name
'items': [ // Recommended: product details
{
'item_id': 'SKU_001',
'item_name': 'Product Name',
'item_category': 'Electronics',
'price': 99.99,
'quantity': 2
}
]
});
Implement tracking across the full customer journey:
In Google Tag Manager, recommended events are configured as:
Most Important Events:
purchase - Revenue tracking (highest priority)add_to_cart - Conversion funnelbegin_checkout - Funnel abandonmentlogin / sign_up - User authenticationCritical Rules:
transaction_id in purchase events (unique per transaction)currency parameter for monetary events (USD, EUR, etc.)item_id or item_name in items array (required)Testing Approach:
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.