DocumentationAnalyticsGuide de collection des médias en streaming

Effectuer le suivi des chapitres et des segments à l’aide de JavaScript 3.x track-chapters-and-segments-on-javascript

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Utilisateur ou utilisatrice
  • Administration
  • Développeur

Les instructions suivantes fournissent des conseils pour la mise en œuvre à l’aide des kits SDK 3.x.

IMPORTANT
Si vous implémentez une version précédente du SDK, vous pouvez télécharger le Guide du développeur dans la rubrique Téléchargement des SDK.

  1. 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
    Nom de variable Type Description
    name string Chaîne non vide désignant le nom du chapitre.
    position number Position du chapitre dans le contenu, en commençant par 1.
    length number Nombre positif désignant la longueur du chapitre.
    startTime number Valeur de la tête de lecture au début du chapitre.

    Objet de chapitre :

    code language-js 
    var chapterObject =
  ADB.Media.createChapterObject.createChapterObject(<CHAPTER_NAME>,
                                     <POSITION>,
                                     <LENGTH>,
                                     <START_TIME>);

  2. 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-js 
    var chapterMetadata = {};
chapterMetadata["segmentType"] = "Sample segment type";

  3. Pour lancer le suivi de la lecture du chapitre, appelez l’événement ChapterStart dans l’instance MediaHeartbeat :

    code language-js 
    _onChapterStart = function() {
  tracker.trackEvent(ADB.Media.Event.ChapterStart, chapterObject, chapterMetadata);

};

  4. Lorsque la lecture atteint la limite de fin du chapitre, comme défini par votre code personnalisé, appelez l’événement ChapterComplete dans l’instance MediaHeartbeat :

    code language-js 
    _onChapterComplete = function() {
   tracker.trackEvent(ADB.Media.Event.ChapterComplete);
};

  5. 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-js 
    _onChapterSkip = function() {
    tracker.trackEvent(ADB.Media.Event.ChapterSkip);
};

  6. S’il existe d’autres chapitres, répétez les étapes 1 à 5.

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