Query suggestions

The feature lets you optimize the search experience by influencing the phrases suggested to the customer as they type in the search box. Additionally, it includes typo correction to ensure valid suggestions for queries with minor errors.

You can define the following settings for query suggestions:

• Index of suggestions; it’s built on the basis of the popularity of the searched queries and the results returned in response to these queries. The threshold of the popularity and query results is adjustable according to the customer’s preferences as well as time range of the analyzed data.
• Attributes a query suggestion is based on; it is possible to set up the suggestion index to be built on an attribute from one or more catalogs. The suggestions are returned based on the similarity of the attribute values that are typed by the customer into the search box.
• Manual suggestion phrases; define a list of phrases and manually modify their popularity to increase the probability of suggesting that phrase by the AI model.
• Denylist of phrases which will never be returned as a query suggestion.

Requirements

Create an index. If you want the suggestions to include only available items:

• Add the availability parameter with boolean values (true/false) to the feed used for creating an index.
• In the index settings, leave the Include out of stock items toggle disabled.
  If you will use more than one index for query suggestions, make sure all indexes meet the requirements above if you want the suggestions to include only available items.

Configuration

1. Go to AI Search > Suggestions.
2. Click New suggestion.
3. Enter the name of the query suggestion.
4. To define the settings in the Stats engine suggestions, click Define.
   1. Click Add index.
      
      Tip: An index is a data structure based on the input of the selected catalog. A search engine refers to the index while looking for relevant results in response to a specific query. It’s created on the basis of catalogs.
   2. From the dropdown list, select the index.
   3. Next to the selected index, click the icon.
   4. In the Minimum searches, enter the number of times a phrase must be searched before it is included in the suggestions.
   5. In the Minimum number of query results, enter the minimum number of search results that contain a given phrase before it is included in the suggestions.
   6. To define the minimum number of characters of a query to be involved in the query suggestion index, switch the Minimum number of letters in a phrase toggle on and enter the number. This way you can prevent no-result searches.
   7. To define the time range the search analyzes, switch the Only recent history toggle on. The time range covers the entered number of days backwards from today, including today (the filter is elastic and today is always a current date). When the toggle is switched off, it’s lifetime.
   8. To validate the queries against the product feed before the query suggestion index is built, switch the Verify suggestions toggle on.
   9. Optionally, you can add more indices. To do so, repeat steps a-g.
   10. Confirm the settings by clicking Apply.
5. To define the settings in the Attribute suggestions section, click Define.
   1. To select a catalog from which the attributes are taken, click Add attribute.
      Result: A pop-up appears.
   2. From the Catalog dropdown list select a catalog.
      Result: An Attributes dropdown list appears.
   3. From the Attributes dropdown list, select an attribute.
      • You can add several attributes in one line. Then the suggestions can include many variations of the attribute values (for example, for color and category added in one line, the suggestions could be: black shirt, green dress, red skirt, and so on).
      • You can add one attribute in one line. Then the suggestions will be displayed one at a time.
   4. To add more attributes from a selected catalog, click Add attribute. Repeat step c.
   5. To add more attributes from different catalog, close the pop-up and click Add attribute.
   6. Confirm the settings by clicking Apply.
6. To define the settings in the Manual suggestions section, click Define.
   You can manually add phrases to suggest. The visibility of the suggested phrases is based on their popularity. In this section, you define a phrase or phrases you want to be suggested and define artificially boosting their popularity.
   1. To add a phrase to the suggestion index, click Add phrases.
      Result: A pop-up appears.
   2. In the Phrase text field, enter a phrase.
   3. In the Number of additional searches field, enter the number of searches to add to the actual searches made with this phrase by customers. Thanks to manually adding search numbers, you can make sure that a phrase meets the minimum number of searches (set in Stats engine suggestions) and increase the probability of suggesting the phrase by the AI model.
   4. To add more phrases, click Add phrase and repeat step b and c.
   5. Confirm the phrases by clicking Add.
   6. Confirm the settings in the section by clicking Apply.
7. To define the settings in the Denylist section, click Define.
   1. To add phrases that will never appear in the query suggestions, click Add phrases.
      Result: A pop-up appears.
   2. In the Phrase text field, enter the phrase.
   3. From the Matching type, select the type of the phrase:
      • a phrase - the suggestion must match the whole pattern exactly.
      • partial word - any word of the suggestion must partially match the pattern.
      • full word - any word of the suggestion must exactly match the pattern.
      • regular expression - the pattern is treated as a regular expression and must match the suggestion.
   4. To add more phrases, click Add phrase and repeat step b and c.
   5. Confirm the phrases by clicking Add.
   6. Confirm the settings in the section by clicking Apply.
8. To activate the suggestions, click Save.