Analytics quickstarts

Analytics is the foundation of Luigi’s Box learning. Before moving into Search, Autocomplete, Recommendations, or Product Listing, make sure your event tracking and object identity strategy are solid.

Choose your path

Recommended for web

DataLayer Collector

Use the JavaScript collector when your storefront already has a `dataLayer` or GA4-style ecommerce events.

• Fastest path for websites.
• Works naturally with existing ecommerce events.
• Pairs well with Luigi's Box frontend libraries.

Backend and mobile

Events API

Send analytics events directly from your backend or mobile app when you need full control over event delivery.

• No browser collector required.
• Fits mobile and server-side architectures.
• Gives you explicit control over payloads.

Quickstart collection

Foundation

Start here

Establish the identity model that all analytics and catalog data will share.

Analytics and object identity

Understand the feedback loop and how consistent identifiers keep Luigi's Box learning accurate.

DataLayer Collector

Frontend tracking path

Use these guides when the browser is responsible for reporting ecommerce events.

Track your first search

Report result views and clicks from search or autocomplete lists.

Track purchases and conversions

Add `add_to_cart` and `purchase` tracking so the models learn from conversion signals.

Events API

Backend and mobile path

Use these guides when you need to send analytics directly to Luigi's Box.

Send your first search events

Start with search and click events sent through the API.

Track purchases and conversions

Extend the API flow with add-to-cart and transaction reporting.

Verification

Debug your setup

Check that events are flowing correctly before you move deeper into product integrations.

Debugging your analytics

Use the linter and live session explorer to validate your implementation.