Create A Report To Monitor Query Suggest Performance In Coveo

Example Subheading

February 22, 2022

By David Austin

Create A Report To Monitor Query Suggestions

An often overlooked aspect of Query Suggest is understanding how the model itself is performing. You might be curious how often a query is suggested to a user. What words are performing better than others. This might be great for your marketing team because you can use this information to create featured items.

Steps To Create A Query Suggest Report

The following steps will guide you through creating a report to monitor your Query Suggest model.

Create A Blank Report

In Coveo Cloud Platform Admin go to Models and then in the top right corner click Add and select Blank dashboard.

Query Suggest Reports In Coveo

Update The Date Interval

It's often useful to match the report to the date interval you used for your model's learning. In this case, set it to three months.

Coveo reporting period in report creation

Add Appropriate Filters

We're going to add four filters to our report.

  1. Add User Query isNot blank or n/a

    Enter User Query Filter Value in Coveo report creation

  2. Add Origin 1 (Page/Hub) is <Search Page> or <Search Hub Name>

    Enter Origin 1 of Query string in Coveo report creation

  3. Add (Optional) Origin 2 (Tab/Interface) is <Tab Name> or <Search Interface Name>

    Enter Origin 2 value for query string in Coveo report creation

    This only applies really if you have separate tabs.

  4. Add (Optional) Language is 'en'. If you have only one language, obviously this is not required.

Add The Card To A Section

Click Add card to section followed by adding a Table card.

Add a card step in Coveo Query performance report creation

In Dimensions add User Query. And in Metrics add Click Event Count.

In the filters on the right, add a filter such that Click Event Count is greater than or equal to <X>.

The value of <X> is determined by the number in the table found on this page. Such that depending on how many queries your site has, the value of <X> needs to be updated. As your site grows you'll need to come back to this filter to update it.

Add a Table Card step in Coveo Report creation

Save Your Report

Save the dashboard and after your search has been used, you should now see results show up showing the queries suggested and how many times they have been suggested. Note: If your site is just launching it's quite possible this report will be empty.

Coveo Query Suggest report

Image of Fishtank employee David Austin

David Austin

Development Team Lead | Sitecore Technology MVP x 3

David is a decorated Development Team Lead with Sitecore Technology MVP and Coveo MVP awards, as well as Sitecore CDP & Personalize Certified. He's worked in IT for 25 years; everything ranging from Developer to Business Analyst to Group Lead helping manage everything from Intranet and Internet sites to facility management and application support. David is a dedicated family man who loves to spend time with his girls. He's also an avid photographer and loves to explore new places.