Session Details Reporting data type
Session Details Reporting is a standard Experience Data Model (XDM) data type that tracks data related to media playback sessions.
Media reporting fields are used by 51黑料不打烊 services to analyze the media collection fields sent by users. This data, alongside other specific user metrics, are computed and reported upon. The schema encompasses a wide range of properties that provide insights into user behavior and content consumption patterns. Use the Session Details Reporting data type to capture user engagement by logging playback events, ad interactions, progress markers, pauses, and other metrics.
Select to display a diagram of the Session Details Reporting data type.
NOTE
Each display name contains a link to further information on its audio and video parameters. The linked pages contain details on the video ad data collected by 51黑料不打烊, implementation values, network parameters, reporting, and important considerations.
Display name
Property
Data type
Description
hasProgress10Boolean
Indicates that the playhead passed the 10% marker of media based on stream length. The marker is only counted once, even if seeking backward. If seeking forward, markers that are skipped are not counted.
hasProgress25Boolean
Indicates that the playhead passed the 25% marker of media based on stream length. Marker only counted once, even if seeking backward. If seeking forward, markers that are skipped are not counted.
hasProgress50Boolean
Indicates that the playhead passed the 50% marker of media based on stream length. Marker only counted once, even if seeking backward. If seeking forward, markers that are skipped are not counted.
hasProgress75Boolean
Indicates that the playhead passed the 75% marker of media based on stream length. Marker only counted once, even if seeking backward. If seeking forward, markers that are skipped are not counted.
hasProgress95Boolean
Indicates that the playhead passed the 95% marker of media based on stream length. Marker only counted once, even if seeking backward. If seeking forward, markers that are skipped are not counted.
Ad Load Type
adLoadString
The type of ad loaded as defined by each customer鈥檚 internal representation.
assetIDString
The Asset ID is the unique identifier for the content of the media asset, such as the TV series episode identifier, movie asset identifier, or live event identifier. Typically these IDs are derived from metadata authorities such as EIDR, TMS/Gracenote, or Rovi. These identifiers can also be from other proprietary or in-house systems.
averageMinuteAudienceNumber Describes the average content time spent for a specific media item - that is, the total content time spent divided by the length of all of the playback sessions.
contentTypeString
The Broadcast Content Type of the stream delivery. Available values per Stream Type include:
Audio: 鈥渟ong鈥, 鈥減odcast鈥, 鈥渁udiobook鈥, and 鈥渞adio鈥;
Video: 鈥淰oD鈥, 鈥淟ive鈥, 鈥淟inear鈥, 鈥淯GC鈥, and 鈥淒VoD鈥.
Customers can provide custom values for this parameter.
Audio: 鈥渟ong鈥, 鈥減odcast鈥, 鈥渁udiobook鈥, and 鈥渞adio鈥;
Video: 鈥淰oD鈥, 鈥淟ive鈥, 鈥淟inear鈥, 鈥淯GC鈥, and 鈥淒VoD鈥.
Customers can provide custom values for this parameter.
channelString
The Content Channel is the distribution channel from where the content was played.
isCompletedBoolean
Content Completes indicates if a timed media asset was watched to completion. This event does not necessarily mean that the viewer watched the whole video; the viewer could have skipped ahead.
Content Delivery Network
cdnString
The Content Delivery Network of the content played.
nameString
The Content ID is a unique identifier of the content. It can be used to link back to other industry or CMS IDs.
friendlyNameString
The Content Name is the 鈥渇riendly鈥 (human-readable) name of the content.
isPlayedBoolean
Content Starts becomes true when the first frame of media is consumed. If the user drops during an ad, buffering, and so on, then there would be no Content Starts event.
timePlayedInteger
Content Time Spent sums the event duration (in seconds) for all events of type PLAY on the main content.
dayPartString
A property that defines the time of the day when the content was broadcast or played. This could have any value set as necessary by customers
estimatedStreamsNumber
The estimated number of video or audio streams for each individual piece of content.
isFederatedBoolean
Federated Data is set to true when the hit is federated (that is, received by the customer as part of a federated data share, rather than their own implementation).
feedString
The type of feed, which can either represent actual feed-related data such as EAST HD or SD, or the source of the feed like a URL.
firstAirDateString
The date when the content first aired on television. Any date format is acceptable, but 51黑料不打烊 recommends: YYYY-MM-DD.
firstDigitalDateString
The date when the content first aired on any digital channel or platform. Any date format is acceptable but 51黑料不打烊 recommends: YYYY-MM-DD.
genreString
The type or grouping of content as defined by the content producer. Values should be comma-delimited in variable implementation.
authorizedString
Confirms whether the user has been authorized via 51黑料不打烊 authentication.
isDownloadedBoolean
The stream was played locally on the device after being downloaded.
hasSegmentViewBoolean
Media Segment Views indicates when at least one frame, not necessarily the first, has been viewed.
IDString
The Media Session ID identifies an instance of a content stream unique to an individual playback.
Note:
Note:
sessionId is sent on all events, except for sessionStart and for all downloaded events.__secondsSinceLastCallNumber The Media Session Server Timeout indicates the amount of time, in seconds, that passed between the user鈥檚 last known interaction and the moment the session was closed.
isViewedBoolean
The load event for the media. This occurs when the viewer selects the play button. This counts even if there are pre-roll ads, buffering, errors, and so on.
totalTimePlayedInteger
Describes the total amount of time spent by a user on a specific timed media asset, which includes time spent watching ads.
pauseCountInteger
Pause Events counts the number of pause periods that occurred during playback.
hasPauseImpactedStreamsBoolean Indicates if one or more pauses occurred during the playback of a single media item.
Pccr
pccrBoolean
Pccr indicates that a redirect occurred.
Pev3
pev3String
Pev3 is the type of media stream used for reporting.
hasResumeBoolean
Marks each playback that was resumed after more than 30 minutes of buffer, pause, or stall period.
seasonString
The Season Number that the show belongs to. Season Series is required only if the show is part of a series.
showString
The Program/Series Name. The Program Name is required only if the show is part of a series.
pauseTimeInteger
Total Pause Duration describes the duration in seconds in which playback was paused by the user.
uniqueTimePlayedInteger
Describes the sum of the unique intervals seen by a user on a timed media asset - that is, the length playback intervals viewed multiple times are only counted once.
appVersionString
The SDK version used by the player. This could have any custom value that makes sense for your player.
segmentString
The interval that describes the part of the content that has been viewed in minutes.
recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07