DokumentationAnalyticsStreaming Media Collection-Handbuch

Tracking von Kapiteln und Segmenten mit JavaScript 3.x track-chapters-and-segments-on-javascript

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Benutzende
  • Admin
  • Entwickler

Mit den folgenden Anweisungen können Sie die Implementierung unter Verwendung der 3.x-SDKs vornehmen.

IMPORTANT
Wenn Sie vorherige Versionen des SDKs implementieren möchten, können Sie hier das Entwicklerhandbuch herunterladen: SDKs herunterladen.

  1. Ermitteln Sie, wann das Kapitel beginnt, und erstellen Sie die ChapterObject-Instanz mithilfe dieser Kapitelinformationen.

    Kapitel-Tracking-Referenz ChapterObject:

    note note
    NOTE
    Diese Variablen sind nur erforderlich, wenn Sie Kapitel verfolgen möchten.
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
    Variablenname Typ Beschreibung
    name string Nicht leere Zeichenfolge, die den Kapitelnamen angibt.
    position number Die Positionsnummer des Kapitels innerhalb des Inhalts, beginnend bei 1.
    length number Positive Zahl, die die Länge des Kapitels angibt.
    startTime number Wert des Abspielkopfs am Beginn des Kapitels.

    Kapitelobjekt:

    code language-js 
    var chapterObject =
  ADB.Media.createChapterObject.createChapterObject(<CHAPTER_NAME>,
                                     <POSITION>,
                                     <LENGTH>,
                                     <START_TIME>);

  2. Wenn Sie anwenderspezifische Metadaten für das Kapitel hinzufügen, erstellen Sie die Kontextdaten-Variablen für die Metadaten:

    code language-js 
    var chapterMetadata = {};
chapterMetadata["segmentType"] = "Sample segment type";

  3. Um das Tracking der Kapitelwiedergabe zu starten, rufen Sie das ChapterStart-Ereignis in der MediaHeartbeat-Instanz auf:

    code language-js 
    _onChapterStart = function() {
  tracker.trackEvent(ADB.Media.Event.ChapterStart, chapterObject, chapterMetadata);

};

  4. Wenn die Wiedergabe das Kapitelende nach Definition Ihres anwenderspezifischen Codes erreicht, rufen Sie das ChapterComplete-Ereignis in der MediaHeartbeat-Instanz auf:

    code language-js 
    _onChapterComplete = function() {
   tracker.trackEvent(ADB.Media.Event.ChapterComplete);
};

  5. Wenn die Kapitelwiedergabe nicht abgeschlossen wurde, weil der Anwender das Kapitel übersprungen hat (z. B. zu einer Position außerhalb des Kapitels springt), rufen Sie das ChapterSkip-Ereignis in der MediaHeartbeat-Instanz auf:

    code language-js 
    _onChapterSkip = function() {
    tracker.trackEvent(ADB.Media.Event.ChapterSkip);
};

  6. Wiederholen Sie die Schritte 1 bis 5, wenn es weitere Kapitel gibt.

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb