A unique name describing the action that triggered the event.
See the name
property of the IAnalyticsActionCause
interface.
Example: pagerNext
A name describing the category of actions to which the action that triggered the event belongs.
See the type
property of the IAnalyticsActionCause
interface.
Example: getMoreResults
The original advanced query expression (i.e., aq
) sent for the related query.
Note: The framework normally sets this field by retrieving the information from the related query.
A GUID representing the current user. This GUID is generated locally and stored in a non-expiring browser cookie.
Whether the related query was contextual.
Note: The framework normally sets this field by retrieving the information from the related query.
Additional metadata to send along with the event.
Note: This field may include custom user context information (see Sending Custom Context Information).
Example: { "currentResultsPerPage": 25, "userRole": "developer" }
The name of the device or browser that triggered the event.
Note: The framework normally sets this field by parsing the current navigator.userAgent
value.
Example: Chrome
Whether the did you mean feature was enabled for the related query.
Note: The framework normally sets this field by retrieving the information from the related query.
Example: @source=="Product Documentation"
A representation of the state of each dynamic facet in the search interface when the action that triggered the event was executed.
The language of the search interface from which the event originates.
Must be a valid ISO-639-1 code.
Note: By default, the framework sets this field according to the currently loaded culture file (see Changing the Language of Your Search Interface).
Example: en
Whether the event originates from a mobile device.
Note: The framework normally sets this field by parsing the current navigator.userAgent
value.
The number of query result items returned by the related query.
Note: The framework normally sets this field by retrieving the information from the related Search API query response.
The broad application context from which the event originates.
Note: By default, the framework sets this field to Search
. However, you can use the setOriginContext
method of the Analytics
component to modify the default value.
Example: Search
The identifier of the search interface from which the event originates.
Note: This field is normally set through the searchHub
option of the Analytics
component. However, when actually recording the event, the Coveo Cloud usage analytics service may override this value with information extracted from the search token.
Example: PartnerPortalSearch
The identifier of the tab from which the event originates.
Note: The framework normally sets this field to the identifier of the currently selected Tab
in the search interface.
Example: All
The address of the webpage that linked to the search interface from which the event originates.
Note: The framework normally sets this field to the current document.referrer
value.
Example: http://example.com/
The 0-based page of results requested for the related query.
Note: The framework normally sets this field by retrieving the information from the related query.
The name of the query pipeline to which the related query was routed.
Note: The framework normally sets this field by retrieving the information from the related Search API query response.
Example: PartnerPortalSearchPipeline
The original basic query expression (i.e., q
) sent for the related query.
Note: The framework normally sets this field by retrieving the information from the related query.
Example: coveo machine learning
The time it took to get a response from the Search API for the query related to the event (in milliseconds).
Note: The framework normally sets this field to 0
, except for search events in which case it sets the field by retrieving the information from the related Search API query response.
The number of results per page requested for the related query.
Note: The framework normally sets this field by retrieving the information from the related query.
The unique identifier of the related query.
Note: The framework normally sets this field by retrieving the information from the related Search API query response.
Example: 74682726-0e20-46eb-85ac-f37259346f57
The name of the A/B test that applied to the related query.
Note: This field may be set through the splitTestRunName
option of the Analytics
component. However, if the option is left undefined, the framework attempts to set this field by retrieving information from the related Search API query response.
Example: Test new ART model
The version of the A/B test that applied to the related query (i.e., version A or version B).
Note: This field may be set through the splitTestRunVersion
option of the Analytics
component. However, if the option is left undefined and the related Search API query response indicates that an A/B test was applied, the framework sets this field to the name of the query pipeline to which the query was routed.
Example: PartnerPortalSearchPipelineWithART
The software acting on behalf of the end-user whose action triggered the event.
Note: By default, the framework sets this field to the current navigator.userAgent
value.
Example: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/75.0.3770.100 Safari/537.36
The display name of the end-user whose action triggered the event.
Note: This field is normally set to the userDisplayName
option value of the Analytics
component. However, when actually recording the event, the Coveo Cloud usage analytics service may override this value with information extracted from the search token.
Example: Alice Smith
The groups the end-user whose action triggered the event belongs to.
Note: This field is normally left undefined, and the Coveo Cloud usage analytics service attempts to extract the information from the search token when actually recording the event.
The identifier of the end-user whose action triggered the event.
Note: This field is normally set to the user
option value of the Analytics
component. However, when actually recording the event, the Coveo Cloud usage analytics service may override this value with information extracted from the search token.
Example: `asmith@example.com`
Describes a Coveo Cloud usage analytics search event.