Interface ICustomEvent

Describes a Coveo Cloud usage analytics custom event.

Index

Properties

actionCause

actionCause: string

A unique name describing the action that triggered the event.

See the name property of the IAnalyticsActionCause interface.

Example: pagerNext

actionType

actionType: string

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

Optional anonymous

anonymous: boolean

Whether the event should be logged anonymously to the Coveo Cloud usage analytics service.

Note: This field is normally set to the anonymous option value of the Analytics component.

clientId

clientId: string

A GUID representing the current user. This GUID is generated locally and stored in a non-expiring browser cookie.

Optional customData

customData: object

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" }

Type declaration

  • [key: string]: any

device

device: string

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

eventType

eventType: string

A name describing the category of actions to which the action that triggered the event belongs.

Note: Normally, this field is set to the same value as actionType.

Example: getMoreResults

eventValue

eventValue: string

A unique name describing the action that triggered the event.

Note: Normally, this field is set to the same value as actionCause.

Example: pagerNext

language

language: string

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

lastSearchQueryUid

lastSearchQueryUid: string

The searchQueryUid of the last search event that occurred before this event.

Example: 74682726-0e20-46eb-85ac-f37259346f57

mobile

mobile: boolean

Whether the event originates from a mobile device.

Note: The framework normally sets this field by parsing the current navigator.userAgent value.

originContext

originContext: string

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

originLevel1

originLevel1: string

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

originLevel2

originLevel2: string

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

Optional originLevel3

originLevel3: string

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/

responseTime

responseTime: number

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.

searchQueryUid

searchQueryUid: string

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

Optional userAgent

userAgent: string

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

Optional userDisplayName

userDisplayName: string

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

Optional userGroups

userGroups: string

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.

Optional username

username: string

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`

Hierarchy