Top search report - OpenSearch - Alibaba Cloud Documentation Center

The top search report tracks how users see, click, and act on top search suggestions — including browsing, purchasing, and empty-result rates. Use it to evaluate your top search configuration and identify areas to improve.

View the report

In the left-side navigation pane, choose Report Statistics > Top search report. Select an application from the Application Name drop-down list and a model from the Model name drop-down list. Then select a metric type and a time range, and view the statistical charts.

Click a metric category tab — Core metrics, Traffic metrics, Click metrics, or Guided search metrics — then set the date picker to the time period you want.

Data availability

Single-day view: The report displays data for the previous day by default. Use the date picker to select a different day.
Trend view: Line charts show metric trends for the last seven days by default. Click a metric's icon to display its line chart. Use the date picker to select a different period.
Data delay: After you upload behavioral data, the report reflects that data starting the next day (T+1).

Metric categories

Top search metrics fall into four categories: core metrics, traffic metrics, click metrics, and guided search metrics.

Metrics that depend on user click behavior require data collection to be enabled and behavioral data to be uploaded. Metrics that depend on from_request_id, raw_query, or user_id require these fields in your API requests or SDK calls.

Core metrics

Core metrics combine top search traffic, engagement, and guided-search performance in a single view.

Metric	Definition	Calculation	Dependency	Significance
Hot search PV	Number of successful top search requests (page views, PV). Throttled or otherwise failed requests are excluded.	Counts each request that receives a success response	—	Number of top search requests that returned a success response on the day
Hot search UV	Number of distinct users (unique visitors, UV) who received top search results. Failed requests and duplicate users are excluded.	Unique `user_id` values in successful requests	`user_id` in top search requests	Number of users who made top search requests on the day
Hot search request error times	Number of top search requests that returned an error (for example, due to throttling)	Counts each request that receives an error response	—	Indicates whether top search needs to be scaled out or otherwise adjusted
Hot search PV-CTR	Click-through rate (CTR) of top searches based on page views	Hot search IPV ÷ Hot search PV	`raw_query` and `from_request_id` in search requests	Click-through performance of top searches
Hot search UV-CTR	CTR based on unique users	Hot search IPV_UV ÷ Hot search UV	`raw_query` and `from_request_id` in search requests; `user_id` in top search requests	Click-through performance among top search users
Hot search TOP3 PV-CTR	CTR for the top three searches	Clicks on the top 3 searches ÷ Hot search PV	`from_request_id` in search requests	Click-through performance of the top 3 search results
Guided search PV ratio	Share of all searches that originate from a top search click	Guided search PV ÷ Search PV	`from_request_id` in search requests	Share of searches driven by top searches
Guided search PV-CTR	CTR of searches that users triggered by clicking a top search. Measures item page view (IPV) rate for guided searches.	IPV of guided searches ÷ Guided search PV	`raw_query` and `from_request_id` in search requests; data collection feature; uploaded click behavioral data	Measures the retrieval and ranking effectiveness of top search-guided searches

What these numbers tell you

A low Hot search PV-CTR or Hot search UV-CTR means users are seeing top search suggestions but not clicking them. Review whether your top search terms match actual user intent.
A high Hot search request error times count suggests throttling pressure. Consider increasing your top search quota or adjusting the configuration.
A low Guided search PV ratio means top searches are not driving a significant share of overall search traffic. Check whether top searches are prominently displayed.
A low Guided search PV-CTR indicates that searches triggered by top search clicks are returning results users do not find relevant. Review retrieval and ranking configuration for guided searches.

Traffic metrics

Traffic metrics focus on request volume and error rates for the top search feature itself.

Metric	Definition	Calculation	Dependency	Significance
Hot search PV	Number of successful top search requests. Throttled or otherwise failed requests are excluded.	Counts each request that receives a success response	—	Number of top search requests that returned a success response on the day
Hot search UV	Number of distinct users who received top search results. Each user is counted once.	Unique `user_id` values in successful requests	`user_id` in top search requests	Number of users who made top search requests on the day
Hot search request error times	Number of top search requests that returned an error	Counts each request that receives an error response	—	Indicates whether top search needs to be scaled out or otherwise adjusted
Hot search request error rate	Ratio of failed requests to all top search requests	Hot search request error times ÷ (Hot search PV + Hot search request error times)	—	Indicates whether top search needs to be scaled out or otherwise adjusted

What these numbers tell you

A rising Hot search request error rate is a signal to adjust your top search configuration — for example, by increasing the number of available top searches or raising your quota.
Monitor Hot search UV alongside Hot search PV: a large gap between the two means some users are making many requests, which may indicate retry behavior caused by errors.

Click metrics

Click metrics measure how users interact with top search results after clicking a suggestion.

Metric	Definition	Calculation	Dependency	Significance
Hot search IPV	Number of clicks on top searches	Counts each click on a top search	`from_request_id` in search requests	Number of clicks on top search results
Hot search IPV_UV	Number of distinct users who clicked a top search. Each user is counted once.	Unique users among those who clicked top searches	`raw_query` and `from_request_id` in search requests; `user_id` in top search requests	Number of users who clicked top search results
Hot search PV-CTR	CTR of top searches	Hot search IPV ÷ Hot search PV	`raw_query` and `from_request_id` in search requests	Click-through performance of top searches
Hot search UV-CTR	CTR based on unique users	Hot search IPV_UV ÷ Hot search UV	`raw_query` and `from_request_id` in search requests; `user_id` in top search requests	Click-through performance among top search users
Hot search has clicked PV ratio	Ratio of top search requests whose results were clicked to all top search requests	Requests whose results were clicked ÷ Hot search PV	`from_request_id` in search requests	Click-through performance of top searches
Hot search TOP1 PV-CTR	CTR for the top one search	Clicks on the #1 search ÷ Hot search PV	`from_request_id` in search requests	Click-through performance of the #1 search result
Hot search TOP3 PV-CTR	CTR for the top three searches	Clicks on the top 3 searches ÷ Hot search PV	`from_request_id` in search requests	Click-through performance of the top 3 search results
Hot Search TOP5 PV-CTR	CTR for the top five searches	Clicks on the top 5 searches ÷ Hot search PV	`from_request_id` in search requests	Click-through performance of the top 5 search results

What these numbers tell you

Compare Hot search TOP1 PV-CTR, Hot search TOP3 PV-CTR, and Hot Search TOP5 PV-CTR together. A steep drop from TOP1 to TOP3 suggests users find only the first suggestion relevant; consider refreshing the #2 and #3 suggestions.
A low Hot search has clicked PV ratio means many users see top search results but none of them click. This is an early signal that top search content may be stale or misaligned with current user intent.
Click metrics require the from_request_id field in search requests. If all CTR values show as zero, verify that your integration passes this field.

Guided search metrics

Guided search metrics measure what happens after users click a top search suggestion and run the resulting search.

Metric	Definition	Calculation	Dependency	Significance
Guided search PV	Number of searches triggered by clicking a top search. Includes paging requests.	Counts each search initiated from a top search click	`from_request_id` in search requests	Number of searches driven by top searches
Guided search PV ratio	Share of all searches that originate from top search clicks	Guided search PV ÷ Search PV	`from_request_id` in search requests	Share of searches driven by top searches
Guided search UV	Number of distinct users who clicked a top search. Each user is counted once.	Unique users who triggered at least one guided search	`user_id` and `from_request_id` in search requests	Number of users driven to search by top searches
Guided search UV ratio	Share of all top search users who clicked a top search suggestion	Guided search UV ÷ Search UV	`user_id` and `from_request_id` in search requests	Share of users driven to search by top searches
Guided search no result rate	Ratio of guided searches that returned empty results	Guided searches with no results ÷ Guided search PV	`from_request_id` in search requests	Number of top search-guided searches that returned no results
Guided search PV-CTR	CTR of guided searches — the ratio of guided searches that led to an item page view	IPV of guided searches ÷ Guided search PV	`raw_query` and `from_request_id` in search requests; data collection feature; uploaded click behavioral data	Measures the retrieval and ranking effectiveness of top search-guided searches
Guided search has clicks on the percentage of PV	Ratio of guided searches whose results were clicked to all guided searches	Guided searches whose results were clicked ÷ Guided search PV	`from_request_id` in search requests; data collection feature; uploaded click event data	Share of top search-guided searches that received clicks; measures retrieval and ranking effectiveness
Guided search for GMV	Gross merchandise volume (GMV) from purchases guided by top searches	Sum of transaction amounts from top search-guided sessions	Data collection feature; uploaded purchase behavioral data (`bhv_type = buy`)	Measures the purchase effectiveness of top search-guided searches
Guided search favorite conversion rate	Ratio of times when users add items to favorites from the results of top search-guided searches to all top search-guided searches	Favorites additions from guided searches ÷ Guided search PV	Data collection feature; uploaded favorites behavioral data (`bhv_type = collect`)	Measures the favorites effectiveness of top search-guided searches
Guided search to the shopping cart conversion rate	Ratio of times when users add items to the shopping cart from the results of top search-guided searches to all top search-guided searches	Cart additions from guided searches ÷ Guided search PV	Data collection feature; uploaded cart behavioral data (`bhv_type = cart`)	Measures the add-to-cart effectiveness of top search-guided searches
Guided search like conversion rate	Ratio of times when users like items in the results of top search-guided searches to all top search-guided searches	Likes from guided searches ÷ Guided search PV	Data collection feature; uploaded like behavioral data (`bhv_type = like`)	Measures the like effectiveness of top search-guided searches
Guided search review conversion rate	Ratio of times when users post comments on items in the results of top search-guided searches to all top search-guided searches	Comments from guided searches ÷ Guided search PV	Data collection feature; uploaded comment behavioral data (`bhv_type = comment`)	Measures the comment effectiveness of top search-guided searches

What these numbers tell you

A high Guided search no result rate means top search suggestions are directing users to searches with no matching results. Update your top search terms to reflect terms that return results, or expand your search index to cover common top search queries.
A low Guided search PV-CTR or Guided search has clicks on the percentage of PV means the results returned after a top search click are not engaging. Review the retrieval and ranking configuration for those query terms.
Guided search for GMV, Guided search favorite conversion rate, Guided search to the shopping cart conversion rate, Guided search like conversion rate, and Guided search review conversion rate require behavioral data upload with the corresponding bhv_type values. If these metrics show no data, verify that your data collection pipeline is uploading events with the correct bhv_type field.