DokumentationAnalyticsGuide för direktuppspelande medietjänster

Innehållslängd

Senast uppdaterad: 29 maj 2026

Skapat för:

  • Developer

Den här sidan täcker datainsamling för variabeln Content length. Se Innehållslängd för motsvarande rapporteringsdimension.

style
shade-box

Variabeln content length är innehållets totala längd i sekunder. Den krävs för alla implementeringar av direktuppspelningsmedia och måste anges när sessionen startas. Innehållslängden genererar flera backend-beräknade mätvärden, inklusive förloppsmarkörer (10/25/50/75/95%) och genomsnittlig minipublik. Om innehållets längd inte har angetts, eller inte är större än noll, genereras inte dessa mått. Använd 86400 (24 timmar) för liveströmmar med okänd varaktighet.

Egenskap
Värde
Kontextdatavariabel
a.media.length
XDM-samlingsfält
xdm.mediaCollection.sessionDetails.length
Audience Manager trait
c_contextdata.a.media.length
Krävs
Ja
Skickat med
Sessionsstart, sessionsstängning

Rekommenderade implementeringstyper

SDK för webben

Ange length i xdm.mediaCollection.sessionDetails vid anrop till sendEvent:

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"
      },
      playhead: 0
    }
  }
});
iOS

Skicka innehållslängden i sekunder som argumentet length till createMediaObject.

code language-swift 
let mediaObject = Media.createMediaObjectWith(name: "My Video",
                                                id: "video-123",
                                            length: 128,
                                        streamType: MediaConstants.StreamType.VOD,
                                         mediaType: MediaType.Video)

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

Skicka innehållslängden i sekunder som argumentet length till createMediaObject.

code language-kotlin 
var mediaInfo = Media.createMediaObject("My Video",
                                        "video-123",
                                        128,
                                        MediaConstants.StreamType.VOD,
                                        Media.MediaType.Video)

tracker.trackSessionStart(mediaInfo, null)
Roku

Ange length i xdm.mediaCollection.sessionDetails vid anrop av createMediaSession:

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

Anropa slutpunkten sessionStart med length inuti 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"
        },
        "playhead": 0
      }
    }
  }]
}

Äldre implementeringstyper (endast analys)

Media SDK JS 3.x

Skicka innehållslängden i sekunder som det tredje argumentet till ADB.Media.createMediaObject:

code language-javascript 
var mediaInfo = ADB.Media.createMediaObject(
  "My Video",
  "video-123",
  128,                      // length in seconds
  ADB.Media.StreamType.VOD,
  ADB.Media.MediaType.Video
);

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Skicka innehållslängden i sekunder som det tredje argumentet till ADBMobile.media.createMediaObject:

code language-javascript 
var mediaInfo = ADBMobile.media.createMediaObject(
  "My Video",
  "video-123",
  128,
  ADBMobile.media.StreamType.VOD,
  ADBMobile.media.MediaType.Video
);
ADBMobile.media.trackSessionStart(mediaInfo, null);
Media Collection API

Inkludera media.length i params-objektet för din sessionStart POST-begäran:

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

Se API-sessionsreferensen för mediainsamling för den fullständiga strukturen för begäranden.

recommendation-more-help
media-analytics-help