--- title: FAQ slug: '1873' canonical_url: https://docs.coveo.com/en/1873/ collection: coveo-analytics source_format: adoc --- # FAQ This article contains a list of frequently asked questions about [Coveo Analytics](https://docs.coveo.com/en/182/). If you're not sure where to begin, see the [Get started](https://docs.coveo.com/en/1769/) article. ## How is the Relevance Index calculated? The exact formula for calculating relevance is complex. In short, several [metrics](https://docs.coveo.com/en/263/) are combined, such as the [Search Event Clickthrough](https://docs.coveo.com/en/2837/) ratio, the [Average Click Rank (ACR)](https://docs.coveo.com/en/2836/), and the frequency at which an [item](https://docs.coveo.com/en/210/) is queried or a [query](https://docs.coveo.com/en/231/) is submitted. See [Relevance Index Metric](https://docs.coveo.com/en/3318/) for more details. ## What's a user visit? A [user visit](https://docs.coveo.com/en/1964/) is the period in which a user is active on a site. Also known as a _session_, a [visit](https://docs.coveo.com/en/271/) begins when a user with a unique combination of [client ID](https://docs.coveo.com/en/lbjf0131/) and/or [visit ID](https://docs.coveo.com/en/272/), organization ID, and [user ID](https://docs.coveo.com/en/268/) accesses a [search interface](https://docs.coveo.com/en/2741/). The visit ends after 30 minutes of inactivity. If the user leaves the site and returns before 30 minutes, the visit remains active. > **Notes** > > * The visit is persisted when a user switches from authenticated to anonymous, or the opposite. > > * When users switch to a second authenticated user, a new visit associated with the new user is created. > > * Two [events](https://docs.coveo.com/en/260/) must have the same account (organization ID), user ID, and either client ID or visitor ID (or both) to be considered in the same visit. > > ** If both the [client ID](https://docs.coveo.com/en/masb0234/) and [visitor ID](https://docs.coveo.com/en/2948#visitor-id) are present, the client ID takes precedence regardless of the value. > > ** Keep the same values at all times for the client ID and the visitor ID. > > * There can be simultaneous visits for a single client ID or visitor ID, as long as they're in different [Coveo organization](https://docs.coveo.com/en/185/). The following diagram indicates how Coveo Analytics keeps track of user visits: ![Diagram showing how Coveo Analytics keeps track of user visits](https://docs.coveo.com/en/assets/images/coveo-analytics/user-visit.png) ## Why are date and time values different in reports and exports? The data displayed in [reports](https://docs.coveo.com/en/266/) or the [**Visit Browser**](https://platform.cloud.coveo.com/admin/#/orgid/usage/visit/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/usage/visit/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/usage/visit/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/usage/visit/)) uses the browser's time zone. In Coveo Analytics reports, the date and time values that appear on the horizontal axis of graph cards and the values of [dimensions](https://docs.coveo.com/en/258/) such as Day and Hour are automatically converted to the time zone of the user's browser. Therefore, when your analysts manage [data](https://docs.coveo.com/en/259/) specifically from their time zone, they can review the same reports with filters adapted to their city or country. However, in [data exports](https://docs.coveo.com/en/257/) performed through the [**Data Exports**](https://platform.cloud.coveo.com/admin/#/orgid/usage/raw-data/data-exports/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/usage/raw-data/data-exports/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/usage/raw-data/data-exports/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/usage/raw-data/data-exports/)) and [**Visit Browser**](https://platform.cloud.coveo.com/admin/#/orgid/usage/visit/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/usage/visit/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/usage/visit/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/usage/visit/)) pages, and in the **Data Explorer** panel, time and date values are always returned in UTC (GMT) time zone. Consequently: * Analysts can see the same data in exports when they review the same date range, regardless of their time zone. * Times and dates can be different in the exports and CSV files, but the values still represent the same instant in time. ## What's the database schema of the different tables that I see when doing an export? This depends on how your implementation was set up to send analytics [events](https://docs.coveo.com/en/260/) to Coveo. Each search [event](https://docs.coveo.com/en/260/) export can involve many clicks, groups, and keywords. A user query can be followed by `0` to `n` clicks, a query can contain `0` to `n` keywords, and the user submitting a query can belong to `0` to `n` groups. Therefore, the `SearchId` is the link between clicks and searches, between keywords and searches, and between groups and searches. See [Data export tables](https://docs.coveo.com/en/l9fb0345#data-export-tables) for details. ## Why can't I see some search metrics in my reports? Search [metrics](https://docs.coveo.com/en/263/) are calculated from captured [events](https://docs.coveo.com/en/260/) such as searches, clicks, and [visits](https://docs.coveo.com/en/271/). When certain metrics aren't showing up in [reports](https://docs.coveo.com/en/266/), it usually means that the underlying events weren't captured or were excluded from reporting. Common reasons include: * `interfaceLoad` events [are excluded from most reports](#why-are-interfaceload-events-excluded-from-most-reports). * The events haven't [finished processing yet](#how-long-does-it-take-for-a-new-event-to-be-available-in-reports). * There are [too many filters](#why-do-i-get-the-no-search-statisticsno-matching-results-error-messages-in-my-report) applied to the report, minimizing the dataset. ### Why are `interfaceLoad` events excluded from most reports? ![`interfaceLoad` report filter | Coveo Platform](https://docs.coveo.com/en/assets/images/coveo-analytics/admin-ua-faq.png) The main purpose of analytics [reports](https://docs.coveo.com/en/266/) is to analyze user activity, [queries](https://docs.coveo.com/en/231/), and [item](https://docs.coveo.com/en/210/) relevance. However, not all queries constitute real user activity as some queries aren't triggered by users. Some are automatically generated ([`interfaceLoad` events](https://docs.coveo.com/en/2948#interfaceload-performsearch)) and are excluded in most reports. **Example** In [Coveo for Salesforce](https://docs.coveo.com/en/1404/), similar cases (results from a Coveo search) can automatically be displayed in the case console when an agent opens a case. Since the user never explicitly interacted with the search system to get the results, these searches aren't considered real activity. ### How long does it take for a new event to be available in reports? The search analytics service handles [events](https://docs.coveo.com/en/260/) asynchronously. Typically, your events will be available within 15 minutes. ## Why do I get the `No search statistics`/`No matching results` error messages in my report Both messages are shown in Coveo Analytics [cards](https://docs.coveo.com/en/267/) when data doesn't match the query. The filters applied in your report may be too precise or may be filtering out all the data in the cards at issue. More often than not, adjusting the filter or removing [dimensions](https://docs.coveo.com/en/258/) that caused [metric](https://docs.coveo.com/en/263/) values to be diluted in a card resolves the issue. The more precise the scope of a dimension is, when mixed with other dimensions, the more chances those error messages appear. ## What's the `n/a keyword` value in reports? When analyzing [dashboards](https://docs.coveo.com/en/256/) and [explorers](https://docs.coveo.com/en/261/), **n/a keyword** can appear as a **Keyword** [dimension](https://docs.coveo.com/en/258/) value. * The n/a keyword* is typically displayed in reports when a user accesses a Coveo-powered [search interface](https://docs.coveo.com/en/2741/) with the [`allowQueriesWithoutKeywords`](https://coveo.github.io/search-ui/components/searchinterface.html#options.allowquerieswithoutkeywords) option set to `true`. The **n/a keyword** is also displayed when an end user submits a blank [query](https://docs.coveo.com/en/231/) to your search interface. Depending on your context, you may want to avoid users obtaining these result items when they first access your search interface (`interfaceLoad` events) (see [Prevent Queries Without Keywords](https://docs.coveo.com/en/389/)). To keep these result items being displayed to your users, you can also [exclude these queries from your reports](https://docs.coveo.com/en/2962/). > **Important** > > If you already [disabled empty queries in your search interface](https://docs.coveo.com/en/389/) after it loads the first time and still have several **n/a keyword** occurrences in your reports, you may need to further investigate the situation as it might be the result of an implementation issue. ## What's the maximum number of custom dimensions that can be used? You can create up to 25 custom dimensions in a [Coveo organization](https://docs.coveo.com/en/185/). For [Coveo for Salesforce](https://docs.coveo.com/en/1404/), the number of allowed custom dimensions depends on the [edition](https://docs.coveo.com/en/l2590456#salesforce-service-solutions). > **Note** > > Custom data can only be leveraged when using the UA Protocol. > If your Coveo implementation uses the [Event Protocol](https://docs.coveo.com/en/o3r90189/), custom dimensions and metrics shouldn't be added to a report since they won't function as expected. ## Why are there search event count discrepancies? The discrepancies in search event counts may occur because of how search events and clicks are recorded. The sum of the search event counts in detailed tables may not match the global search event count because a single search event can result in multiple clicks. Each click is recorded separately, which can cause the sum of these events to exceed the actual number of search events initiated by users. This occurs because users might click several different results within the same query​​​. **Example** In the following screen capture, the search event count in the **Metric Time Series** card is three, but the sum of the search event count in the **Table** card is five. ![Search Event Count metric dashboard | Coveo](https://docs.coveo.com/en/assets/images/coveo-analytics/metric-time-series-card-search-events.png) ## Why are there visit count discrepancies between the Visit Browser and my reports? The difference occurs when certain events (mainly clicks and searches) aren't registered as belonging to the same [visit ID](https://docs.coveo.com/en/272/). This can happen in the following situations: * User browser blocks cookies, and therefore the visit is lost between each action. * User leaves the browser open for more than 30 minutes, then resumes interactions with search results. * Sometimes, an implementation doesn't properly set a visit tracking cookie. In all three scenarios, the Visit ID is different for a search and a click even though the click and the search have the same Search ID. ### General information * The [Visit Browser](https://docs.coveo.com/en/274/) (and **Visit Metric** card) visit count only considers the Visit ID when linking events. Therefore, the **Visit Browser** can be used for troubleshooting improperly tracked visits as well as allowing visit metric cards to use filters on the complete visit instead of individual events. * Coveo Analytics [reports](https://docs.coveo.com/en/266/) use the Search ID in addition to the Visit ID when linking events. Most [report cards](https://docs.coveo.com/en/267/) (except for the **Visit Metric** card) use the Search ID to minimize the impact of improperly tracked visits on the Has Clicks dimension and the [Search Event Clickthrough](https://docs.coveo.com/en/2837/) (%) [metrics](https://docs.coveo.com/en/263/). The Search ID is more reliable since the Search ID doesn't rely on a tracking cookie, which can lead to different values when looking at the Visit Count. * [Coveo JavaScript Search Framework](https://docs.coveo.com/en/187/) has a visit tracking mechanism that reduces the occurrences of Search ID versus Visit ID discrepancies. Only the Visit ID is used to measure visit count since events from improperly tracked visits are rejected.