Storefront Views
Track page views and product views.
Updated
On this page
Overview
Track page views and product visits on your storefront. DashForDevs provides built-in analytics with optional integration to PostHog and Google Analytics.
Initialize Tracking
import dash from "@/lib/dash"
const { active } = await dash.tracking.init()
// Initializes session tracking
Track Page Visits
// Track a product page visit
await dash.tracking.trackVisit({
product_id: "prod_abc123",
duration: 30, // seconds spent
})
Auto Page Views
// Enable automatic pageview tracking for SPA navigation
dash.tracking.enableAutoPageviews()
// Disable when needed
dash.tracking.disableAutoPageviews()
Custom Events
dash.tracking.capture("add_to_cart", {
product_id: "prod_abc",
product_name: "Blue Dream",
price: "29.99",
})
dash.tracking.capture("search", {
query: "edibles",
results_count: 15,
})
User Identification
// After login
dash.tracking.setCustomer("cust_abc123")
// After logout
dash.tracking.clearCustomer()
REST API
# Get analytics config
GET /storefront/analytics/config
X-API-Key: pk_live_your_key
# Track visit
POST /storefront/analytics/track-visit
Content-Type: application/json
{ "product_id": "prod_abc", "session_id": "sess_123", "duration": 30 }
Next Steps
- Google Analytics (GA4) — GA4 integration
- PostHog — PostHog integration
- UTM Tracking — Campaign tracking
What these events become once collected is covered in analytics and reporting.