Durata del contenuto

In questa pagina viene illustrata la raccolta dati per la variabile Content length. Vedi Lunghezza contenuto per la dimensione di reporting corrispondente.

La variabile della lunghezza del contenuto corrisponde alla durata totale del contenuto in secondi. È richiesta per tutte le implementazioni di Streaming Media e deve essere impostata all’inizio della sessione. La lunghezza del contenuto determina diverse metriche calcolate dal back-end, tra cui i marcatori di avanzamento (10/25/50/75/95%) e il pubblico medio in minuti. Se la lunghezza del contenuto non è impostata o non è maggiore di zero, tali metriche non vengono prodotte. Per i flussi live di durata sconosciuta, utilizzare 86400 (24 ore).

Web SDK

Imposta length all’interno di mediaCollection.sessionDetails quando chiama sendEvent:

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

Mobile SDK

Passa la lunghezza del contenuto in secondi come argomento length a createMediaObject.

iOS (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 (Cotlino)

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

tracker.trackSessionStart(mediaInfo, null)

Roku (BrightScript)

Imposta length in mediaCollection.sessionDetails quando chiama createMediaSession:

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 di Media Edge

Chiama l’endpoint sessionStart con length in mediaCollection.sessionDetails:

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

Media SDK

Passa la lunghezza del contenuto in secondi come terzo argomento a ADB.Media.createMediaObject:

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);

API Media Collection

Includi media.length nell’oggetto params della richiesta POST sessionStart:

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

Per la struttura completa delle richieste, consulta il Riferimento sessioni API di Media Collection.