DocumentationAnalyticsStreaming media services guide

Day part

Last update: June 8, 2026

CREATED FOR:

  • Developer

This page covers data collection for the Day part variable. See Day part for the corresponding reporting dimension.

style
shade-box

The day part variable is the time-of-day bucket when the content was broadcast or played (for example, "Morning", "Afternoon", "Primetime", or "Late Night"). Any string is accepted. Use it to compare engagement across dayparts independent of the viewer’s local time zone.

Property
Value
Context data variable
a.media.dayPart
XDM collection field
xdm.mediaCollection.sessionDetails.dayPart
Audience Manager trait
c_contextdata.a.media.dayPart
Required
No
Sent with
Session start, session close
Web SDK

Set dayPart inside xdm.mediaCollection.sessionDetails when calling sendEvent:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        dayPart: "Primetime"
      },
      playhead: 0
    }
  }
});
iOS

Pass the day part as a metadata key in the HashMap argument to trackSessionStart. Use MediaConstants.VideoMetadataKeys.DAY_PART.

code language-swift 
var metadata: [String: String] = [:]
metadata[MediaConstants.VideoMetadataKeys.DAY_PART] = "Primetime"

tracker.trackSessionStart(info: mediaObject, metadata: metadata)
Android

Pass the day part as a metadata key in the HashMap argument to trackSessionStart. Use MediaConstants.VideoMetadataKeys.DAY_PART.

code language-kotlin 
val metadata = HashMap<String, String>()
metadata[MediaConstants.VideoMetadataKeys.DAY_PART] = "Primetime"

tracker.trackSessionStart(mediaInfo, metadata)
Roku Edge

Use createMediaSession to set dayPart inside sessionDetails:

code language-brightscript 
m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "dayPart": "Primetime"
            },
            "playhead": 0
        }
    }
})
Media Edge API

Call the sessionStart endpoint with dayPart inside xdm.mediaCollection.sessionDetails:

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.sessionStart",
      "mediaCollection": {
        "sessionDetails": {
          "name": "video-123",
          "length": 128,
          "contentType": "vod",
          "playerName": "HTML5 Player",
          "channel": "Sports",
          "dayPart": "Primetime"
        },
        "playhead": 0
      }
    }
  }]
}

Legacy implementation types (Analytics-only)

Media SDK JS 3.x

Pass the day part in the contextData object using ADB.Media.VideoMetadataKeys.DayPart:

code language-javascript 
var contextData = {};
contextData[ADB.Media.VideoMetadataKeys.DayPart] = "Primetime";

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Use ADBMobile.media.VideoMetadataKeys.DAY_PART to set the day part in the StandardMediaMetadata property of the media object before calling trackSessionStart:

code language-javascript 
var mediaInfo = ADBMobile.media.createMediaObject("My Video", "video-123", 128,
  ADBMobile.media.StreamType.VOD, ADBMobile.media.MediaType.Video);
var standardMetadata = {};
standardMetadata[ADBMobile.media.VideoMetadataKeys.DAY_PART] = "Primetime";
mediaInfo[ADBMobile.media.MediaObjectKey.StandardMediaMetadata] = standardMetadata;
ADBMobile.media.trackSessionStart(mediaInfo, null);
Roku 2.x

Use MEDIA_VideoMetadataKeyDAY_PART to set the day part in the standard metadata of the media object before calling mediaTrackSessionStart:

code language-brightscript 
adb = ADBMobile()
mediaInfo = adb_media_init_mediainfo("My Video", "video-123", 128.0, adb.MEDIA_STREAM_TYPE_VOD, adb.MEDIA_TYPE_VIDEO)

standardMetadata = {}
standardMetadata[adb.MEDIA_VideoMetadataKeyDAY_PART] = "Primetime"
mediaInfo[adb.MEDIA_STANDARD_MEDIA_METADATA] = standardMetadata

adb.mediaTrackSessionStart(mediaInfo, invalid)
Media Collection API

Include media.dayPart in the params object:

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.dayPart": "Primetime"
  }
}

See the Media Collection API sessions reference for the full request structure.

recommendation-more-help
media-analytics-help