DocumentazioneAnalyticsGuida ai servizi Streaming Media

Riprende il contenuto

Ultimo aggiornamento: 29 maggio 2026

Creato per:

  • Developer

In questa pagina viene illustrata la raccolta dati per la variabile Content resumes. Vedere Content resumes per la metrica di reporting corrispondente.

style
shade-box

Il contenuto riprende la variabile contrassegna una sessione che riprende una riproduzione precedentemente interrotta. Impostarlo su media.sessionStart in modo che il backend conteggi un evento Content resumes per la sessione e lo escluda dai conteggi dei nuovi flussi. Per le implementazioni API direct API e Edge, il client è responsabile del rilevamento delle sessioni riprese (ad esempio, dopo un buffer, una pausa o un arresto superiore a 30 minuti) e dell’impostazione di questo flag di conseguenza.

Proprietà
Valore
Variabile di dati di contesto
a.media.resume
Campo raccolta XDM
xdm.mediaCollection.sessionDetails.hasResume
Caratteristica Audience Manager
N/D
Obbligatorio
No
Inviato con
Inizio sessione

Tipi di implementazione consigliati

Web SDK

Imposta hasResume su true all’interno di xdm.mediaCollection.sessionDetails quando chiama sendEvent per la sessione ripresa:

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

Passa il flag di ripresa come parte del bundle di configurazione opzionale dell’oggetto multimediale su trackSessionStart. Utilizza la chiave MediaConstants.MediaObjectKey.RESUMED.

code language-swift 
var mediaObject = Media.createMediaObjectWith(name: "My Video",
                                                id: "video-123",
                                            length: 128,
                                        streamType: MediaConstants.StreamType.VOD,
                                         mediaType: MediaType.Video)
mediaObject?[MediaConstants.MediaObjectKey.RESUMED] = true

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

Passa il flag di ripresa come parte del bundle di configurazione opzionale dell’oggetto multimediale su trackSessionStart. Utilizza la chiave MediaConstants.MediaObjectKey.RESUMED.

code language-kotlin 
val mediaInfo = Media.createMediaObject("My Video",
                                        "video-123",
                                        128,
                                        MediaConstants.StreamType.VOD,
                                        Media.MediaType.Video)
mediaInfo[MediaConstants.MediaObjectKey.RESUMED] = true

tracker.trackSessionStart(mediaInfo, null)
Roku

Imposta hasResume su true all’interno di xdm.mediaCollection.sessionDetails quando chiama createMediaSession per la sessione ripresa:

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",
                "hasResume": true
            },
            "playhead": 60
        }
    }
})
API Media Edge

Chiama l’endpoint sessionStart con hasResume impostato su true in 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",
          "hasResume": true
        },
        "playhead": 60
      }
    }
  }]
}

Tipi di implementazione legacy (solo Analytics)

Media SDK JS 3.x

Impostare la chiave RESUMED sull’oggetto informazioni multimediali prima di chiamare trackSessionStart:

code language-javascript 
var mediaInfo = ADB.Media.createMediaObject(
  "My Video",
  "video-123",
  128,
  ADB.Media.StreamType.VOD,
  ADB.Media.MediaType.Video
);
mediaInfo[ADB.Media.MediaObjectKey.Resumed] = true;

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Imposta MediaResumed sull’oggetto informazioni multimediali prima di chiamare trackSessionStart:

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.MediaResumed] = true;
ADBMobile.media.trackSessionStart(mediaInfo, null);
API Media Collection

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

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

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

recommendation-more-help
media-analytics-help