Media feed type

This page covers data collection for the Media feed type variable. See Media feed type for the corresponding reporting dimension.

The media feed type variable identifies the broadcast feed (for example, "East-HD", "West-SD", or "4K"). Use it when the same content is delivered through multiple regional or quality feeds and engagement needs to be broken out per feed.

Property
Value
Context data variable
a.media.feed
XDM collection field
mediaCollection.sessionDetails.feed
Required
No
Sent with
Session start, session close

Web SDK

Set feed inside mediaCollection.sessionDetails when calling sendEvent:

alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        feed: "East-HD"
      },
      playhead: 0
    }
  }
});

Mobile SDK

Pass the feed type as a metadata key in the HashMap argument to trackSessionStart. Use MediaConstants.VideoMetadataKeys.MEDIA_FEED.

iOS (Swift)

var metadata: [String: String] = [:]
metadata[MediaConstants.VideoMetadataKeys.MEDIA_FEED] = "East-HD"

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

Android (Kotlin)

val metadata = HashMap<String, String>()
metadata[MediaConstants.VideoMetadataKeys.MEDIA_FEED] = "East-HD"

tracker.trackSessionStart(mediaInfo, metadata)

Roku (BrightScript)

Use createMediaSession to set feed inside sessionDetails:

m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "feed": "East-HD"
            },
            "playhead": 0
        }
    }
})

Media Edge API

Call the sessionStart endpoint with feed inside mediaCollection.sessionDetails:

{
  "events": [{
    "xdm": {
      "eventType": "media.sessionStart",
      "mediaCollection": {
        "sessionDetails": {
          "name": "video-123",
          "length": 128,
          "contentType": "vod",
          "playerName": "HTML5 Player",
          "channel": "Sports",
          "feed": "East-HD"
        },
        "playhead": 0
      }
    }
  }]
}

Media SDK

Pass the feed in the contextData object using ADB.Media.VideoMetadataKeys.Feed:

var contextData = {};
contextData[ADB.Media.VideoMetadataKeys.Feed] = "East-HD";

tracker.trackSessionStart(mediaInfo, contextData);

Media Collection API

Include media.feed in the params object:

{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.feed": "East-HD"
  }
}

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

recommendation-more-help
media-analytics-help