Share:
ClickHelp Documentation

Search Queries Report

The Search Queries report allows you to monitor the keywords queried by readers. To examine this report, open your Portal Dashboard and click Portal > Reports in the left-hand navigation panel. The Report Center page will open. Click Reader Behavior >  Search Queries in the left-hand navigation panel. And you'll see a chart.

  • Total. The total number of search queries both in Portal Search and Publications.
  • Portal Search. The global portal search queries. This happens when a reader uses the search box on the portal Home page or uses the "No Filter" mode on the portal Search page.
  • Publication. The number of search queries in a particular Publication. This happens when a reader uses the search box in the top-right corner of the topic reading page, this box defaults to searching in the current publication only, also giving the "Search entire portal" option that opens the portal Search page.

There is a table with data under the chart.

  • Query. The search query.
  • Query Count. The number of searches for that specific query.
  • Average Result Count. The arithmetic mean of the number of search results shown for all these queries.
  • Last Query On. The date when this query was made last.
  • Click Count. The number of search result clicks users made in the search results of a query.

For more precise and actionable analytics, reader behavior events (search queries, topic views) are not tracked for web crawlers and logged in authors, those events are only tracked for anonymous readers and logged in Power Readers.

How to interpret this statistics? Here are some use cases:

  • The Click Count for the "Harry" query is zero. It means that the found content isn't relevant to the search of readers, as they think. So you should consider adding a topic that answers that query, or changing the title of an existing topic so readers perceive it as a relevant topic to read.
  • As you see, the Average Result Count for the "Book" query is zero. It means that readers use this keyword for searching but there is no such topic in your documentation. Consider creating a topic that answers that query.
  • Last Query. Let's assume you rename a term in the product you document. The Last Query of the term was a year ago, for example. So you should ignore this query in your analysis, people don't search for it anymore. You can hide it by using filters.

The Full-Text Search engine indexes three sources of content:

  • topic content;
  • topic title;
  • topic Index Keywords.

Using Index Keywords is a good way to improve your search results when some term is not directly mentioned in a topic, but that topic is highly relevant to that term. Readers may find a topic by searching for a term used in the Index Keywords.

All the screenshots above represent the "Entire Portal" view of data. You can see the same reports for a specific project - just select it in the Report for drop-down box in the report header panel. Moreover, you can group, sort and filter the results. Learn more on this here: Working with Data Tables.