Analytics and Tracking

Quick Start

When implementing analytics:

• Use trackEvent() from @/lib/integrations/analytics

• Track e-commerce events (view_item, add_to_cart, purchase)

• Include relevant properties (item_id, price, category)

• Verify events in DevTools Network tab

Key Files

• src/lib/integrations/analytics/

• Analytics integration

• src/components/Analytics/

• Analytics components

• src/app/api/track/

• Tracking API

• src/hooks/useAnalytics.ts

• Analytics hook

Common Events

Track Product View

import { trackEvent } from '@/lib/integrations/analytics';

await trackEvent({ event: 'view_item', properties: { item_id: product.id, item_name: product.name, price: product.price, currency: 'ARS', category: product.category.name, }, });

Track Purchase

await trackEvent({ event: 'purchase', properties: { transaction_id: order.id, value: order.total, currency: 'ARS', items: order.items.map(item => ({ item_id: item.product_id, item_name: item.product.name, price: item.price, quantity: item.quantity, })), }, });

Use Hook

import { useAnalytics } from '@/hooks/useAnalytics';

function ProductCard({ product }: ProductCardProps) { const { track } = useAnalytics();

const handleClick = () => { track('product_click', { product_id: product.id, product_name: product.name, }); };

return <div onClick={handleClick}>...</div>; }

Event Types

• page_view

• Page view

• product_view

• Product view

• add_to_cart

• Add to cart

• remove_from_cart

• Remove from cart

• begin_checkout

• Begin checkout

• purchase

• Purchase completed

• search

• Product search