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

# Configure user events

> Learn how to configure your user events for Advanced Personalization.

After [setting up your indices](/doc/guides/personalization/advanced-personalization/configure/setup/indices) for Advanced Personalization,
the next step is configuring the events.
This teaches the Advanced Personalization feature how to interpret user interactions to provide relevant personalized search results.

Advanced Personalization learns from events you setup in your configuration.
It also automatically considers events from the replicas of your personalized index.
When the configuration is saved, events from the last 24 hours are validated.
The dashboard shows errors if invalid user tokens or invalid `objectIDs` are found in the selected events.

To start configuration,
go to the [**User Events**](https://dashboard.algolia.com/advanced-personalization/configuration/events/) section of the Advanced Personalization dashboard. Here, you'll find four different event collections to configure.

<Callout icon="credit-card" color="#c084fc">
  This feature isn't available on every plan.
  Refer to your [pricing plan](https://www.algolia.com/pricing) to see if it's included.
</Callout>

## Event collections

An event collection is a group of events that describe a user signal.
It's used by Advanced Personalization to make sense of user interactions and fine-tune personalization.
The event collections are:

* A user viewed a product in a listing
* A user viewed a record's details
* A user showed interest in a record
* A user achieved their goal with a record

<Info>
  The dashboard lists the events received in the last 24 hours.
</Info>

### A user viewed a product in a listing

Events related to a user viewing products on listing pages.

The collection includes events for:

* **Products viewed on the home page.**
* **Products viewed in a category listing.**
* **Products viewed in search results.**

<Info>
  This event is optional.
  You can configure Advanced Personalization without it.
</Info>

#### Examples

Products viewed in a category listing:

```json JSON icon=braces theme={"system"}
{
  "eventType": "view",
  "eventName": "Category Page Viewed",
  "index": "prod_ecommerce_EN"
}
```

Products viewed in search results:

```json JSON icon=braces theme={"system"}
{
  "eventType": "view",
  "eventName": "Search Results Viewed",
  "index": "prod_ecommerce_EN"
}
```

### A user viewed a record's details

Events related to a user viewing the details of your record.

This collection includes events for:

* **A product viewed from its PDP (Product Detail Page).**
  This view event captures the signal that a user landed on a product detail page,
  coming either from another page of this website or from an external referrer (such as Google or social media).

* **Optional: a product clicked on a PLP.**
  This click event captures the signal that a user is navigating to a PDP.

#### Examples

A product viewed from its PDP:

```json JSON icon=braces theme={"system"}
{
  "eventType": "view",
  "eventName": "Product Details Viewed",
  "index": "prod_ecommerce_EN"
}
```

A product clicked on a PLP:

```json JSON icon=braces theme={"system"}
{
  "eventType": "click",
  "eventName": "Product Clicked",
  "index": "prod_ecommerce_EN"
}
```

Additionally, you can add clicked filter events to this category. For example, capture [clicked filter](/doc/libraries/sdk/v1/methods/clicked-filters) events to let Advanced Personalization learn when users convert after applying filters.

A user selected filters:

```json JSON icon=braces theme={"system"}
{
  "eventType": "click",
  "eventName": "clickedFilters",
  "index": "prod_ecommerce_EN"
}
```

### A user showed interest in a record

Events related to a user indicating interest in your record.

This collection includes events for:

* **Products added to cart.**
  A conversion event that captures the signal that a user [added one or multiple products to their cart](/doc/libraries/sdk/v1/methods/added-to-cart-object-ids) from any page (such as search results, category pages, or product detail pages).

A user added a product to the cart:

```json JSON icon=braces theme={"system"}
{
  "eventType": "conversion",
  "eventSubType": "addToCart",
  "eventName": "Add To Cart",
  "index": "prod_ecommerce_EN"
}
```

Additionally, you can add converted filter events to this category. For example, capture [converted filter](/doc/libraries/sdk/v1/methods/converted-filters) events to let Advanced Personalization learn when users convert after applying filters.

```json JSON icon=braces theme={"system"}
{
  "eventType": "conversion",
  "eventName": "convertedFilters",
  "index": "prod_ecommerce_EN"
}
```

### A user achieved their goal with a record

Events related to a user successfully achieving their goal using your record.

This collection includes events for:

* **Products purchased.**
  A conversion event that captures the signal that a user has [completed the checkout process](/doc/libraries/sdk/v1/methods/purchased-object-ids).

## Next step

After setting up the event collections,
you're ready to [set personalization re-ranking](/doc/guides/personalization/advanced-personalization/configure/setup/personalization-reranking).

## See also

* [Send events with user tokens](/doc/guides/sending-events/concepts/usertoken)
* [Advanced Personalization error codes](/doc/guides/personalization/advanced-personalization/monitor/in-depth/error-codes)
* [Update the configuration with the Advanced Personalization API](/doc/rest-api/advanced-personalization/put-config)