DocumentazioneAnalyticsGuida di Media Analytics

Tracciare capitoli e segmenti su iOS track-chapters-and-segments-on-ios

Last update: Mon Jan 23 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • User
  • Admin
  • Developer

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

IMPORTANT
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:

    note note
    NOTE
    Queste variabili sono necessarie solo se intendi tenere traccia dei capitoli.
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center
    Nome variabile Descrizione Obbligatorio
    name Nome del capitolo Sì
    position Posizione del capitolo Sì
    length Durata capitolo Sì
    startTime Ora di inizio capitolo Sì

    Oggetto capitolo:

    code language-none 
    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:

    code language-none 
    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.

    code language-none 
    - (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.

    code language-none 
    - (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:

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

  6. Se ci sono capitoli aggiuntivi, ripeti i punti da 1 a 5.

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