Skip to content

Type Alias: CmcdEvent ​

ts
type CmcdEvent = CmcdRequest & object;

Defined in: CmcdEvent.ts:14

Common Media Client Data (CMCD) version 2 - Event Mode.

Extends CmcdRequest with event-specific keys for reporting events according to the CMCD version 2 specification.

Type Declaration ​

cen? ​

ts
cen?: string;

Custom Event Name

Defines a custom event name. Maximum length is 64 characters. This key MUST be sent when the event type is 'ce' (custom event). This key MUST NOT be sent when the event type is any other value. A custom key-value pair MAY be used to transfer a custom value associated with this event. The names chosen SHOULD associate the custom event name with the custom key name.

String

See ​

CTA-5004-B Custom Event Name

e? ​

ts
e?: CmcdEventType;

Event

This key MUST only be used in Event mode. It MUST be present on all reports. The minimum recommended set of supported events are: ps, e, t, and rr.

  • abs - ad break start
  • abe - ad break end
  • ae - ad end
  • as - ad start
  • b - backgrounded mode
  • bc - bitrate change
  • c - content ID changed
  • ce - custom event
  • e - error
  • h - hostname changed
  • m - mute
  • pc - player collapse
  • pe - player expand
  • pr - playback rate change
  • ps - play state change
  • rr - response received
  • sk - skip
  • t - time interval
  • um - unmute

Token

See ​

CTA-5004-B Event

h? ​

ts
h?: string;

Hostname

A string identifying the current hostname from which the player is retrieving content. Maximum length is 128 characters.

String

See ​

CTA-5004-B Hostname

ts? ​

ts
ts?: number;

Timestamp

The timestamp at which the associated event occurred. The value is the number of milliseconds elapsed since the Unix Epoch (January 1, 1970, at 00:00:00 UTC), excluding leap seconds. When the event is a request for a media object, the time SHOULD reference when the request was first initiated.

This key MUST be included with all Event reports.

Integer milliseconds

See ​

CTA-5004-B Timestamp

See ​

CTA-5004-B Event Mode

A Streaming Video Technology Alliance project.