Reviewing User Visits With the Visit Browser

You can use the Visit Browser in the administration console navigation menu to search and browse user visits (see Required Privileges). The Visit Browser can be used for various purposes such as validating an implementation from a quality assurance perspective or making sure that all events are logged properly.

The Visit Browser provides a way to first select visits that meet some criteria (e.g., visits in which a case deflection happened), and then review the events in the order they occurred in each of those visits.

  • By default, the Visit Browser shows 50 visits per page and 250 events per visit. However, all events that occurred in the visits are available when you export the visit data (see Export Visit Data That Meet Your Criteria).

  • Permission filters act as inclusion filters if at least one event during a user visit matches the filter. It is thus not recommended to use permission filters to filter out user visits (see Add Filters to Narrow the Visits Down to Only Those You Want and Managing Permission Filters).

    The permission filter Custom Event Value is not Case Deflection will still show visits in which a case deflection occurs if another custom event was performed during those visits.

    You should instead use exclusion filters to filter out visits containing specific events (see Exclusion Filters).

  • You cannot remove events from a visit, either the visit contains an event that matches the specified criteria or the visit is filtered out.

  • The Visit Browser is updated live to show the latest visits.

Access the “Visit Browser” Page

  1. If not already done, log in to your Coveo Cloud organization with a user that is a member of a group with the required privileges to review user visits in the Visit Browser (see Required Privileges).

  2. In the navigation bar on the left, under Analytics, select Visit Browser.

Set the Date Interval Over Which You Want to Review Search Usage Data

  1. Access the Visit Browser page (see Access the Visit Browser Page).

  2. In the [Visit Browser] page, in the top right corner of the window, you can quickly go from the current selected date interval (last week, month…) to the previous period or next period by clicking the left (Icon-LeftArrowb) and right (Icon-RightArrowb) arrow icons respectively. Alternatively, you can click the box containing the actual date range (e.g., Icon-ActualDateRangeb - by default the last 7 complete days) to access the Report Period dialog, and then select the date range you want to review (see Setting the Period to Review Search Usage Data).

    You can select a period that is incomplete (e.g., the current month), in which case your date range selection will always include the latest available visits until the period ends (e.g., the first day of the following month).

    You are reviewing data per Month and want to see how visits are trending for the first two weeks of the current month, so you click the right arrow icon (Icon-RightArrowb).

Add Filters to Narrow the Visits Down to Only Those You Want

You can proceed different ways to only keep the visits you want to review. You can add inclusion filters, exclusion filters, or a combination of both inclusion and exclusion filters. When you only add exclusion filters, all visits are shown, except the ones containing an event that meets your criteria.

You want to investigate what users who never use the search bar do in their visits, so you exclude all visits containing a manual query.

  1. Access the Visit Browser page (see Access the Visit Browser Page).

  2. (Optional) On the Visit Browser page, when you want to add exclusion filters, select the Exclude visits containing check box.

    You want to analyze user sessions containing a specific query, but in which no support cases were created, so you select the check box to then be able to add the following filter:

    Admin-VisitBrowserExclFiltersb

  3. Click an event, and then select between four event types (an event, a search event, a click event, or a custom event).

  4. Access the dialog to add global dimension filters by clicking the filter addition icon (Icon-FilterAdditionc) (see Adding Global Dimension Filters).

    Admin-VisitBrowserFiltExd

    Once created, the filter(s) appear(s) in the top bar under Show visits containing or Exclude visits containing and only the user visits meeting your criteria appear.

    • You can add filters to apply on another event type by clicking And at least. The visits that appear will then match these two parameters.

      You want to browse user visits in which an item was opened and a case deflection occurred.

      Admin-VisitBrowserFiltExe

    • Under Show visits containing, when you add a filter with a negative operator (e.g., is not or does not contain), the filter will act as an exclusion filter instead of an inclusion filter.

      You want to review visits that contains events of users that are not from New York with the following filter: an event where City is not New York. All visits from New York users will thus be excluded.

    • Once you are done with the filters, you can bookmark the web page or copy/paste the URL in the place of your choice to be able to later access the same state of the Visit Browser.

    • You can add a named filter with the current filters on a line:

      1. At the right-end of the bar, click the action icon (Icon-FilterActionb), and then select Save filter as or Save filters as.

      2. In the Save as a Named Filter dialog, in the first input, enter a meaningful Filter name, and then click Save.

        The named filter is now applied to the user visits.

    • You can remove all the filters on a line, at the right-end of the row, by clicking the action icon (Icon-FilterActionb), and then selecting Remove filter or Remove all filters.

  5. When you want to discard events from remaining visits, select the Hide events check box, and then add global dimension filters by clicking the filter addition icon (Icon-FilterAdditionc) (see Adding Global Dimension Filters).

    You could want to focus solely on search events returning results to see, over a visit, whether users are clicking results. Therefore, you remove search events without results by adding the following filter: Has Results is False.

    Once created, the filter(s) appear(s) under Hide Events, and the events meeting your criteria are excluded.

    • If a visit has only one event and this event is filtered out, the visit will be hidden as well.

    • You can add alternative filters by clicking Or where. Events matching one of these filters will be hidden.

      Admin-VisitBrowserHideEvents2

Browse User Visits

  1. Access the Visit Browser page (see Access the Visit Browser Page).

  2. On the Visit Browser page, after setting the date interval and adding filters, click a visit row to see all events that occurred in that particular visit.

  3. Click an event row to see all available information on the event, such as dimension values and the response time (see Usage Analytics Dimensions and Reference).

    You can sort events in a visit by Order and Time.

    You can verify if events are logged properly by ensuring the metadata of each event is complete and valid.

Review Single Visit Containing More Than 250 Events

  1. Access the Visit Browser page (see Access the Visit Browser Page).

  2. In the Visit Browser page, click the row of a visit containing more than 250 events.

  3. Under the 250th event, click Create.

  4. In the Export estimate dialog that appears, select the Use Dimension Display Names check box, when you want the export to show the same dimension names as they appear in usage analytics reports.

    Origin 1 (Page/Hub)

    By default, exports show the dimension API names.

    originLevel1

  5. In the navigation bar on the left, under Analytics, select Exports.

  6. In the Exports page, in the list of exports, on the line of the newly created export, click the Icon-Download icon to download the ZIP file on your device.

    The export contains all missing events.

Export Visit Data That Meet Your Criteria

  1. Access the Visit Browser page (see Access the Visit Browser Page).

  2. On the Visit Browser page, in the top right corner of the screen, click the Export visit data using current filters icon (Icon-Download3b).

    If the Export visit data using current filters icon is grayed and unresponsive, you do not have all required privileges to perform this action (see Required Privileges).

  3. In the Export Estimate window that appears and shows the number of events to be contained in the export, click Add an Export.

    The export is created and available for download in the administration console Data Exports page.

    When the export contains more than 3 millions events, the events are sorted randomly rather than by date and time.

  4. In the navigation bar on the left, under Analytics, select Data Exports.

  5. In the Data Exports page, in the list of exports, select the row of the newly created export, and then, in the Action bar, click Downloadto have the ZIP file on your computer.

Reference

The body of the Visit Browser page is essentially a table listing all the visits that match specific criteria.

When no values are returned for a given field, n/a is shown in the column row.

  • Start Date column indicates the date and the hour when the user performed their first event on the search interface.

  • Visit Duration column indicates the time between the first and last event performed by a user during a visit (based on the event visit ID).

    • When hovering the column value, you can see the start and end time of the user visit.

    • An n/a value means that the related visit only contained one event, thus preventing the usage analytics service to calculate the actual visit duration.

  • User Name column indicates, when the user is authenticated to the search interface, the display name of the user that performed the event.

  • Location column indicates, when available, the country, province/state, and city from which the user performed the event, based on the IP address.

    The location of the user can be n/a, when the IP address is hashed, for instance.

  • Browser column indicates, when available, the web browser name and version with which the user performed the event. This information is extracted from the HTTP user agent identification.

    The browser of the user can be n/a, when the user is a custom bot or a crawler, for instance.

  • Event Count column indicates the number of events that occurred in the visit.

  • When expanding a visit row, the All Visit Events table columns indicate general information about each performed event:

    • Order: the rank of the event

    • Time: the time at which the event was performed

    • User Name: when the user is authenticated to the search interface, the display name of the user that performed the event

    • Type: the type of the event which can be Click, Search, or the name identifying the custom event or its category

      (For custom events only) You can use the Type values when filtering on the Event Type dimension.

    • Cause: (for click and search events only) the name of the search or click event cause (see Click Cause and Search Cause)

    • Details (depending on the event type):

      • For search events: the query text entered by the user in the search box (if any) OR the selected facet value and the underlying advanced query expression

      • For click events: the title and URL of the item on which the user performed the click

      • For custom events: the name of the custom event cause

        You can use the Details values when filtering on the Event Value dimension.

  • When expanding an event row, you can see all the dimensions and their values passed along with the performed event indicating the context of the recorded event (see Usage Analytics Dimensions).

Required Privileges

The following table indicates the required privileges to view and to edit elements of the Visit Browser page.

Action Service - Privilege Required access level
View user visits

Analytics - Analytics data

Analytics - Dimensions

Analytics - Named filters

Analytics - Permission filters

Organization - Organization

View
Export visit data

Analytics - Analytics data

Analytics - Dimensions

Analytics - Named filters

Analytics - Permission filters

Organization - Organization

View

Analytics - Data exports

Edit