All Products
Search
Document Center

Blacklists and whitelists

Last Updated: Sep 09, 2021

Overview

Blacklists and whitelists are used to intervene in the candidate search queries of drop-down suggestions, top searches, and hints. Search queries that contain keywords in a blacklist do not appear in the candidate search queries. If a search query in a whitelist meets the recommendation condition, the search query preferentially appears in the candidate search queries.

If specific recommended results that appear in the candidate search queries do not meet your business requirements, you can add the keywords to a blacklist to block these results. If specific quality search queries are not recommended or rank low, you can add them to a whitelist to achieve manual intervention.

OpenSearch allows you to use blacklists and whitelists to intervene in the candidate search queries of drop-down suggestions, top searches, and hints.

Procedure

To preferentially display or block specific candidate search queries for your business, perform the following steps:

1.Create an intervention dictionary: In the left-side navigation pane, choose Search Algorithm Center > Search guide. On the Drop-down Suggestions page, click Black and white list in the left-side pane. On the Black and white list page, click Create.1

2.In the Create a black and white list panel, enter a name in the Name field, select Drop-down prompt whitelist or Drop-down prompt blacklist from the Type drop-down list, and then click Save.

2

3.On the Black and white list page, find the created intervention dictionary and click Manage Entries in the Actions column.3

Add an intervention entry.4

4.Add the configured intervention dictionary to the corresponding drop-down suggestion model.5678

Usage notes

  • Blacklists support inclusion matches. For example, if "garbage" is added to a blacklist, and the terms into which a candidate search query is segmented contain "garbage", the candidate search query is blocked.

  • If a blacklist conflicts with a whitelist, the blacklist takes precedence over the whitelist.

  • After you modify a blacklist or a whitelist, you do not need to retrain the corresponding model, and the blacklist or whitelist immediately takes effect.

  • Search queries in effect in a top search whitelist are displayed in the specified positions of top searches. If no recommended search queries are configured in corresponding positions, search queries are displayed in the order of the results of top search models.

  • Search queries in effect in a hint whitelist are rotated in a hint as recommended search queries.

  • You cannot delete blacklists or whitelists that are referenced by models.

Limits

  • You can add up to 500 entries to a drop-down suggestion blacklist.

  • You can add up to 500 entries to a drop-down suggestion whitelist.

  • You can add up to 500 entries to a top search blacklist.

  • You can add up to 10 entries to a top search whitelist.

  • You can add up to 500 entries to a hint blacklist.

  • You can add up to three entries to a hint whitelist.