DocumentaciónAnalyticsGuía de servicios de medios de streaming

Desplazamiento de capítulo

Última actualización: 29 de mayo de 2026

Creado para:

  • Developer

Esta página cubre la recopilación de datos para la variable Desplazamiento de capítulo. Ver Desplazamiento de capítulo para la dimensión de informe correspondiente.

style
shade-box

La variable de desplazamiento del capítulo es el desplazamiento del capítulo dentro del contenido, medido en segundos desde el inicio. El primer capítulo generalmente tiene un desplazamiento de 0; los capítulos subsiguientes tienen desplazamientos que coinciden con la hora de inicio del cabezal de reproducción.

Propiedad
Valor
Variable de datos de contexto
a.media.chapter.offset
Campo de colección XDM
xdm.mediaCollection.chapterDetails.offset
rasgo de Audience Manager
c_contextdata.a.media.chapter.offset
Requerido
No (Mobile SDK); Sí (Edge, API de Media Collection)
Enviado con
Inicio del capítulo, cierre del capítulo

Tipos de implementación recomendados

SDK web

Establecer offset dentro de xdm.mediaCollection.chapterDetails al llamar a sendEvent:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.chapterStart",
    mediaCollection: {
      chapterDetails: {
        friendlyName: "Act II",
        index: 2,
        offset: 240,
        length: 360
      },
      sessionID: "{sid}",
      playhead: 240
    }
  }
});
iOS

Pase el desplazamiento en segundos como el cuarto argumento (startTime) a createChapterObject.

code language-swift 
let chapterObject = Media.createChapterObjectWith(name: "Act II",
                                              position: 2,
                                                length: 360,
                                             startTime: 240)

tracker.trackEvent(event: MediaEvent.ChapterStart, info: chapterObject, metadata: nil)
Android

Pase el desplazamiento en segundos como el cuarto argumento (startTime) a createChapterObject.

code language-kotlin 
val chapterObject = Media.createChapterObject("Act II",
                                              2L,
                                              360.0,
                                              240.0)

tracker.trackEvent(Media.Event.ChapterStart, chapterObject, null)
Roku

Establecer offset dentro de xdm.mediaCollection.chapterDetails al llamar a sendMediaEvent para media.chapterStart:

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.chapterStart",
        "mediaCollection": {
            "chapterDetails": {
                "friendlyName": "Act II",
                "index": 2,
                "offset": 240,
                "length": 360
            },
            "playhead": 240
        }
    }
})
API de Media Edge

Llame al extremo chapterStart con offset dentro de xdm.mediaCollection.chapterDetails:

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.chapterStart",
      "mediaCollection": {
        "chapterDetails": {
          "index": 2,
          "offset": 240,
          "length": 360
        },
        "sessionID": "{sid}",
        "playhead": 240
      }
    }
  }]
}

Tipos de implementación heredados (solo Analytics)

Media SDK JS 3.x

Pase el desplazamiento como cuarto argumento a ADB.Media.createChapterObject:

code language-javascript 
var chapterInfo = ADB.Media.createChapterObject(
  "Act II",
  2,
  360,
  240
);

tracker.trackEvent(ADB.Media.Event.ChapterStart, chapterInfo, contextData);
Chromecast

Pase el desplazamiento del capítulo en segundos como el cuarto argumento (startTime) a ADBMobile.media.createChapterObject:

code language-javascript 
var chapterInfo = ADBMobile.media.createChapterObject(
  "Pilot Episode - Opening",  // name
  1,                          // position
  240,                        // length
  0                           // startTime (seconds from content start)
);
ADBMobile.media.trackEvent(ADBMobile.media.Event.ChapterStart, chapterInfo, null);
API de recopilación de medios

Incluir media.chapter.offset en el objeto params de su solicitud POST de chapterStart:

code language-json 
{
  "playerTime": { "playhead": 240, "ts": 1699523820000 },
  "eventType": "chapterStart",
  "params": {
    "media.chapter.offset": 240
  }
}

Consulte la referencia de eventos de API de Media Collection para obtener la estructura de solicitudes completa.

recommendation-more-help
media-analytics-help