DocumentaçãoAnalyticsGuia de serviços para mídia de streaming

Extensão do conteúdo

Última atualização: 29 de maio de 2026

Criado para:

  • Developer

Esta página aborda a coleta de dados da variável Comprimento do conteúdo. Consulte Comprimento do conteúdo para a dimensão de relatório correspondente.

style
shade-box

A variável de comprimento do conteúdo é a duração total do conteúdo em segundos. É necessário para todas as implementações de mídia de transmissão e deve ser definido no início da sessão. A duração do conteúdo direciona várias métricas calculadas de back-end, incluindo marcadores de progresso (25/10/50/75/95%) e Público-alvo médio por minuto. Se o comprimento do conteúdo não for definido ou não for maior que zero, essas métricas não serão produzidas. Para fluxos ao vivo com duração desconhecida, use 86400 (24 horas).

Propriedade
Valor
Variável de dados de contexto
a.media.length
Campo da coleção XDM
xdm.mediaCollection.sessionDetails.length
Característica do Audience Manager
c_contextdata.a.media.length
Obrigatório
Sim
Enviado com
Início da sessão, fechamento da sessão

Tipos de implementação recomendados

Web SDK

Definir length dentro de xdm.mediaCollection.sessionDetails ao chamar 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

Transmita a duração do conteúdo em segundos como o argumento length para 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

Transmita a duração do conteúdo em segundos como o argumento length para createMediaObject.

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

tracker.trackSessionStart(mediaInfo, null)
Roku

Definir length dentro de xdm.mediaCollection.sessionDetails ao chamar 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
        }
    }
})
API do Media Edge

Chame o ponto de extremidade sessionStart com length dentro de 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
      }
    }
  }]
}

Tipos de implementação herdada (somente Analytics)

Media SDK JS 3.x

Passe a duração do conteúdo em segundos como o terceiro argumento para 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

Passe a duração do conteúdo em segundos como o terceiro argumento para 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);
API da coleção de mídia

Inclua media.length no objeto params de sua solicitação POST sessionStart:

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

Consulte a Referência de sessões da API Media Collection para obter a estrutura de solicitação completa.

recommendation-more-help
media-analytics-help