DocumentaciónAnalyticsGuía de servicios de medios de streaming

Posición del 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 Posición del capítulo. Ver Posición del capítulo para la dimensión de informe correspondiente.

style
shade-box

La variable de posición del capítulo es el índice del capítulo dentro del contenido, comenzando en 1 (típico) o 0 (según la convención). Utilice un índice estable por capítulo para que el mismo capítulo se acumule entre sesiones.

Propiedad
Valor
Variable de datos de contexto
a.media.chapter.position
Campo de colección XDM
xdm.mediaCollection.chapterDetails.index
rasgo de Audience Manager
c_contextdata.a.media.chapter.position
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 index dentro de xdm.mediaCollection.chapterDetails al llamar a sendEvent:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.chapterStart",
    mediaCollection: {
      chapterDetails: {
        friendlyName: "Pilot Episode - Opening",
        index: 1,
        offset: 0,
        length: 240
      },
      sessionID: "{sid}",
      playhead: 0
    }
  }
});
iOS

Pase la posición del capítulo como segundo argumento a createChapterObject.

code language-swift 
let chapterObject = Media.createChapterObjectWith(name: "Pilot Episode - Opening",
                                              position: 1,
                                                length: 240,
                                             startTime: 0)

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

Pase la posición del capítulo como segundo argumento a createChapterObject.

code language-kotlin 
val chapterObject = Media.createChapterObject("Pilot Episode - Opening",
                                              1L,
                                              240.0,
                                              0.0)

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

Establecer index 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": "Pilot Episode - Opening",
                "index": 1,
                "offset": 0,
                "length": 240
            },
            "playhead": 0
        }
    }
})
API de Media Edge

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

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

Tipos de implementación heredados (solo Analytics)

Media SDK JS 3.x

Pase la posición del capítulo como segundo argumento a ADB.Media.createChapterObject:

code language-javascript 
var chapterInfo = ADB.Media.createChapterObject(
  "Pilot Episode - Opening",
  1,
  240,
  0
);

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

Pase la posición del capítulo como segundo argumento a ADBMobile.media.createChapterObject:

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

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

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "chapterStart",
  "params": {
    "media.chapter.index": 1
  }
}

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

recommendation-more-help
media-analytics-help