Search Tracking

Client-side event tracking endpoints for search and recommendation analytics. No authentication required. All endpoints return 204 No Content on success.

📄️ Track session start

Records the start of a new user session. Must be called before any other tracking event for the same session.

📄️ Track search box focus

Fired when the user focuses the search input field.

📄️ Track search box abandon

Fired when the user leaves the search box without submitting a search (e.g. pressing Escape or clicking away).

📄️ Track suggestions shown

Fired when the suggestions dropdown is displayed to the user.

📄️ Track suggestion selected

Fired when the user clicks or taps a suggestion from the suggestions dropdown.

📄️ Track search submitted

Fired when the user explicitly submits a search query (pressing Enter or clicking the search button).

📄️ Track search results page shown

Fired when the search results page (SERP) is displayed to the user.

📄️ Track search result clicked

Fired when the user clicks a result on the search results page.

📄️ Track search results page abandoned

Fired when the user leaves the search results page without interacting with it.

📄️ Track filter interaction

Fired when the user applies, removes, or changes a filter on the search results page.

📄️ Track add to cart

Fired when a user adds a product to their cart from a Zoovu-powered surface (SERP, suggestions, mini PDP, etc.).

📄️ Track purchase / checkout

Fired when a user completes a purchase. Send one event with all purchased products in the `products` array. The `products` array must be non-empty.

📄️ Track AI Guided Questions loaded

Fired when a AI Guided Questions widget finishes loading and renders.

📄️ Track AI Guided Questions viewed

Fired when a AI Guided Questions view scrolls into the user's viewport.

📄️ Track AI Guided Questions answer clicked

Fired when the user selects an answer to a AI Guided Questions.

📄️ Track comparison widget viewed

Fired when the product comparison widget becomes visible to the user.

📄️ Track comparison item clicked

Fired when the user clicks a product in the comparison widget.

📄️ Track add to cart from comparison

Fired when the user adds a product to cart directly from the comparison widget.