An effective search engine is key to creating a great user experience and high conversion in any webshop. Raptor provides you with a simple, yet powerful search solution based on the open-source engine from Typesense.
In the Raptor Control Panel, you create a search index from your product feed and select parameters to show as facets on your website. On top of the search index, you can personalize search results using Raptor's renowned personalization strategies. Once set up, you implement the Typesense search UI on your website, providing you with full creative flexibility.
You can at any time edit a search index to fit the search experience you would like to deliver on your website.
This article will show how to configure and test a search index from your product feed.
Configure your search index
1. Log in to Raptor Control Panel
2. Go to Search Configurator in the menu
3. Click Configure search engine
4. Click Create Raptor Search. This will create a Typesense cluster hosted by Raptor utilizing Raptor's integration to Typesense. A search API key is generated. You will need the search API key when implementing the search UI on your website.
5. Now, you are ready to create a search index. Click Create new index in the top right corner. You will open the configuration screen:
6. Give the index a suitable name. The name is needed when you implement the search UI, and cannot contain special characters, spaces nor uppercase letters.
7. Select the product feed the index should be based upon (if no feeds are available, please reach out to Raptor)
Now, you need to select the parameters from your product feed, you would like to map to the index and thereby make searchable.
Product ID and Product Name are required and included in the index per default.
8. Include parameters from your feed by clicking + Add new mapping
9. Select parameter in the first dropdown and give it a suitable name in the text box.
10. Check if the data type is correct - if not, you can change it. The data type dictates which Typesense UI features can be used when displaying the parameter as a facet on your website, e.g. decimals (like price) can be showed as a slider or interval radio buttons for the user to narrow down a search.
11. Switch the Include in facet-button on, if you would like the parameter to appear as a filter on the search page - this will often be the case with parameters like Brand, Category, Stock status and Price. If attributes like color, size, reviews, certifications etc. are present in your product feed, these are great to include as facets.
12. Switch the Required-button to exclude products from being searchable that do not contain information in the parameter.
NOTE: Make sure to map the parameter ImageURL to fetch images for your search results. Images should not be included as a facet.
13. When you are happy with your setup, click Create. This will create the index and save it as a draft.
14. Click Save & publish to finalize your index and make it available for implementation.
Test your search index
When you have configured and published your search index, you can test it.
1. In the Search index list, click Test on the search index you will like to test
2. You will now go to a test site with a main search field in the top and all the facets you included in your index to the left. The search field in the top will by default search in product names. Test that you find the expected products when searching.
By hovering the product previews, you can see the information that is delivered in the search output (including basic information like ID, name, brand, category and technical information like text match score)
3. By clicking the Settings-button in the upper right corner, you will open a new window. Here, you can configure the parameters the main search field searches in and which relative weights each parameter should have. In the screenshot below, the parameter category is added, but with half the weight of the product name. This means that search results matching the product name will have twice the weight as results matching the category (and thereby take priority). If the weights are of equal value, the order of the parameters will dictate the priority.
NOTE: The weights are only set for test purposes in order for you to find the desired settings and are not automatically transferred to Typesense. You can set the same weights in Typesense manually when implementing.
More search features and settings will be added to the solution continuously.
Implement a search UI on your website
Once configured and tested, you can implement a search UI based on the guide from Typesense. Find the guide here.