> ## Documentation Index
> Fetch the complete documentation index at: https://algolia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Which events to track

> Collect the right user events for your application.

When you build your search and browse interface, **you should implement sending events at the same time.**
This lets you [validate your user events](/doc/guides/sending-events/guides/validate) before going live and collect enough events to make an impact sooner.

When planning which events to send, consider all interaction points your users have with your site:

* Category pages
* Search results pages
* Autocomplete menu
* Emails, newsletters, push notifications, and other pages

## Must-have events for ecommerce

Every ecommerce search and browse implementation should send click events
when users click products after performing a search.
They should also include conversion events when users add products to the shopping cart.

### Must-have events for product listing pages

| Event                        | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `PLP: Product Clicked`       | A user clicked on a search result. Send a click event to capture the search query, which item was clicked, and the position in the search results. <br /><br />API method: [`clickedObjectIDsAfterSearch`](/doc/libraries/sdk/v1/methods/clicked-object-ids-after-search) <br /><br />Properties: [`eventName`](/doc/libraries/sdk/v1/methods/clicked-object-ids-after-search#param-event-name), [`indexName`](/doc/libraries/sdk/v1/methods/clicked-object-ids-after-search#param-index-name), [`objectIDs`](/doc/libraries/sdk/v1/methods/clicked-object-ids-after-search#param-object-ids), [`positions`](/doc/libraries/sdk/v1/methods/clicked-object-ids-after-search#param-positions), [`userToken`](/doc/libraries/sdk/v1/methods/clicked-object-ids-after-search#param-user-token), [`queryID`](/doc/libraries/sdk/v1/methods/clicked-object-ids-after-search#param-query-id) |
| `PLP: Product Added to Cart` | A user added an item to the cart on the product listing page after performing a search. <br /><br />API method: [`addedToCartObjectIDsAfterSearch`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids-after-search) <br /><br />Properties: [`eventName`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids-after-search#param-event-name), [`indexName`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids-after-search#param-index-name), [`objectIDs`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids-after-search#param-object-ids), [`queryID`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids-after-search#param-query-id), [`userToken`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids-after-search#param-user-token)                                                                                                                  |

### Must-have events for product detail pages

| Event                                     | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `PDP: Product Added to Cart after Search` | A user added an item to the cart on the product detail page after performing a search.<br /><br />API method: [`addedToCartObjectIDsAfterSearch`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids-after-search)<br /><br />Properties: [`eventName`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids-after-search#param-event-name), [`indexName`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids-after-search#param-index-name), [`objectIDs`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids-after-search#param-object-ids), [`queryID`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids-after-search#param-query-id), [`userToken`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids-after-search#param-user-token) |
| `PDP: Product Added to Cart`              | A user added an item to the cart.<br /><br />API method: [`addedToCartObjectIDs`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids)<br /><br />Properties: [`eventName`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids#param-event-name), [`indexName`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids#param-index-name), [`objectIDs`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids#param-object-ids), [`userToken`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids#param-user-token)                                                                                                                                                                                                                                   |

### Must-have events for autocomplete

If you include products in the autocomplete menu of your search interface, you should send events for user interactions with the Autocomplete menu. See the [Autocomplete guide](/doc/ui-libraries/autocomplete/guides/sending-algolia-insights-events) for more information.

| Event                                 | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Autocomplete: Product Clicked`       | A user clicked on a search result in the autocomplete menu.<br /><br />API method: [`clickedObjectIDsAfterSearch`](/doc/libraries/sdk/v1/methods/clicked-object-ids-after-search)<br /><br />Properties: [`eventName`](/doc/libraries/sdk/v1/methods/clicked-object-ids-after-search#param-event-name), [`indexName`](/doc/libraries/sdk/v1/methods/clicked-object-ids-after-search#param-index-name), [`objectIDs`](/doc/libraries/sdk/v1/methods/clicked-object-ids-after-search#param-object-ids), [`positions`](/doc/libraries/sdk/v1/methods/clicked-object-ids-after-search#param-positions), [`queryID`](/doc/libraries/sdk/v1/methods/clicked-object-ids-after-search#param-query-id), [`userToken`](/doc/libraries/sdk/v1/methods/clicked-object-ids-after-search#param-user-token) |
| `Autocomplete: Product Added to Cart` | A user added an item to the cart from the autocomplete menu.<br /><br />API method: [`addedToCartObjectIDsAfterSearch`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids-after-search)<br /><br />Properties: [`eventName`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids-after-search#param-event-name), [`indexName`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids-after-search#param-index-name), [`objectIDs`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids-after-search#param-object-ids), [`queryID`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids-after-search#param-query-id), [`userToken`](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids-after-search#param-user-token)                                                      |

## Additional events for Personalization

You can add these events if you want to enhance your Personalization strategy. See [Personalizing results](/doc/guides/personalization/classic-personalization/personalizing-results) for more information.

| Event                 | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `PLP: Filter Clicked` | A user selected a facet value.<br /><br />API method: [`clickedFilters`](/doc/libraries/sdk/v1/methods/clicked-filters)<br /><br />Properties: [`eventName`](/doc/libraries/sdk/v1/methods/clicked-filters#param-event-name), [`indexName`](/doc/libraries/sdk/v1/methods/clicked-filters#param-index-name), [`filters`](/doc/libraries/sdk/v1/methods/clicked-filters#param-filters), [`userToken`](/doc/libraries/sdk/v1/methods/clicked-filters#param-user-token)                                                                                |
| `PLP: Filter Viewed`  | A user viewed a landing page.<br /><br />API method: [`viewedFilters`](/doc/libraries/sdk/v1/methods/viewed-filters)<br /><br />Properties: [`eventName`](/doc/libraries/sdk/v1/methods/viewed-filters#param-event-name), [`indexName`](/doc/libraries/sdk/v1/methods/viewed-filters#param-index-name), [`filters`](/doc/libraries/sdk/v1/methods/viewed-filters#param-filters), [`userToken`](/doc/libraries/sdk/v1/methods/viewed-filters#param-user-token)                                                                                       |
| `Product Viewed`      | A user viewed a product page from an email, newsletter, push notification, or any other page.<br /><br />API method: [`viewedObjectIDs`](/doc/libraries/sdk/v1/methods/viewed-object-ids)<br /><br />Properties: [`eventName`](/doc/libraries/sdk/v1/methods/viewed-object-ids#param-event-name), [`indexName`](/doc/libraries/sdk/v1/methods/viewed-object-ids#param-index-name), [`objectIDs`](/doc/libraries/sdk/v1/methods/viewed-object-ids#param-object-ids), [`userToken`](/doc/libraries/sdk/v1/methods/viewed-object-ids#param-user-token) |

## Events for Algolia Recommend

See [Event requirements for Algolia Recommend](/doc/guides/algolia-recommend/overview#events-requirements-for-the-models) for more information.

## Example events for media

When planning events to send for a media use case, consider the following example events.

### View events

* `Article Viewed`: a user viewed an article page.

### Click events

* `Article Clicked`: a user clicked on an article.
* `Ad Clicked`: a user clicked on an ad.

### Conversion events

* `Article Read`: a user reached the bottom of an article page.
* `Article Bookmarked`: a user bookmarked an article.
* `Article Liked`: a user liked an article.
* `Article Recommended`: a user recommended an article.
* `Video Watched`: a user watched a video.
* `Playlist Followed`: a user followed a playlist.
* `Author Followed`: a user followed an author.
* `Brand Followed`: a user followed a brand.

## See also

* [Merchandising playbook: events planning](https://www.algolia.com/ecommerce-merchandising-playbook/events-planning/)