DocumentatieAnalyticsHandleiding voor streaming-mediaservices

Markering voor gedownloade media

Laatst bijgewerkt: 29 mei 2026

Gemaakt voor:

  • Developer

Deze pagina behandelt gegevensinzameling voor de gedownloade media vlag​variabele. Zie ​ gedownloade Media ​ voor de overeenkomstige het melden afmeting.

style
shade-box

De markering voor gedownloade media geeft aan dat een sessie bestaat uit het afspelen van eerder gedownloade offline inhoud in plaats van een live stream van internet. Stel deze in bij het initialiseren van de tracker (Mobile SDK) of neem deze op in de sessionStart payload (Edge / Media Collection API). Gebruik deze markering om het offline afspelen tijdens de rapportage te scheiden van gestreamde sessies.

Eigenschap
Waarde
de gegevensvariabele van de context
a.media.downloaded
XDM inzamelingsgebied
xdm.mediaCollection.sessionDetails.isDownloaded
eigenschap van Audience Manager
c_contextdata.a.media.downloaded
Vereist
Nee
Verzonden met
​ Begin van de Zitting ​, zittingsdichte

Aanbevolen implementatietypen

SDK van het Web

Stel isDownloaded in op true inside xdm.mediaCollection.sessionDetails wanneer u sendEvent ​ aanroept:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        name: "video-123",
        length: 128,
        contentType: "vod",
        playerName: "HTML5 Player",
        channel: "Sports",
        streamType: "video",
        isDownloaded: true
      },
      playhead: 0
    }
  }
});
iOS

Stel de markering voor gedownloade inhoud in de tracker-config in wanneer u de tracker maakt met behulp van MediaConstants.TrackerConfig.DOWNLOADED_CONTENT .

code language-swift 
var config: [String: Any] = [:]
config[MediaConstants.TrackerConfig.PLAYER_NAME] = "HTML5 Player"
config[MediaConstants.TrackerConfig.CHANNEL] = "Sports"
config[MediaConstants.TrackerConfig.DOWNLOADED_CONTENT] = true

Media.createTrackerWith(config: config) { tracker in
    self.tracker = tracker
}
Android

Stel de markering voor gedownloade inhoud in de tracker-config in wanneer u de tracker maakt met behulp van MediaConstants.TrackerConfig.DOWNLOADED_CONTENT .

code language-kotlin 
val config = HashMap<String, Any>()
config[MediaConstants.TrackerConfig.PLAYER_NAME] = "HTML5 Player"
config[MediaConstants.TrackerConfig.CHANNEL] = "Sports"
config[MediaConstants.TrackerConfig.DOWNLOADED_CONTENT] = true

val tracker = Media.createTracker(config)
Roku

Stel isDownloaded in op true inside xdm.mediaCollection.sessionDetails wanneer u createMediaSession aanroept:

code language-brightscript 
m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "name": "video-123",
                "length": 128,
                "contentType": "vod",
                "playerName": "Roku Player",
                "channel": "Sports",
                "streamType": "video",
                "isDownloaded": true
            },
            "playhead": 0
        }
    }
})
Media Edge API

Roep het ​ gedownloade ​ eindpunt nadat het apparaat online terugkeert, batchend de volledige off-line zitting binnen mediaDownloadedEvents. Adobe stelt isDownloaded automatisch in op true en wijst een sessie-id toe. geen van beide in de lading opnemen.

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.downloaded",
      "mediaDownloadedEvents": [
        {
          "mediaEventTimestamp": "YYYY-09-26T15:52:24+00:00",
          "mediaEventType": "media.sessionStart",
          "mediaCollection": {
            "sessionDetails": {
              "name": "video-123",
              "length": 128,
              "contentType": "vod",
              "playerName": "HTML5 Player",
              "channel": "Sports"
            },
            "playhead": 0
          }
        },
        {
          "mediaEventTimestamp": "YYYY-09-26T15:54:32+00:00",
          "mediaEventType": "media.sessionComplete",
          "mediaCollection": {
            "playhead": 128
          }
        }
      ]
    }
  }]
}

Oudere implementatietypen (alleen voor analyse)

Media SDK JS 3.x

Stel downloadedContent in op ADB.MediaConfig voordat u de Beheer maakt:

code language-javascript 
var mediaConfig = new ADB.MediaConfig();
mediaConfig.trackingServer = "your.tracking.server";
mediaConfig.playerName = "HTML5 Player";
mediaConfig.channel = "Sports";
mediaConfig.downloadedContent = true;

var tracker = ADB.Media.getInstance(mediaConfig);
Chromecast

Stel MediaDownloaded in op het Media Info-object voordat u trackSessionStart aanroept:

code language-javascript 
var mediaInfo = ADBMobile.media.createMediaObject("My Video", "video-123", 128,
  ADBMobile.media.StreamType.VOD, ADBMobile.media.MediaType.Video);
mediaInfo[ADBMobile.media.MediaObjectKey.MediaDownloaded] = true;
ADBMobile.media.trackSessionStart(mediaInfo, null);
de Inzameling API van Media

Neem media.downloaded op in het params -object van uw sessionStart POST-aanvraag:

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

Zie de ​ Verwijzing van de Inzameling API van Media ​ voor de volledige verzoekstructuur.

recommendation-more-help
media-analytics-help