Skip to content

EventInput

One behavioural event to record (see Visitors.event). An event is not an interaction: an interaction is a meaningful fact about a person that appears on their timeline, whereas an event is a high-volume signal, such as a page viewed, that is kept briefly and counted. Audiences read the counts (“viewed three pages about espresso this week”), never the events.

optional eventId?: string

Sending the same id again for the same subject on the same day records nothing new, so a retry is safe. At most 160 characters.


kind: string

A registered kind. Today that is 'content.viewed'.


optional subject?: object

What the event is about. For content.viewed, the ids of the page’s categories including their ancestors (a published page’s classification from the Content Delivery API has them), at most 16.

optional categories?: readonly string[]


optional value?: number

A small number the kind defines. For content.viewed, seconds on the page, 0 to 86400.