DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Versatz des Kapitels

Letzte Aktualisierung: 29. Mai 2026

Erstellt für:

  • Developer

Auf dieser Seite wird die Datenerfassung für die Variable Chapter Offset​behandelt. Siehe Kapitelversatz für die entsprechende Reporting-Dimension.

style
shade-box

Die Variable für den Kapitelversatz ist der Versatz des Kapitels innerhalb des Inhalts, gemessen in Sekunden ab Beginn. Das erste Kapitel hat in der Regel 0. Nachfolgende Kapitel haben Versätze, die mit ihrer Abspielkopfstartzeit übereinstimmen.

Eigenschaft
Wert
Kontextdatenvariable
a.media.chapter.offset
XDM-Sammlungsfeld
xdm.mediaCollection.chapterDetails.offset
Audience Manager-Eigenschaft
c_contextdata.a.media.chapter.offset
Erforderlich
Nein (Mobile SDK); Ja (Edge, Mediensammlungs-API)
Gesendet mit
Kapitelstart, Kapitelschluss

Empfohlene Implementierungsarten

Web SDK

offset in xdm.mediaCollection.chapterDetails festlegen, wenn sendEvent aufgerufen wird:

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

Übergeben Sie den Versatz in Sekunden als viertes Argument (startTime) an 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

Übergeben Sie den Versatz in Sekunden als viertes Argument (startTime) an createChapterObject.

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

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

Legen Sie offset in xdm.mediaCollection.chapterDetails fest, wenn Sie sendMediaEvent für media.chapterStart aufrufen:

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

Rufen Sie den chapterStart-Endpunkt mit offset in xdm.mediaCollection.chapterDetails auf:

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

Legacy-Implementierungstypen (nur Analytics)

Media SDK JS 3.x

Übergeben Sie den Versatz als viertes Argument an 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

Übergeben Sie den Kapitelversatz in Sekunden als viertes Argument (startTime) an 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);
Media Collection API

Fügen Sie media.chapter.offset in das params Ihrer chapterStart POST-Anfrage ein:

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

Die vollständige Anfragestruktur ​ Sie in der ​ zur Mediensammlungs-API-Ereignisreferenz .

recommendation-more-help
media-analytics-help