Click and conversion events

Learn how to track click and conversion analytics in Magento with the Algolia extension.

To analyze how users are interacting with your search experience in your Magento installation, you can track clicks and conversions. For both the Autocomplete and InstantSearch Results page, you can track which products are clicked more often, and which searches have the highest conversion rate.

To enable click and conversion analytics, go to Stores > Configuration > Algolia Search > Click & Conversion Analytics from the Magento Admin panel.

Enable click analytics

Set Enable Click Analytics to Yes to turn on click and conversion analytics.

This adds the parameter clickAnalytics=true to every search. The default for this setting is No.

DOM selector of a result container on InstantSearch page

Enter a DOM selector for the search results container to define which elements on your page are tracked. The elements selected must have the data-objectid and data-position attributes.

This default DOM selector is .ais-Hits-item a.result, .ais-InfiniteHits-item a.result.

Enable conversion tracking

To determine how well Algolia helps achieve your business objectives, enable conversion tracking.

Previous versions of the extension required you to specify which event you would like to track as a conversion, either Add to cart or Place order.

From version 3.14 Algolia tracks both types of conversions. To do this, set Enable Click Analytics to Yes:

After making this change, save your settings and clear your configuration cache.

Conversions are determined as follows:

Conversion types	Description
Add to cart	A conversion event is triggered as soon as a user clicks the Add to cart button. This can either be on the search results or the product page.
Place order	A conversion event is triggered when a user lands on the Checkout Successful page.

To be considered a conversion, a user must have interacted with your search at least once during the session for the product being considered.

To connect searches to conversion events, the Algolia extension adds URL parameters for the queryID, objectID, and indexName parameters. You need to include these parameters for your clicks and conversions to work. For better SEO, you should use canonical link meta tags for your product pages. To enable canonical links, go to Stores > Configuration > Catalog > Catalog and set Use Canonical Link Meta Tag For Products to Yes.

If you’re using an alternative method to track the queryID, objectID, and indexName parameters for your conversion events, you can remove the URL parameters by editing the common.js file.

URL parameters added to product links

From version 2 and later, URL parameters are appended to the product links in your search if you enable conversion tracking. This is so search can be tied to a conversion event using the queryID parameter. As best SEO practice, use canonical links for your product pages. Enable this setting by going to Stores > Configuration > Catalog > Catalog > Search Engine Optimization > Use Canonical Link Meta Tag For Products in your store’s Admin

Revenue analytics

This feature isn’t available on every plan. Refer to your pricing plan to see if it’s included.

Versions 3.14 and later support revenue analytics for qualifying plans. When conversion tracking is enabled, Magento also sends revenue data with all Add to cart and Place order conversion events.

Revenue data sent to Algolia takes into account any discounts or special pricing that may apply. Discounts are applied to conversion event types as follows:

	Add to cart	Place order
Special price
Catalog price rule
Cart price rule
Customer group pricing

Revenue is calculated based on the final sale price of an item (after all discounts are applied) multiplied by the quantity ordered for that item.

Since Magento shopping cart price rules only take effect in the context of the entire order, these particular discounts are only included when calculating the revenue data that is sent with the Place order event.

Version 3.14 uses version 4 of the Algolia PHP API client to support this feature. Version 4 of the client requires PHP 8. Plan for this upgrade accordingly before pushing to production.

DOM selector of Add to cart buttons

Enter a selector for the Add to cart button if the conversion analytics mode is set to Add to cart. The elements targeted by this selector must have the data-objectid attribute (unique product identifier).

The default is .action.primary.tocart.