Nachverfolgen von Kapiteln und Segmenten auf iOS

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

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

   Kapitel-Tracking-Referenz ChapterObject:

   HINWEIS

   Diese Variablen sind nur erforderlich, wenn Sie Kapitel verfolgen möchten.

   Variablenname	Beschreibung	erforderlich
   name	Kapitelname	Ja
   position	Kapitelposition	Ja
   length	Kapitellänge	Ja
   startTime	Startzeit des Kapitels	Ja

   Kapitelobjekt:

   id chapterObject =
     [ADBMediaHeartbeat createChapterObjectWithName:[CHAPTER_NAME]
                        position:[POSITION]
                        length:[LENGTH]
                        startTime:[START_TIME]];
   

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

   NSMutableDictionary *chapterDictionary = [[NSMutableDictionary alloc] init];
   [chapterDictionary setObject:@"Sample segment type" forKey:@"segmentType"];
   [chapterDictionary setObject:@"Sample segment name" forKey:@"segmentName"];
   [chapterDictionary setObject:@"Sample segment info" forKey:@"segmentInfo"];
   

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

   - (void)onChapterStart:(NSNotification *)notification {
       [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterStart
                        mediaObject:chapterObject
                        data:chapterDictionary];
   }
   

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

   - (void)onChapterComplete:(NSNotification *)notification {
       [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterComplete
                        mediaObject:nil
                        data:nil];
   }
   

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:

   - (void)onChapterSkip:(NSNotification *)notification {
       [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterSkip
                        mediaObject:nil
                        data:nil];
   }
   

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

Ressourcen für Business.Adobe.com