Recommendations provides your shop users with recommended products e.g. on a product detail page. You can also create cart based or top seller recommendations. The possibilities are endless! In order to use the capabilities at their full potential we will guide you through them on this page.
After the Recommendation module has been enabled for your Makaira Instance, you can access the configuration section via the menu entry "Recommendations".
Create a Recommendation
When you want to create a new Recommendation (Reco), you'll be asked to enter the following information:
|Name||Similar Products||A name that describes your Reco|
|Identifier||similar-products||A unique identifier - you will need to provide this identifier when you integrate the Reco in your store pages via the Makaira API|
Your are not done yet! After you created the Recommendation, switch to the edit mode in order to adjust its settings.
Edit a Recommendation
After you created a Recommendation (Reco), you can edit it and adjust the available settings to your needs.
The following settings can be configured and adjusted:
Name and Identifier
Please take a look at the "Create a Recommendation" section for more details about these input fields.
By choosing an option, you define the data source for your Reco. The following options are available:
|Picture Similarity1||Products that look similar to the current product. (The image in the
|Text Similarity||Products that use a similar product description or have similarities in other text fields.|
|Bought together2||Products that are usually bought together with this product.|
|Behaviour history (Cart based)2||Other people who had this in their shopping cart also bought these products.|
|Behaviour history (User based)2||Other users who bought this also bought these products.|
|None||No base data will be used, you will have access to the "raw" product data thats imported to Makaira - can be used for Topseller Recos or Best Rated Recos or completely custom Recos where you don't want to rely on any sort of similarity / preweighted result.|
1: After you imported your picture url data in Makaira we will start calculating the picture similarity for you, please contact our Makaira Support for this.
2: Makaira Tracking is required in order to use this Recommendation Base.
Populate with Text Similarity
This option is not available for the following Recommendation Bases: Text Similarity, None
This option will add products based on the Recommendation Base "Text Similarity", if not enough results can be retrieved for your selected primary Recommendation Base.
Use our Preview feature by clicking the button "Preview" in the top right corner in order to see your changes in real time.
With filters, you can filter down the recommended products. You can either use concrete values or values based on the product that the recommendation is based on (input product).
The following comparators are available:
|Comparator||Required Data Type||Description|
|like||any||filter where field contains the value|
|not like||any||filter where field not contain the value|
|in list||any||filter where the field value is in the specified list|
|not in list||any||filter where the field value is not in the specified list|
|empty||any||filter where the field value is empty|
|not empty||any||filter where the field value is not empty|
|greater||int, float||filter where the field value is greater than|
|greater or equal||int, float||filter where the field value is greater than or equal|
|less||int, float||filter where the field value is less than|
|less or equal||int, float||filter where the field value is less than or equal|
|between||date||filter where the field value is between a range of period|
"Compare With" field
You can choose between the following options:
|Static Value||A static value is used for the comparison|
|Input Product||The value will be taken from the product that you sent during the request to the Makaira API.|
Usage of the filter function
Please watch the short video to see the filter functionality in action:
Use our Preview feature in order to see your changes in real time.
With this option you can boost specific products in your Recommendation.
The following comparators are available:
|use value||Special case for boosting: only for int/float fields - this boosts the product based on the value in the field (e.g. higher rated products to the front)|
|like||product with field contains the value will be moved to a higher position|
|not like||product with field not contain the value will be moved to a higher position|
|in list||product with field's value are in the list of selection will be moved to a higher position|
|not in list||product with field's value are not in the list of selection will be moved to a higher position|
|empty||product with field's value is empty will be moved to a higher position|
|not empty||product with field's value is not empty will be moved to a higher position|
Usage of the boosting function
Please watch the short video to see the boosting functionality in action:
Use Machine Learning
This feature only available if you use Makaira Tracking and if you have purchased the Machine Learning module!
This option allows you to automatically apply user-specific data (e.g. device, location) to your Recommendations.
You need to send the constraints IP, User-Agent, Timezone when making a request to the Makaira API (you can find more details in the "API Integration" section)
You can find more information about our Machine Learning module here.
This option allows you to reuse your Ranking-Mix on the Recommendations. When using this option, you don't have to reconfigure your general boosting settings.
This option adds some entropy to the results. The score of each recommended product may change randomly up to 20%. As a result a user may not always see the same recommendations and you can increase the probability that they may see something that interests them. We recommend to use this option only together with some additional boosting to make sure that the results are not completely random.
We are providing a preview feature, that can help you during the adjustment of e.g. Filter and Boosting settings. You can open the Preview in the upper right corner. Try out your settings by searching for a product and clicking on it in order to see recommended products.
Please watch the short video to see the Preview functionality in action: