Guides / Sending events

Getting Started with Events

Users interact with your site: they click on search results, view category pages, or add items to a shopping cart. Capturing these user events enables you to understand more about your users and their behavior.

You can collect three different types of events:

  • View events: a user looked at something, for example, an article, a product, or a landing page
  • Click events: a user clicked on something, for example, an item on your home page, a search result, or an advertisement.
  • Conversion events: a user performed a critical step in a user journey, for example, liking an article, adding a product to the shopping cart, or purchasing a product.

You can collect these events with Algolia Insights. The Algolia Insights API provides a central access point for your event data, regardless of which platform your website or application runs on.

Why you should send events to Algolia

Capturing user behavior by sending events to Algolia is a foundational step in building search and discovery experiences. Sending events to Algolia unlocks these features:

  • Click and conversion analytics: analyze how your search performs. Make data-driven, business-relevant decisions based on analytics.

  • Algolia Recommend: use your user events data to deliver machine learning-powered recommendations for frequently bought together or related products.

  • Dynamic Re-ranking: use your user events data to dynamically adjust the ranking of search results in response to trends in your users’ behavior.

  • A/B testing: tune your relevance to maximize impact. With A/B testing, you tweak your relevance strategy in small steps and verify which version performed better with click and conversion analytics from real-time user events data.

  • Personalization: match the relevance of your search and browse experience to individual user profiles. Sending events to Algolia lets you turn user events into user affinities that you can leverage to build personalized experiences.

When you should think about sending events

Capturing user behavior should be an essential part of your search and discovery strategy. You should send events as soon as possible. For example, if you implement a search user interface with Algolia’s front-end UI libraries, you should add the events when you build the search interface.

Sending events early lets you build more robust implementations and reduce the risk of troubleshooting events in production later. Different Algolia features leverage different event attributes, for example, a queryID or a userToken. By adding events early, you can implement them once, and you are well prepared to act on your user data without having to think about implementing events again.

Sending events sooner lets you act sooner on your user data. Different Algolia features leverage different numbers of events. See the following table for an overview of the required number of events.

Algolia feature Needs at least these events
Click and conversion analytics Any number of events
Frequently bought together (Algolia Recommend) 1,000 conversion events from the same user with two or more items within the last 30 days
Related products (Algolia Recommend) 10,000 click and conversion events within the last 30 days
Dynamic re-ranking For a record to be promoted, it has to gather at least 20 clicks or two conversions during the last 30 days
A/B testing Any number of events
Personalization Any number of events

Did you find this page helpful?