About IPX Recommendations (IPXRECS)

This is for:

In this article

Automatic model configuration
Manage an IPXRECS model

Coveo Machine Learning (Coveo ML) IPX Recommendation (IPXRECS) models provide recommended content to users in a Coveo In-Product Experience (IPX) search interface based on previous user activity.

The IPXRECS model learns from repeated occurrences of search and click events from previous user sessions in the IPX interface. The IPXRECS model then generates relevant document recommendations based on the commonly clicked documents of users visiting certain URLs.

Example of Coveo IPX recommendations under a searchbox

The recommendations appear when the IPX search interface loads on the web page or application. This is usually when a user opens an IPX interface, but it can also be when the IPX interface reloads. The list of recommendations is based on the URL at the time when the IPX interface loads. When a query is performed, the recommendations are replaced by search results, and the recommendations will only reappear if the IPX interface is reloaded.

Note

The IPX search interface lists a maximum of 5 item recommendations. If there are less than 5 recommendations available for the given URL, only the available recommendations are shown.

Automatic model configuration

When you create an IPX search interface, an IPX Recommendation (IPXRECS) model is automatically created and associated with a query pipeline that the IPX interface uses specifically for recommendations. The IPXRECS model is preconfigured to rebuild and learn from new data on a weekly schedule, based on when the model is created.

Notes

The recommendation query pipeline and the associated IPXRECS model are already fully optimized for use with the IPX search interface. No further optimization is required.
IPXRECS models can’t be added manually. To create a new IPXRECS model, create a new IPX search interface.
A newly-created IPX Recommendation (IPXRECS) model may display an error status. This is expected because it doesn’t have enough click events to generate recommendations yet. Once 5 click events are available and the IPXRECS model rebuilds, the error disappears and the model will begin to provide recommendations.

Learn more about the IPX query pipelines and ML model configuration.

Manage an IPXRECS model

See how to edit, delete, and review information for your IPX Recommendation (IPXRECS) model.

Edit an IPXRECS model

Because of the automatic configuration of the IPXRECS model, you can only rename it or associate it with a different project when editing the model.

On the Models (platform-ca | platform-eu | platform-au) page, click the model you want to edit, and then click Edit in the Action bar.
On the subpage that opens, select the Configuration tab.
Under Name, edit the model’s display name.
(Optional) Use the Project selector to associate your model with one or more projects.
Click Save.

Delete an IPXRECS model

Notes

If the model is associated with a query pipeline, make sure to dissociate the model from the query pipeline after deleting it.
An IPXRECS model is automatically deleted if you delete its associated IPX search interface.

On the Models (platform-ca | platform-eu | platform-au) page, click the ML model that you want to delete, and then click More > Delete in the Action bar.
In the panel that appears, click Delete.

Review model information

On the Models (platform-ca | platform-eu | platform-au) page, click the desired model, and then click View in the Action bar. For more information, see Reviewing model information.