Tracciare capitoli e segmenti su iOS

Ultimo aggiornamento: 2023-01-23
  • Argomenti:
  • Media Analytics
    Visualizza ulteriori informazioni su questo argomento
  • Creato per:
  • User
    Admin
    Developer

Le istruzioni seguenti forniscono indicazioni per l’implementazione utilizzando gli SDK 2.x.

IMPORTANTE

Se implementi una versione 1.x dell'SDK, puoi scaricare la Guida per gli sviluppatori qui: Scaricare gli SDK.

  1. Identifica quando si verifica l’evento di inizio del capitolo e crea l’istanza ChapterObject utilizzando le informazioni sul capitolo.

    Riferimento di tracciamento dei capitoli ChapterObject:

    NOTA

    Queste variabili sono necessarie solo se intendi tenere traccia dei capitoli.

    Nome variabile Descrizione Obbligatorio
    name Nome del capitolo
    position Posizione del capitolo
    length Durata capitolo
    startTime Ora di inizio capitolo

    Oggetto capitolo:

    id chapterObject =
      [ADBMediaHeartbeat createChapterObjectWithName:[CHAPTER_NAME]
                         position:[POSITION]
                         length:[LENGTH]
                         startTime:[START_TIME]];
    
  2. Se includi metadati personalizzati per il capitolo, crea le variabili di dati di contesto per i metadati:

    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. Per iniziare a tenere traccia della riproduzione del capitolo, chiama l’evento ChapterStart nell’istanza MediaHeartbeat.

    - (void)onChapterStart:(NSNotification *)notification {
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterStart
                         mediaObject:chapterObject
                         data:chapterDictionary];
    }
    
  4. Quando la riproduzione raggiunge il limite finale del capitolo, come definito dal codice personalizzato, chiama l’evento ChapterComplete nell’istanza MediaHeartbeat.

    - (void)onChapterComplete:(NSNotification *)notification {
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterComplete
                         mediaObject:nil
                         data:nil];
    }
    
  5. Se la riproduzione del capitolo non è stata completata perché l’utente ha scelto di saltare il capitolo (ad esempio, se l’utente effettua una ricerca fuori dal limite del capitolo), chiama l’evento ChapterSkip nell’istanza MediaHeartbeat:

    - (void)onChapterSkip:(NSNotification *)notification {
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterSkip
                         mediaObject:nil
                         data:nil];
    }
    
  6. Se ci sono capitoli aggiuntivi, ripeti i punti da 1 a 5.

In questa pagina