Skip to main content
Users
CloudPortalLogin
  • Powered byPowered by
Developing with Sitecore Personalize
Data privacy
Before you start sending data
Integrating with Sitecore Personalize
Stream API
Personalize API Flow execution
REST APIs
  • Sitecore Personalize for developers
  • Stream API
  • Sitecore Engage SDK reference
  • Objects
  • Event data object

Event data object

Use the event data object to collect behavioral and transactional data about a user's interaction with your app. You can optionally collect custom data about the event using the extension data object. After you create your event data objects, you can send the events to Sitecore Personalize.

Required attributes

At a minimum, every event data object must include the following attributes. Note that event data objects for different event types may require more attributes than listed in this table.

Attribute

Type

Description

Example

channel

string (uppercase)

The touchpoint where the user interacts with your brand.

For example, for webpages, the channel is "WEB". For mobile app screens, the channel is "MOBILE_APP".

Must be one of:

  • "AIRPORT_KIOSK"

  • "BRANCH"

  • "CALL_CENTER"

  • "EMAIL"

  • "GDS"

  • "KIOSK"

  • "MOBILE_APP"

  • "MOBILE_WEB"

  • "SMS"

  • "OFFLINE"

  • "OTA"

  • "OTHER"

  • "WEB"

currency

string (uppercase ISO 4217)

The alphabetic currency code of the currency the user is using in your app.

For example, if the user selects Australian dollars as the currency on your website, the currency is "AUD".

  • "EUR"

  • "GBP"

  • "USD"

pointOfSale

string

The name of the point of sale where the interaction with your brand takes place.

You must set this value to the name of a point of sale that exists in your instance of Sitecore Personalize.

If you did not specify pointOfSale in the settings object, you must specify it in every event data object.

If you specified pointOfSale in the settings object, it's optional in event data objects. You can specify it in any event data object to override the original value of pointOfSale, previously specified in the settings object, for that specific event.

"myretailsite/ireland"

Optional attributes

An event data object can optionally include the following attributes:

Attribute

Type

Description

Example

language

string (uppercase ISO 639-1)

The language the user is using your app in.

For example, if the user selects the Japanese language on your website, the language is "JA".

This is a custom value of your choice.

For client-side events, the default value is inferred from the HTML lang attribute. If the HTML lang attribute is not specified, the default is an empty string.

For server-side events, the default is an empty string.

  • "DE"

  • "EN"

  • "FR"

page

string

The name of the webpage where the interaction with your brand takes place.

This is a custom value of your choice.

For client-side events, the default value for the root page of your website is Home Page. For other pages, the default value is inferred from the URL pathname.

For server-side events, the default is an empty string.

  • "Home Page"

  • "home"

  • "contact-us.html"

Do you have some feedback for us?

If you have suggestions for improving this article,

Privacy policySitecore Trust CenterCopyright © 1999-2025 Sitecore