GuidesAPI ReferenceRelease Notes
HomeLog InHome
Guides

Events reference

Capture analytics events from the Experiences SDK by listening to the onEventTriggered callback. Each callback invocation delivers a single event payload (a data object) that describes what happened.

These docs use tables as a formatting choice to list and explain the fields that can appear in the event payload. They are not database tables.

How events work

  • Source of truth: Events are emitted by the Experiences SDK at runtime. Your integration decides whether and where to forward them.
  • Event identity: Each callback contains an event_category and an event_action that describe what happened.
  • Event fields: Some fields are always present (common fields). Others are included only for specific surfaces (Story, Moment, Video, Widget, Ad, Interaction) or specific actions.
  • Variants: Some fields are grouped under variants (for example, User (Variant) and Tech (Variant)). In these tables, the Field column shows the group name and the Field data column shows the nested field name.

Set up event collection

Event categories

Use the pages below to see which event_action values exist for each event category, and which category-specific fields are included in those events.

  • Moments: See Events // Moments.
  • Stories: See Events // Stories.
  • Videos: See Events // Videos.
  • Widgets: See Events // Widgets.
  • Ads: See Events // Ads.
  • Interactions: See Events // Interactions.

Common fields

The tables below document the common fields that can appear in the callback payload.

ColumnDescription
FieldThe name of the field.
Field dataFor variant-type fields, specifies the actual data field name within the variant.
TypeData type of the field (or the field data if variant). Possible values: Number, Varchar, Boolean.
ExampleA sample value demonstrating the field’s content.
DescriptionExplanation of the field’s meaning or purpose (when relevant).
From versionSDK version from which this field began being reported.
Web/MobileIndicates whether the field reports data only for web, only for mobile, or both (blank).
OptionsLists possible values if the field has a finite set of valid options.
FieldField dataTypeExampleDescriptionFrom versionweb/mobileOptions
timestamp_utcVarchar5/27/2024 15:07:14The time when the event occurred in UTC
timestamp_user_tzVarchar5/27/2024 20:07:14The time when the event occurred according to the user's time zone
sdk_versionVarchar0.50.4Last version of the user's SDK
sdk_typeVarcharAndroidIndicates whether the user accessed the item via the web or mobile versionweb, Android, iOS
event_categoryVarcharMomentMoment, moment, Story, story, Ad, ad, Interaction, interaction, Widget, widget
event_actionVarcharmoment_exitType of action the user did. Each row in the table represents an event.Each item has its own events; please check them out on the item's page.
session_idVarchar5a98cabd-41b7-4f79-bf24-3a655bde2325Session unique id
User (Variant)generated_user_idVarchard5bebe6e-3f33-4df4-b333-321f14b43ca1User's generated by WSC, unique id
User (Variant)external_user_idVarchar6416dadb-eb21-434f-a8ca-7ff41c69a6deCustomer's user id, unique id
User (Variant)localeVarcharen_USUser's phone language
Tech (Variant)device_typeVarcharPhoneThe details of the device from which the user viewed the itemembedded, smarttv, Phone, Tablet, wearable, Desktop, console
Tech (Variant)device_brandVarcharInfinixThe details of the device from which the user viewed the item
Tech (Variant)device_modelVarcharInfinix X6833BThe details of the device from which the user viewed the item
Tech (Variant)operating_system / osVarcharAndroidThe details of the device from which the user viewed the itemFor web, this field name is osFedora, Android, Windows, Chromium OS, Ubuntu, FreeBSD, Xbox, webOS, Mint, "", Chromecast, NETTV, iOS, Mac OS, Linux, android, Raspbian, Firefox OS, HarmonyOS, Tizen, null
Tech (Variant)operating_system_version / os_versionVarchar32The details of the device from which the user viewed the itemFor web, this field name is os_version
Tech (Variant)screen_colorVarchar24web
Tech (Variant)screen_resolutionVarchar1080X2232
Tech (Variant)browserVarcharChromeweb
Tech (Variant)browser_sizeVarchar360x559web
Tech (Variant)browser_versionVarchar89.0.4389.105web
Tech (Variant)app_idVarcharcom.pl.cwc_2015Identifier of the app from which the user is viewing the item, as listed in the app store.mobile
Tech (Variant)app_versionVarchar10.2.0The app version from the app store.mobile
Tech (Variant)user_agentVarcharMozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Mobile Safari/537.36web
Tech (Variant)connection_typeVarcharcellular
page (Variant)page_urlVarcharhttps://supersport-assets.mvp.fan/games/6643b5914e167da3d5a52b58.htmlURL of the previous page from which the user navigated to this item.web
Referring (Variant)labels_expressionVarchar[and,home,clips,c6122]Labels expression of the previous item. Unique per item
Referring (Variant)referrer_page_typeVarcharHomepageData about the previous page of the user, not reported in widget's tablewebCategory/Article, Homepage, null
Referring (Variant)referrer_page_urlVarcharhttps://www.google.com/Data about the previous page of the user, not reported in widget's tableweb
Referring (Variant)referrer_page_domainVarcharwww.google.comData about the previous page of the user, not reported in widget's tableweb
Referring (Variant)story_sourceVarcharOneBoxReported only in story, ad and interaction tableswebOneBox, null

Data export (optional)

Some integrations forward SDK events to a data warehouse. If you have an export pipeline, you might see fields and variants represented in tables.

Don’t assume you have access to internal warehouse schemas. Treat this section as an SDK reference unless your WSC Sports representative confirmed a data export for your account.


Did this page help you?