ÃÛ¶¹ÊÓƵ

DocumentationAnalyticsStreaming Media Collection Guide

Quality parameters quality-parameters

Last update: Thu Mar 07 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • User
  • Admin
  • Developer

This topic presents a list of quality of experience (QoE/QoS) data, including context data values, that ÃÛ¶¹ÊÓƵ collects via solution variables.

Table data description:

  • Implementation: Information on implementation values and requirements

    • Key - Variable, set either manually in your app, or automatically by the ÃÛ¶¹ÊÓƵ Media SDK.
    • Required - Indicates whether the parameter is required for basic video tracking.
    • Type - Specifies the type of the variable to be set, string or number.
    • Sent With - Indicates when the data is sent: Media Start is the analytics call sent on media start, Ad Start is the analytics call sent on ad start, and so on; the Close calls are the compiled analytics calls sent directly from the heartbeat server to the analytics server at the end of the media session, or the end of the ad, chapter, etc. The close calls are not available in network packet calls.
    • Min. SDK Version - Indicates which SDK version you would need to access the parameter.
    • Sample Value - Provides example of common variable usage.

  • Network Parameters: Displays the values that are passed to ÃÛ¶¹ÊÓƵ Analytics or Heartbeat servers. This column shows the names of the parameters that are seen in the network calls generated by ÃÛ¶¹ÊÓƵ Media SDKs.

  • Reporting: Information on how to view and analyze the video data.

    • Available - Indicates whether the data is available in reporting by default (Yes), or requires custom set-up (Custom)
    • Reserved Variable - Indicates whether the data is captured as an event, eVar, prop, or classification in a reserved variable.
    • Report Name - Name of ÃÛ¶¹ÊÓƵ Aanlytics report for variable
    • Context Data - Name of the ÃÛ¶¹ÊÓƵ Analytics context data passed to the reporting server and used in processing rules.
    • Data Feed - Column name for variable found in Clickstream or Live Stream data feeds
    • Audience Manager - Trait name found in ÃÛ¶¹ÊÓƵ Audience Manager

Quality Metadata quality-metadata

Average Bitrate

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    bitrate
  • API Key:
    media.qoe.bitrate
  • Required:
    No
  • Type:
    number
  • Sent with:
    Close
  • Min. SDK Version: Any
  • Sample Value:
    800-899
  • Description:
    The average bitrate (in kbps). The value is predefined buckets at 100kbps intervals. The Average Bitrate is computed as a weighted average of all bitrate values related to the play duration that occurred during a playback session.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    bitrateAverageBucket)
  • Heartbeat:
    (l:stream:bitrate)
  • Available:
    Yes
  • Reserved Variable:
    eVar
  • Expiration:
    On HIT
  • Report Name:
    Average Bitrate
  • Context Data:
    (a.media.qoe.
    bitrateAverageBucket)
  • Data Feed:
    videoqoebitrateaverageevar
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    bitrateAverageBucket)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.bitrateAverageBucket
  • Collection XDM Field Path:
    mediaCollection.qoeDataDetails.
    bitrate
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.
    bitrateAverageBucket

Time To Start

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
  • API Key:
    media.qoe.timeToStart
  • Required:
    No
  • Type:
    number
  • Sent with:
    Media Start, Media Close
  • Min. SDK Version: Any
  • Sample Value:
    30,000
  • Description:
    This value defaults to zero if you do not set it through the QoSObject. You set this value in milliseconds. The value will be displayed in the time format (HH:MM:SS) in Analysis Workspace and Reports & Analytics. In Data Feeds, Data Warehouse, and Reporting APIs the values will be displayed in seconds.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    timeToStart)
  • Heartbeat:
    (l:stream:startup_time)
  • Available:
    Yes
  • Reserved Variable:
    eVar
  • Expiration:
    On HIT
  • Report Name:
    Time to Start
  • Context Data:
    (a.media.qoe.
    timeToStart)
  • Data Feed:
    videoqoetimetostartevar
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    timeToStart)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.timeToStart.value
  • Collection XDM Field Path:
    mediaCollection.qoeDataDetails.timeToStart
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.timeToStart

Frames per Second

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
  • API Key:
    media.qoe.framesPerSecond
  • Required:
    No
  • Type:
    number
  • Sent with:
    Media Start, Media Close
  • Min. SDK Version: Any
  • Sample Value:
    24
  • Description:
    The current value of the stream frame-rate (in frames per second). The field is mapped to the fps field on the close call and can be accessed through processing rules.
  • ÃÛ¶¹ÊÓƵ Analytics:
  • Heartbeat:
    (l:stream:fps)
  • Available:
    No
  • Reserved Variable:
    N/A
  • Report Name:
    N/A
  • Context Data:
  • Data Feed:
    N/A
  • Audience Manager:
  • XDM Field Path:
  • Collection XDM Field Path:
    mediaCollection.qoeDataDetails.framesPerSecond
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.framesPerSecond

Dropped Frames

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    droppedFrames
  • API Key:
    media.qoe.droppedFrames
  • Required:
    No
  • Type:
    number
  • Sent with:
    Media Close
  • Min. SDK Version: Any
  • Sample Value:
    3
  • Description:
    The number of dropped frames (Int). This value is computed as a sum of all frames dropped during a playback session. This value is taken from the last value of (l:stream:dropped_frames).
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    droppedFrameCount)
  • Heartbeat:
    (l:stream:
    dropped_frames)
  • Available:
    Yes
  • Reserved Variable:
    eVar
  • Expiration:
    On HIT
  • Report Name:
    Dropped Frames
  • Context Data:
    (a.media.qoe.
    droppedFrameCount)
  • Data Feed:
    videoqoedroppedframecountevar
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    droppedFrameCount)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.droppedFrames.value
  • Collection XDM Field Path:
    mediaCollection.qoeDataDetails.
    droppedFrames
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.
    droppedFrames

Buffer Events

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
    N/A
  • Required:
    No
  • Type:
    number
  • Sent with:
    Media Close
  • Min. SDK Version: Any
  • Sample Value:
    2
  • Description:
    The number of buffer events. This metric is computed as a count of the different buffer states that occurred during a playback session. This is a count of how many times the player enters a buffer state from other states, e.g., playing or pausing.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    bufferCount)
  • Heartbeat:
    (s:event:
    type=buffer)
  • Available:
    Yes
  • Reserved Variable:
    eVar
  • Expiration:
    On HIT
  • Report Name:
    Buffer Events
  • Context Data:
    (a.media.qoe.
    bufferCount)
  • Data Feed:
    videoqoebuffercountevar
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    bufferCount)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.buffers.value
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.bufferCount

Total Buffer Duration

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
    N/A
  • Required:
    No
  • Type:
    number
  • Sent with:
    Media Close
  • Min. SDK Version:
  • Sample Value:
    30
  • Description:
    The total amount of time, in seconds, spent buffering. This value is computed as a sum of all buffer events durations that occurred during a playback session. The value will be displayed in the time format (HH:MM:SS) in Analysis Workspace and Reports & Analytics. In Data Feeds, Data Warehouse, and Reporting APIs the values will be displayed in seconds.
    Release Date: 09/13/18
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    bufferTime)
  • Heartbeat:
    (l:event:duration)
  • Available:
    Yes
  • Reserved Variable:
    eVar
  • Expiration:
    On HIT
  • Report Name:
    Total Buffer Duration
  • Context Data:
    (a.media.qoe.
    bufferTime)
  • Data Feed:
    videoqoebuffertimeevar
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    bufferTime)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.bufferTime.value
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.bufferTime

Bitrate Changes

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
  • API Key:
    media.qoe.bitrateChange
  • Required:
    No
  • Type:
    number
  • Sent with:
    Media Close
  • Min. SDK Version: Any
  • Sample Value:
    3
  • Description:
    The number of bitrate changes (Integer). This value is computed as a sum of all bitrate change events that occurred during a playback session.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    bitrateChangeCount)
  • Heartbeat:
    (s:event:
    type=bitrate_change)
  • Available:
    Yes
  • Reserved Variable:
    eVar
  • Expiration:
    On HIT
  • Report Name:
    Bitrate Changes
  • Context Data:
    (a.media.qoe.
    bitrateChangeCount)
  • Data Feed:
    videoqoebitratechangecountevar
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    bitrateChangeCount)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.bitrateChanges.value
  • Collection XDM Field Path:
    mediaCollection.qoeDataDetails.
    bitrateChangeCount
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.
    bitrateChangeCount

Errors / Error Events

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
  • API Key:
  • Required:
    No
  • Type:
    number
  • Sent with:
    Media Close
  • Min. SDK Version: Any
  • Sample Value:
    1
  • Description:
    The number of errors occurred (Integer). This value is computed as a sum of all error events that occurred during a playback session.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    errorCount)
  • Heartbeat:
    (s:event:
    type=error)
  • Available:
    Yes
  • Reserved Variable:
    eVar
  • Expiration:
    On HIT
  • Report Name:
    Errors
  • Context Data:
    (a.media.qoe.
    errorCount)
  • Data Feed:
    videoqoeerrorcountevar
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    errorCount)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.errors.value
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.errorCount

Player SDK Error IDs

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
  • Required:
    No
  • Type:
    number
  • Sent with:
    Media Close
  • Min. SDK Version: Any
  • Sample Value:
  • Description:
    The unique error IDs generated by the player SDK. Customers must provide the error codes/ids at implementation time via provided error APIs.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    playerSdkErrors)
  • Heartbeat:
    (s:event:
    type=error)
  • Available:
    Yes
  • Reserved Variable:
    eVar
  • Expiration:
    On HIT
  • Report Name:
    Player SDK Error IDs
  • Context Data:
    (a.media.qoe.
    playerSdkErrors)
  • Data Feed:
    videoqoeplayersdkerrors
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    playerSdkErrors)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.playerSdkErrors
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.
    playerSdkErrors

External Error IDs

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
  • Required:
    No
  • Type:
    number
  • Sent with:
    Media Close
  • Min. SDK Version: Any
  • Sample Value:
  • Description:
    The unique error IDs from any external source, e.g., CDN errors. Customers must provide the error codes/ids at implementation time via provided error APIs.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    externalErrors)
  • Heartbeat:
    (s:event:
    type=error)
  • Available:
    Yes
  • Reserved Variable:
    eVar
  • Expiration:
    On HIT
  • Report Name:
    External Error IDs
  • Context Data:
    (a.media.qoe.
    externalErrors)
  • Data Feed:
    videoqoeextneralerrors
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    externalErrors)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.externalSdkErrors
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.
    externalErrors

Media SDK Error IDs

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
  • Required:
    No
  • Type:
    number
  • Sent with:
    Media Close
  • Min. SDK Version: Any
  • Sample Value:
  • Description:
    The unique error IDs generated by Media SDK during playback.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    mediaSdkErrors)
  • Heartbeat:
    (s:event:
    type=error)
  • Available:
    Yes
  • Reserved Variable:
    eVar
  • Expiration:
    On HIT
  • Report Name:
    Custom
  • Context Data:
    (a.media.qoe.
    mediaSdkErrors)
  • Data Feed:
    mediaqoeexternalerrors
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    mediaSdkErrors)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.mediaSdkErrors
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.
    mediaSdkErrors

Session End session-end

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
  • Type:
    string
  • Sent with:
    Media Close
  • Min. SDK Version: 2.1
  • Sample Value:
    end
  • Description:
    The end event means that the SDK is sending a close call to the backend. On the receipt of this event, the backend will close the session for this video, and do no further processing.
    If the media was completed to 100%, this should be sent after s:event:type=complete. See Content Complete for related information.
  • ÃÛ¶¹ÊÓƵ Analytics:
    N/A
  • Heartbeats:
    (s:event:type=end)
  • Available:
    Use custom processing rule
  • Reserved Variable:
    event
  • Report Name:
    N/A
  • Context Data:
  • Data Feed:
    N/A
  • Audience Manager:
  • XDM Field Path:

Quality Metrics quality-metrics

Time To Start

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
    N/A
  • Required:
    No
  • Type:
    number
  • Sent with:
    Media Close
  • Min. SDK Version: Any
  • Sample Value:
    30,000
  • Description:
    This value defaults to zero if you do not set it through the QoSObject. You set this value in milliseconds. The value will be displayed in the time format (HH:MM:SS) in Analysis Workspace and Reports & Analytics. In Data Feeds, Data Warehouse, and Reporting APIs the values will be displayed in seconds.
    Release Date: 09/13/18
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    timeToStart)
  • Heartbeat:
    (l:stream:startup_time)
  • Available:
    Yes
  • Reserved Variable:
    event
  • Report Name:
    Time to Start
  • Context Data:
    (a.media.qoe.
    timeToStart)
  • Data Feed:
    N/A
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    timeToStart)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.timeToStart.value
  • Collection XDM Field Path:
    mediaCollection.qoeDataDetails.timeToStart
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.timeToStart

Buffer Events

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    startupTime
  • API Key:
    N/A
  • Required:
    No
  • Type:
    number
  • Sent with:
    Media Close
  • Min. SDK Version: Any
  • Sample Value:
    2
  • Description:
    The number of buffer events (Integer). This metric is computed as a count of buffer events that occurred during a playback session.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    bufferCount)
  • Heartbeat:
    (s:event:
    type=buffer)
  • Available:
    Yes
  • Reserved Variable:
    event
  • Report Name:
    Buffer Events
  • Context Data:
    (a.media.qoe.
    bufferCount)
  • Data Feed:
    N/A
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    bufferCount)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.buffers.value
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.bufferCount

Total Buffer Duration

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
    N/A
  • Required:
    No
  • Type:
    number
  • Sent with:
    Media Close
  • Min. SDK Version: Any
  • Sample Value:
    15
  • Description:
    The total amount of time spent buffering (seconds; integer). This value is computed as a sum of all buffer events durations that occurred during a playback session. The value will be displayed in the time format (HH:MM:SS) in Analysis Workspace and Reports & Analytics. In Data Feeds, Data Warehouse, and Reporting APIs the values will be displayed in seconds.
    Release Date: 09/13/18
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    bufferTime)
  • Heartbeat:
    (l:event:duration)
  • Available:
    Yes
  • Reserved Variable:
    event
  • Report Name:
    Total Buffer Duration
  • Context Data:
    (a.media.qoe.
    bufferTime)
  • Data Feed:
    N/A
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    bufferTime)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.bufferTime.value
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.bufferTime

Bitrate Changes

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
    N/A
  • Required:
    No
  • Type:
    Event
  • Sent with:
    Media Close
  • Min. SDK Version: Any
  • Sample Value:
    “3â€
  • Description:
    The number of bitrate changes. This value is computed as a sum of all bitrate change events that occurred during a playback session.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    bitrateChangeCount)
  • Heartbeat:
    (s:event:
    type=bitrate_change)
  • Available:
    Yes
  • Reserved Variable:
    event
  • Report Name:
    Bitrate Changes
  • Context Data:
    (a.media.qoe.
    bitrateChangeCount)
  • Data Feed:
    N/A
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    bitrateChangeCount)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.bitrateChanges.value
  • Collection XDM Field Path:
    mediaCollection.qoeDataDetails.
    bitrateChangeCount
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.
    bitrateChangeCount

Errors

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
    N/A
  • Required:
    No
  • Type:
    number
  • Sent with:
    Media Close
  • Min. SDK Version: Any
  • Sample Value:
    1
  • Description:
    The number of errors that occurred (Integer). This value is computed as a sum of all error events that occurred during a playback session.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    errorCount)
  • Heartbeat:
    (s:event:
    type=error)
  • Available:
    Yes
  • Reserved Variable:
    event
  • Report Name:
    Error Events
  • Context Data:
    (a.media.qoe.
    errorCount)
  • Data Feed:
    N/A
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    errorCount)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.errors.value
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.errorCount

Dropped Frames

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
    N/A
  • Required:
    No
  • Type:
    number
  • Sent with:
    Media Close
  • Min. SDK Version: Any
  • Sample Value:
    1
  • Description:
    The number of dropped frames (Integer). This value is computed as a sum of all frames dropped during a playback session.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    droppedFrameCount)
  • Heartbeat:
    (l:stream:
    dropped_frames)
  • Available:
    Yes
  • Reserved Variable:
    event
  • Report Name:
    Dropped Frames
  • Context Data:
    (a.media.qoe.
    droppedFrameCount)
  • Data Feed:
    N/A
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    droppedFrameCount)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.droppedFrames.value
  • Collection XDM Field Path:
    mediaCollection.qoeDataDetails.
    droppedFrames
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.
    droppedFrames

Drops Before Start

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
    N/A
  • Required:
    No
  • Type:
    string
  • Sent with:
    Media Close
  • Min. SDK Version: Any
  • Sample Value:
    TRUE
  • Description:
    The number of times a user quit the video before its start. This metric is set to 1 only if no content was rendered, regardless of ads.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    dropBeforeStart)
  • Heartbeat:
    (s:event:
    type=aa_start)
  • Available:
    Yes
  • Reserved Variable:
    event
  • Report Name:
    Drops before Start
  • Context Data:
    (a.media.qoe.
    dropBeforeStart)
  • Data Feed:
    N/A
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    dropBeforeStart)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.dropBeforeStarts.value >= 1 => “T¸é±«·¡â€
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.
    isDroppedBeforeStart
IMPORTANT
If this event is set, the only possible value is TRUE. If this event is not set, no value is sent.

Buffer Impacted Streams

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
    N/A
  • Required:
    No
  • Type:
    string
  • Sent with:
    Media Close
  • Min. SDK Version: Any
  • Sample Value:
    TRUE
  • Description:
    The number of streams impacted by buffering. This metric is set to 1 only if at least one buffer event occurred during a playback session.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    buffer)
  • Heartbeat:
    (s:event:
    type=buffer)
  • Available:
    Yes
  • Reserved Variable:
    event
  • Report Name:
    Buffer Impacted Streams
  • Context Data:
    (a.media.qoe.
    buffer)
  • Data Feed:
    N/A
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    buffer)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.bufferImpactedStreams.value >= 1 => “T¸é±«·¡â€
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.
    hasBufferImpactedStreams
IMPORTANT
If this event is set, the only possible value is TRUE. If this event is not set, no value is sent.

Bitrate Change Impacted Streams

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
    N/A
  • Required:
    No
  • Type:
    string
  • Sent with:
    Media Close
  • Min. SDK Version: Any
  • Sample Value:
    TRUE
  • Description:
    The number of streams in which bitrate changes occurred. This metric is set to 1 only if at least one bitrate change event occurred during a playback session.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    bitrateChange)
  • Heartbeat:
    (s:event:
    type=bitrate_change)
  • Available:
    Yes
  • Reserved Variable:
    event
  • Report Name:
    Bitrate Change Impacted Streams
  • Context Data:
    (a.media.qoe.
    bitrateChange)
  • Data Feed:
    N/A
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    bitrateChange)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.bitrateChangeImpactedStreams.value >= 1 => “T¸é±«·¡â€
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.
    hasBitrateChangeImpactedStreams
IMPORTANT
If this event is set, the only possible value is TRUE. If this event is not set, no value is sent.

Average Bitrate

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
    N/A
  • Required:
    No
  • Type:
    number
  • Sent with:
    Media Close
  • Min. SDK Version: Any
  • Sample Value:
    3200
  • Description:
    The average bitrate (in kbps, integer). This metric is computed as a weighted average of all bitrate values related to the play duration that occurred during a playback session.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    bitrateAverage)
  • Heartbeat:
    (l:stream:bitrate)
  • Available:
    Yes
  • Reserved Variable:
    event
  • Report Name:
    Average Bitrate
  • Context Data:
    (a.media.qoe.
    bitrateAverage)
  • Data Feed:
    N/A
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    bitrateAverage)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.bitrateAverage.value
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.
    bitrateAverage

Error Impacted Streams

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
    N/A
  • Required:
    No
  • Type:
    string
  • Sent with:
    Media Close
  • Min. SDK Version: Any
  • Sample Value:
    TRUE
  • Description:
    The number of streams in which an error event occurred (i.e., trackError was called during the playback session, and a type=error heartbeat call was generated).
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    error)
  • Heartbeat:
    (s:event:
    type=error)
  • Available:
    Yes
  • Reserved Variable:
    event
  • Report Name:
    Error Impacted Streams
  • Context Data:
    (a.media.qoe.
    error)
  • Data Feed:
    N/A
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    error)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.errorImpactedStreams.value > 0 => “T¸é±«·¡â€
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.
    hasErrorImpactedStreams
IMPORTANT
If this event is set, the only possible value is TRUE. If this event is not set, no value is sent.

Dropped Frame Impacted Streams

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
    N/A
  • Required:
    No
  • Type:
    string
  • Sent with:
    Media Close
  • Min. SDK Version: Any
  • Sample Value:
    TRUE
  • Description:
    The number of streams in which frames were dropped. This metric is set to 1 only if at least one frame was dropped during a playback session.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    droppedFrames)
  • Heartbeat:
    (l:stream:
    dropped_frames)
  • Available:
    Yes
  • Reserved Variable:
    event
  • Report Name:
    Dropped Frame Impacted Streams
  • Context Data:
    (a.media.qoe.
    droppedFrames)
  • Data Feed:
    N/A
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    droppedFrames)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.droppedFrameImpactedStreams.value >= 1 => “T¸é±«·¡â€
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.
    hasDroppedFrameImpactedStreams
IMPORTANT
If this event is set, the only possible value is TRUE. If this event is not set, no value is sent.

Stalling Impacted Streams

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
    N/A
  • Required:
    No
  • Type:
    string
  • Sent with:
    Media Close
  • Min. SDK Version: 1.5+
  • Sample Value:
    TRUE
  • Description:
    The number of streams in which a stalled event occurred. This metric is set to 1 only if at least one stall occurred during playback. Customers will have to create their own processing rules to have the value available for reporting.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    stall)
  • Heartbeat:
    (s:event:
    type=stall)
  • Available:
    Use custom processing rule
  • Reserved Variable:
    event
  • Report Name:
    Custom
  • Data Feed:
    N/A
  • Context Data:
    (a.media.qoe.
    stall)
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    stall)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.stallingImpactedStreams.value >= 1 => “T¸é±«·¡â€
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.hasStallImpactedStreams
IMPORTANT
If this event is set, the only possible value is TRUE. If this event is not set, no value is sent.

Stalling Events

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
    N/A
  • Required:
    No
  • Type:
    string
  • Sent with:
    Media Close
  • Min. SDK Version: 1.5+
  • Sample Value:
    “3â€
  • Description:
    The number of times the playback was stalled during a playback session. Customers will have to create their own processing rules to have the value available for reporting.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    stallCount)
  • Heartbeat:
    (s:event:
    type=stall)
  • Available:
    Use custom processing rule
  • Reserved Variable:
    event
  • Report Name:
    Custom
  • Context Data:
    (a.media.qoe.
    stallCount)
  • Data Feed:
    N/A
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    stallCount)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.stalls.value
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.stallCount

Total Stalling Duration

Implementation
±·±ð³Ù·É´Ç°ù°ìÌý±Ê²¹°ù²¹³¾±ð³Ù±ð°ù²õ
Reporting
  • SDK Key:
    Automatically set
  • API Key:
    N/A
  • Required:
    No
  • Type:
    number
  • Sent with:
    Media Close
  • Min. SDK Version: 1.5+
  • Sample Value:
    12
  • Description:
    The total time (seconds; integer) the playback was stalled during a playback session. Customers will have to create their own processing rules to have the value available for reporting.
  • ÃÛ¶¹ÊÓƵ Analytics:
    (a.media.qoe.
    stallTime)
  • Heartbeat:
    (s:event:
    type=stall)
  • Available:
    Use custom processing rule
  • Reserved Variable:
    event
  • Report Name:
    Custom
  • Context Data:
    (a.media.qoe.
    stallTime)
  • Data Feed:
    N/A
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    stallTime)
  • XDM Field Path:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.stallTime.value
  • Reporting XDM Field Path:
    mediaReporting.qoeDataDetails.stallTime
  • Android -
  • iOS -
  • Javascript -
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb