Documentation Analytics Guide des services des médias en streaming

Début du chapitre

Dernière mise à jour : 30 septembre 2026

Rubriques :
Analysis Workspace

Créé pour :

Développeur

L’événement de début de chapitre signale le début d’un chapitre dans le contenu. Le suivi des chapitres est facultatif et n’est pas obligatoire pour le suivi des médias principaux. Les chapitres ne peuvent pas se chevaucher ; envoyez Chapitre terminé ou Saut de chapitre pour fermer le chapitre actuel avant d’en démarrer un nouveau.

Conditions préalables : début de session
Mesure associée : Le chapitre commence

Types d’implémentation recommandés

SDK Web

Appelez sendEvent avec les eventType: "media.chapterStart" et les chapterDetails requises :

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

Transmettez le nom, la position, la longueur et l’heure de début du chapitre à createChapterObject, puis appelez trackEvent.

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

Transmettez le nom, la position, la longueur et l’heure de début du chapitre à createChapterObject, puis appelez trackEvent.

code language-kotlin
`val chapterObject = Media.createChapterObject("Pilot Episode - Opening", 1, 240, 0) tracker.trackEvent(Media.Event.ChapterStart, chapterObject, null)`

Roku Edge

Appelez sendMediaEvent avec les eventType: "media.chapterStart" et les chapterDetails requises :

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 Media Edge

Appelez le point d’entrée chapterStart avec les chapterDetails requises :

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"
    }
  }]
}'

Types d’implémentation hérités (Analytics uniquement)

Media SDK JS 3.x

Transmettez le nom, la position, la longueur et l’heure de début du chapitre à 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

Transmettez le nom, la position, la longueur et l’heure de début du chapitre à 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);

Roku 2.x

Créez un objet de chapitre avec adb_media_init_chapterinfo, puis suivez l’événement :

code language-brightscript
`adb = ADBMobile() chapterInfo = adb_media_init_chapterinfo("Pilot Episode - Opening", 1, 240.0, 0.0) ' name, position, length, startTime adb.mediaTrackEvent(adb.MEDIA_CHAPTER_START, chapterInfo)`

API Media Collection

Envoyez une chapterStart POST au point d’entrée événements :

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