Managing Synonyms

Synonyms in Magento are treated differently than how they are used in Klevu. In Magento, when someone says “beautiful” is a synonym for the word “gorgeous”, it literally means, if someone types in “gorgeous”, use the term “beautiful” to search. Do not use the term “gorgeous”. Also it is important that the entire query matches the words used for synonyms. In other words if someone says “gorgeous purse”, Magento will not replace the term “gorgeous” with the term “beautiful”.

Klevu, on the other hand, treats synonyms differently. If a customer types in “gorgeous”, Klevu will search for both the terms “gorgeous” and “beautiful”. Also, it doesn’t have to be the exact query. (i.e. searching for “gorgeous purse”, it will fire the following query

(gorgeous OR beautiful) AND purse

In case of the quick search UI, the query is directly submitted to the Klevu servers. The same is true for the landing page based on the Klevu template. In both the cases, synonyms provided in the Klevu Merchant center will be utilised to find the products.

If you are using the native layout option for the landing page, Magento will first look at the query and if there is any applicable synonym, it will replace the original query with the synonym specified in the Magento admin panel. This query is then submitted to the Klevu servers. If there are any synonyms applicable on this modified query, they will be utilised.

These synonyms, where applicable, are automatically added to the query at runtime and searched along with the original terms searched by the shoppers.

Follow the steps below for adding manual synonyms.

  1. For Magento and other platforms:
    Login into Klevu Merchant Center (https://box.klevu.com) with the registered email id and password
    For Shopify:
    Login into Shopify Admin → Apps → Klevu Search
  2. Choose the appropriate store from the drop down and Click on Synonyms tab
  3. For the Plus & Growth plan:
    1. Under the Interface tab, words that are synonyms of one other must be written on the same line with comma(,) as a separator.
    2. Click on Save button
    1. Under File Upload tab, upload a CSV file containing words that are synonyms of one other. Words that are synonyms of one other should be written on the same line with comma(,) as a separator. The file should have the maximum size of 1MB.Download sample CSV file.
    2. Click on Upload button
  4. For Premium plan:You can add the synonyms in two ways, 1. bi-directional(<=>) and 2. uni-directional (=>)
    Adding bi-directional synonyms:For example,
    Search term: beautiful
    Direction: <=> (bi-directional)
    Synonym: gorgeous, lovely, stunning

    Here, all the words (beautiful,gorgeous,lovely,stunning) are treated as synonyms of one other. In other words, when a shopper searches for one of these words, all the other synonyms of the same are searched as well.

    Adding uni-directional synonyms:

    For example,
    Search term: apple
    Direction: => (uni-directional)
    Synonym: ipod, iphone, ipad

    Here, when a shopper searches for the term “apple”, the words “ipod”, “iphone” and “ipad” too are searched. However, the vice-versa is not true.

    Under File Upload tab, you can upload a CSV file containing bi-directional or/and uni-directional synonyms. You can add both the type of synonyms in same CSV file.

    Download sample CSV file.

    Adding bi-directional synonyms:

    In a CSV file, words that are synonyms of one other should be written on the same line with comma(,) as a separator.
    For example, in CSV file you are adding the keywords as following

    beautiful, gorgeous, lovely, stunning
    Here, all the words are treated as synonyms of one other. In other words, when a shopper searches for one of these words, all the other synonyms of the same are searched as well.

     

    Adding uni-directional synonyms:

    To define the uni-direction in CSV file, => sign is used following with comma (,) separated words that are synonyms of that search term.

    For example, in CSV file you are adding the search term and synonym as following

    apple=>ipod, iphone, ipad

    Here, when a shopper searches for the term “apple”, the words “ipod”, “iphone” and “ipad” too are searched. However, the vice-versa is not true.

Please note, it takes up to 15 minutes to reflect the synonyms in search results.