Managed keywords are a way to control and merchandise the results for a specific search term. They can be created by region or globally, and they allow you to override nearly all engine-level settings, including thresholds and sorting logic.
Creating a Keyword
When first setting up a new keyword, you will need to choose a region that the keyword will be linked to.
.png "image(7).png")
Each keyword can be managed using four distinct sections:
Settings
Results
Pinned
Excluded
Settings
Once a keyword has been created, the first set of options you will have is the Settings, where you can configure all of the basic functionality of the keyword. The available settings will change based on which keyword type you select:
Exact Match Keyword
Exact match keywords allow you to alter the search results for a specific keyword. The user's entire query must match exactly with the keyword.
For example, if the keyword is "shirt" and the user searches for "shirt," the keyword will match, but if they search for "blue shirt," the keyword will not match.
Here you can configure a wide range of options:
Expiration
If you want the Managed Keyword to expire after a certain time (for example, if you’re pinning products around an event or a sale period), you can set the expiration against a specific date and time.
.png "image(9).png")
Force No Results
If you want the keyword to be blocked with no results, you can set this option to true.
.png "image(10).png")
Select Region
If you want to change the region you set when creating the keyword, you can do so here.
.png "image(11).png")
Result Options
Here you have the ability to control which results will be returned by the keyword:
.png "image(13).png")
Pinned + Search Results: If you have pinning setup (either with manually selected pins or Pin By Product Filter, this option will return all of your pinned products followed by standard search results.
Pinned Only: This option will force the keyword to only return the pinned products (manually selected or those from a Pin By Product Filter)
Pin By Product Filter
.png "image(14).png")
This feature allows you use an existing Product Filter to automatically pin the results of that filter as the first results of this keyword. If selected, you can also determine how many products to pin (or, alternatively, select “Pin All Products”).
If you select Pinned + Search Results & Pin By Product Filter, you will not be able to apply custom sorting logic.
Keyword Synonym
Redirect synonyms allow you to point multiple synonyms to the results of a single keyword to prevent needing to reconfigure the exact same settings repeatedly. When a synonym redirects, the results, pinned products, excluded products, and keyword settings will all match the keyword it is redirected to. If a synonym is added that conflicts with an existing keyword, you will be asked to delete and migrate that keyword to the current keyword being managed, which effectively combines the synonym records.
Search Type
Here you can override the Engine settings to determine whether the results of this keyword will come from DeepSearch or GenSearch, as well as overriding the Engine-level threshold settings.
Sorting
.png "image(17).png")
To override the sorting algorithm applied at the Engine level, you can select from one of the following options:
Algorithm | Description | Options |
|---|---|---|
Search Engine Relevance | This is the default sorting, and will have all results sorted by relevance to the query itself. | None |
Current Recommendation Engine | This will sort the results against relevancy to the individual, based on the current XRecommend model that has been deployed |
|
Product Filter | Sorting by a Product Filter allows you to make sure that products that meet the condition of the filter show up first. |
|
Bestsellers | This will sort the results by arranging them in sequence of bestseller rank, with the top sellers first. |
Metrics available: Revenue, Quantity |
Most Viewed | This will sort the results by arranging them in sequence of most viewed, with the most viewed products first. |
|
.png "image(18).png")
.png "image(19).png")
.png "image(22).png")
.png "image(23).png")
Sorting is not applied to manual pins - they will appear in the sequence that is manually configured
Cache
.png "image(24).png")
If you want to override whether the cache is used for this keyword, you can configure this here. Otherwise, caching settings at the Engine level will apply.
Input Language
.png "image(25).png")
For highly-custom use cases where language control is important, you can also manually override which language any translation services should start from.
Managed Frequency
.png "image(26).png")
The managed frequency for a managed keyword is the percentage that the settings set for a keyword will be applied. For instance, if you were to set the managed frequency at 50%, then half of the time the keyword is searched, it would follow the selected settings of pinned and excluded products, and the other half of the time, would respond as any other query.
Results
The Results tab will show the output of the Keyword against all currently saved settings. This does not reflect unsaved changes.
.png "image(29).png")
Within the results page, if your Keyword Type is Exact Match, you can Exclude or Pin any product that is shown, as well as adjust the sequence of products that you have pinned.
Selecting Your Preview Engine:
You can select which engine will be used to return all non-pinned products using the drop-down on the top right of the results tab:
.png "image(34).png")
Selecting Attributes:
For ease of use, you can also add any available attribute to the product tiles shown using the “Show Attributes” drop-down at the top right of the tab:
.png "image(38).png")
Pinned
If you have pinned products (or you want to find products to pin), you can also use the “Pinned” tab to manage this specifically:
.png "image(40).png")
Find a Product to Pin
You can also find products to pin by clicking “Pin a product”:
.png "image(30).png")
This will open a modal window for you to search and add products to pin.
.png "image(32).png")
Excluded
If you have excluded products (or you want to find products to exclude), you can use the “Excluded” tab to manage this specifically:
.png "image(39).png")
URL Redirect
.png "image(27).png")
In some cases, you may want to redirect certain queries to specific pages - for example, if someone searches for “Sustainable,” you may want to redirect them to a custom landing page for sustainability. Setting a keyword to a URL Redirect will allow you to accomplish this.
Activating a URL Redirect
While this setting will adjust the output of the keyword to be the URL specified, the front-end component must also be configured to use this URL for navigation or display. If the experience is rendered directly through XGEN AI experiences, this can be configured in the XSearch Experiences section.