Effectuer le suivi des chapitres et des segments sur iOS track-chapters-and-segments-on-ios
Les instructions suivantes fournissent des conseils pour la mise en œuvre à l’aide des kits SDK 2.x.
-
Identifiez le moment où a lieu l’événement de début de chapitre et créez l’instance
ChapterObject
à l’aide des informations de chapitre.ChapterObject
référence de suivi de chapitre :note note NOTE Ces variables ne sont nécessaires que si vous envisagez d’effectuer le suivi des chapitres. 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 Nom de variable Description Obligatoire name
Nom du chapitre Oui position
Position du chapitre Oui length
Durée du chapitre Oui startTime
Heure de début du chapitre Oui Objet de chapitre :
code language-none id chapterObject = [ADBMediaHeartbeat createChapterObjectWithName:[CHAPTER_NAME] position:[POSITION] length:[LENGTH] startTime:[START_TIME]];
-
Si vous incluez des métadonnées personnalisées pour le chapitre, créez les variables de données contextuelles pour les métadonnées :
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"];
-
Pour lancer le suivi de la lecture du chapitre, appelez l’événement
ChapterStart
dans l’instanceMediaHeartbeat
:code language-none - (void)onChapterStart:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterStart mediaObject:chapterObject data:chapterDictionary]; }
-
Lorsque la lecture atteint la limite de fin du chapitre, comme défini par votre code personnalisé, appelez l’événement
ChapterComplete
dans l’instanceMediaHeartbeat
:code language-none - (void)onChapterComplete:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterComplete mediaObject:nil data:nil]; }
-
Si la lecture du chapitre ne s’est pas terminée car l’utilisateur a choisi d’ignorer le chapitre (par exemple, si l’utilisateur effectue une recherche en dehors de la limite du chapitre), appelez l’événement
ChapterSkip
dans l’instance MediaHeartbeat :code language-none - (void)onChapterSkip:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterSkip mediaObject:nil data:nil]; }
-
S’il existe d’autres chapitres, répétez les étapes 1 à 5.