Documentation Analytics Guide de collection des médias en streaming

Aperçu overview

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 2.x.

IMPORTANT

Si vous mettez en œuvre une version 1.x du kit SDK, vous pouvez télécharger le Guide du développeur dans la rubrique Téléchargement des SDK.

Le suivi des chapitres et des segments est disponible pour les chapitres ou les segments médias personnalisés. Certaines utilisations courantes du suivi des chapitres consistent à définir des segments personnalisés basés sur le contenu média, tels que les manches au baseball, ou à définir des segments de contenu entre les coupures publicitaires. Le suivi des chapitres n’est pas requis pour les mises en œuvre de suivi multimédia principal.

Le suivi des chapitres comprend les démarrages de chapitre, les fins de chapitre, et les chapitres ignorés. Vous pouvez utiliser l’API du lecteur multimédia avec une logique de segmentation personnalisée pour identifier les événements de chapitre et renseigner les variables de chapitre obligatoires et facultatives.

Événements du lecteur

Au début du chapitre

Créez l’instance d’objet de chapitre du chapitre, chapterObject
Renseignez les métadonnées du chapitre, chapterCustomMetadata
L’appel trackEvent(MediaHeartbeat.Event.ChapterStart, chapterObject, chapterCustomMetadata);

À la fin du chapitre

L’appel trackEvent(MediaHeartbeat.Event.ChapterComplete);

Lorsque le chapitre est ignoré

L’appel trackEvent(MediaHeartbeat.Event.ChapterSkip);

Mise en œuvre du suivi des chapitres implement-chapter-tracking

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.

Voici la référence de suivi de chapitre ChapterObject :

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

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.
Pour lancer le suivi de la lecture du chapitre, appelez l’événement ChapterStart dans l’instance MediaHeartbeat.
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.
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.
S’il existe d’autres chapitres, répétez les étapes 1 à 5.

L’exemple de code suivant utilise le kit SDK JavaScript 2.x pour un lecteur multimédia HTML5. Utilisez ce code avec le code de lecture multimédia principal.

/* Call on chapter start */
if (e.type == "chapter start") {
    var chapterObject = MediaHeartbeat.createChapterObject("Inning 5",5,500,2500);
    /* Set custom context data*/
    var chapterCustomMetadata = {
        segmentType:"Baseball Innings",
        segmentName:"Inning 5",
        segmentInfo:"Game Six"
    }
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.ChapterStart,
                                   chapterObject,
                                   chapterCustomMetadata);
};

/* Call on chapter complete */
if (e.type == "chapter complete") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.ChapterComplete);
};

/* Call on chapter skip */
if (e.type == "chapter skip") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.ChapterSkip);
};

recommendation-more-help

c8eee520-cef5-4f8c-a38a-d4952cfae4eb