DocumentatieAnalyticsHandleiding voor streaming-mediaservices

Begin hoofdstuk

Laatst bijgewerkt: 29 mei 2026

Gemaakt voor:

  • Developer

De gebeurtenis start van het hoofdstuk geeft het begin van een hoofdstuk binnen de inhoud aan. Het bijhouden van hoofdstukken is optioneel en niet vereist voor het bijhouden van kernmedia. hoofdstukken kunnen elkaar niet overlappen; verzend ​ volledig Hoofdstuk ​ of ​ overslaan van het Hoofdstuk ​ om het huidige hoofdstuk te sluiten alvorens nieuwe te beginnen.

Aanbevolen implementatietypen

SDK van het Web

Roep sendEvent ​ met eventType: "media.chapterStart" en de vereiste chapterDetails aan:

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

Geef de naam, positie, lengte en begintijd van het hoofdstuk door aan createChapterObject en roep vervolgens trackEvent aan.

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

Geef de naam, positie, lengte en begintijd van het hoofdstuk door aan createChapterObject en roep vervolgens trackEvent aan.

code language-kotlin 
val chapterObject = Media.createChapterObject("Pilot Episode - Opening",
                                              1,
                                              240,
                                              0)

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

Roep sendMediaEvent aan met eventType: "media.chapterStart" en de vereiste chapterDetails :

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.chapterStart",
        "mediaCollection": {
            "chapterDetails": {
                "friendlyName": "Pilot Episode - Opening",
                "index": 1,
                "offset": 0,
                "length": 240
            },
            "playhead": 0
        }
    }
})
Media Edge API

Roep het ​ chapterStart ​ eindpunt met vereiste chapterDetails:

code language-sh 
curl -X POST "https://edge.adobedc.net/ee/va/v1/chapterStart?configId={datastreamID}" \
--header 'Content-Type: application/json' \
--data '{
  "events": [{
    "xdm": {
      "eventType": "media.chapterStart",
      "mediaCollection": {
        "sessionID": "{sid}",
        "playhead": 0,
        "chapterDetails": {
          "index": 1,
          "length": 240,
          "offset": 0
        }
      },
      "timestamp": "YYYY-08-20T22:41:40+00:00"
    }
  }]
}'

Oudere implementatietypen (alleen voor analyse)

Media SDK JS 3.x

Geef de naam, positie, lengte en begintijd van het hoofdstuk door aan ADB.Media.createChapterObject:

code language-javascript 
var chapterInfo = ADB.Media.createChapterObject(
  "Pilot Episode - Opening",  // name
  1,                          // position
  240,                        // length (seconds)
  0                           // start time (seconds)
);

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

Geef de naam, positie, lengte en begintijd van het hoofdstuk door aan ADBMobile.media.createChapterObject:

code language-javascript 
var chapterInfo = ADBMobile.media.createChapterObject(
  "Pilot Episode - Opening",  // name
  1,                          // position
  240,                        // length (seconds)
  0                           // start time (seconds)
);

ADBMobile.media.trackEvent(ADBMobile.media.Event.ChapterStart, chapterInfo, null);
de Inzameling API van Media

Verzend a chapterStart POST naar het ​ gebeurteniseindpunt ​:

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "chapterStart",
  "params": {
    "media.chapter.friendlyName": "Pilot Episode - Opening",
    "media.chapter.index": 1,
    "media.chapter.offset": 0,
    "media.chapter.length": 240
  }
}
recommendation-more-help
media-analytics-help