Show Menu
TOPICS×

Tracking von Kapiteln und Segmenten in iOS

Mit den folgenden Anweisungen können Sie die Implementierung unter Verwendung der 2.x-SDKs vornehmen. Wenn Sie Version 1.x 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
    :
    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.