DocumentatieAnalyticsHandleiding voor streaming-mediaservices

Lengte van inhoud

Laatst bijgewerkt: 29 mei 2026

Gemaakt voor:

  • Developer

Deze pagina behandelt gegevensinzameling voor de lengte van de Inhoud​variabele. Zie ​ lengte van de Inhoud ​ voor de overeenkomstige het melden afmeting.

style
shade-box

De variabele van de inhoudslengte is de totale duur van de inhoud in seconden. Dit is vereist voor alle streamingmedia-implementaties en moet bij het starten van de sessie worden ingesteld. De lengte van de inhoud drijft verscheidene achterste-bedachte metriek, met inbegrip van vooruitgangstellers (10/25/50/75/95%) en Gemiddelde Minuut Publiek. Als de lengte van de inhoud niet is ingesteld of niet groter is dan nul, worden deze meetgegevens niet gemaakt. Gebruik 86400 (24 uur) voor live streams met een onbekende duur.

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

Aanbevolen implementatietypen

SDK van het Web

Stel length inside xdm.mediaCollection.sessionDetails in bij het aanroepen van 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

Geef de lengte van de inhoud in seconden als het argument length door aan 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

Geef de lengte van de inhoud in seconden als het argument length door aan createMediaObject .

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

tracker.trackSessionStart(mediaInfo, null)
Roku

Stel length inside xdm.mediaCollection.sessionDetails in bij het aanroepen van 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

Roep het ​ sessionStart ​ eindpunt met length binnen 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
      }
    }
  }]
}

Oudere implementatietypen (alleen voor analyse)

Media SDK JS 3.x

Geef de lengte van de inhoud in seconden als het derde argument door aan 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

Geef de lengte van de inhoud in seconden als het derde argument door aan 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);
de Inzameling API van Media

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

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

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

recommendation-more-help
media-analytics-help