Nachverfolgen von Kapiteln und Segmenten auf iOS
Erstellt für:
- Benutzende
- Admin
- Entwickler
Mit den folgenden Anweisungen können Sie die Implementierung unter Verwendung der 2.x-SDKs vornehmen.
-
Ermitteln Sie, wann das Kapitel beginnt, und erstellen Sie die
ChapterObject
-Instanz mithilfe dieser Kapitelinformationen.Kapitel-Tracking-Referenz
ChapterObject
:NOTEDiese Variablen sind nur erforderlich, wenn Sie Kapitel verfolgen möchten.VariablennameBeschreibungerforderlichname
KapitelnameJaposition
KapitelpositionJalength
KapitellängeJastartTime
Startzeit des KapitelsJaKapitelobjekt:
id chapterObject = [ADBMediaHeartbeat createChapterObjectWithName:[CHAPTER_NAME] position:[POSITION] length:[LENGTH] startTime:[START_TIME]];
-
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"];
-
Um das Tracking der Kapitelwiedergabe zu starten, rufen Sie das
ChapterStart
-Ereignis in derMediaHeartbeat
-Instanz auf:- (void)onChapterStart:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterStart mediaObject:chapterObject data:chapterDictionary]; }
-
Wenn die Wiedergabe das Kapitelende nach Definition Ihres anwenderspezifischen Codes erreicht, rufen Sie das
ChapterComplete
-Ereignis in derMediaHeartbeat
-Instanz auf:- (void)onChapterComplete:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterComplete mediaObject:nil data:nil]; }
-
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]; }
-
Wiederholen Sie die Schritte 1 bis 5, wenn es weitere Kapitel gibt.