Machine learning for search
Commerce can identify popular products associated with popular searches based on a number of factors, including shopper behavior and purchasing history, trend analysis, and view data, and automatically generate a corresponding set of ranking rules that boost these products in the related search results.
The machine-learning feature works in conjunction with dynamic curation and search relevancy. Manually-boosted products take precedence, followed by products identified by machine learning, with all remaining products ordered by relevancy and dynamic-curation criteria.
This feature affects only keyword search results and any subsequent navigation. It does not affect pages that contain only navigation results.
Understand auto-generated ranking rules
When the feature is enabled, Commerce periodically uploads the auto-generated popular products ranking rules to the /system/rankingRules
endpoint under internal-keywords
. You can view the auto-generated ranking rules by querying the following endpoint:
GET /gsadmin/v1/cloud/content/system/rankingRules/internal-keywords
Important: Do not attempt to modify the internal-keywords auto-generated ranking rules. Commerce will overwrite your changes.
The auto-generated popular products ranking rules take effect in your production environment whenever changes are published.
Only Boost/bury rules have higher precedence than the auto-generated popular products ranking rules. Popular products ranking rules take precedence over the default Relevancy ranking, Dynamic Curation, and static ranking rules.
Enable auto-generated popular products ranking rules
To enable this feature, you must use the Admin API:
- Run
GET /gsadmin/v1/cloud/configuration/services/internal-keywords
. - If
boostDisabled
is present in the response and set totrue
, then set it tofalse
. - Issue a
PUT
command to/gsadmin/v1/cloud/configuration/services/internal-keywords
to save your modifications.
Changes will take affect once the overnight process has run.
Disable auto-generated popular products ranking rules
To disable this feature, you must use the Admin API:
- Run
GET /gsadmin/v1/cloud/configuration/services/internal-keywords
. - If
boostDisabled
is present in the response and set tofalse
, then add it if necessary and set it totrue
. - Issue a
PUT
command to/gsadmin/v1/cloud/configuration/services/internal-keywords
to save your modifications. - Issue a
DELETE
command to/gsadmin/v1/cloud/content/system/rankingRules/internal-keywords
to delete previous rules.
Changes will take affect once the overnight process has run.
Identify Promoted Products
To identify when products have been promoted, you can access your site using the Preview environment and inspect the underlying ccstore/v1/search
endpoint call. Each promoted product includes an additional property of DGraph.RankLabel.bstratify.merch
.