Synonyms Guideedit
Synonyms relate queries together that contextually have the same meaning in your dataset.
Sometimes users will use different terminology than your context might expect.
This can lead them to poor search relevance: you are selling movies, but they want films!
The Synonym feature builds synonym sets. A synonym set contains two or more queries that have similar meaning.
The queries can be synonyms, but they do not need to be.
Each item within a synonym set is a query. A query can be a string made up of one or more words.
Once a synonym set has been created, it will be applied to all future queries.
You can create them via the API or the Dashboard.
A synonym set can contain up to 32 words.
Precision tuning has no effect in queries that contain synonyms.
APIedit
You may construct, list, or delete synonym sets using the /synonyms API endpoint.
Example
curl -X POST '<ENTERPRISE_SEARCH_BASE_URL>/api/as/v1/engines/national-parks-demo/synonyms' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer private-xxxxxxxxxxxxxxxxxxxx' \ -d '{ "synonyms": ["summit", "peak", "cliff", "mountain"] }'
Example Response
{
"id": "syn-33dh34689rre8994g5h94i0nf4",
"synonyms": [
"summit",
"peak",
"cliff",
"mountain"
]
}
Each synonym has a unique id which you can use to display or delete the synonym set after it has been created.
See the Synonyms API Reference for further information.
Dashboardedit
To manage synonyms through the App Search dashboard, see the following video walkthrough:
Or, review the following instructions:
Within the dashboard, click into an Engine.
The Engine navigation menu has Search Settings section.
Under it you will find Synonyms alongside Curations and Relevance Tuning. Click into Synonyms.
Next, select Create a Synonym Set and then enter an assortment of queries.
Synonyms - A synonym set within the dashboard.
Once you click Save, the synonym set will be applied.
To remove the synonym set, click Manage, then Delete.
The moment it is deleted, the set will no longer influence your search results.
Note on Performanceedit
Each Synonym Set that is defined will be analyzed by each query to determine if the synonyms in this set should be applied to the given query. This means that defining a large number of Synonym Sets will have an impact on query latency, and too many Synonyms Sets can cause a slowdown in performance. Consider consolidating your Synonym Sets into as few sets as possible, and remove Synonym Sets that are no longer necessary for optimal performance.
What’s Next?edit
Configuring Synonyms is a useful way to guide your users to the most relevant content. It is most useful when you know the precise terms that they are searching for. For that, you should explore the Analytics and Clickthrough end-points, so that you are aware of your insightful capabilities. If you are looking to provide even more precise and curated results, venture to the Curations end-point.