Cette documentation aborde le suivi dans la version 2.x du SDK. Si vous mettez en œuvre une version 1.x du kit SDK, vous pouvez télécharger les Guides du développeur 1.x dans la rubrique Téléchargement des SDK.
Configuration initiale du suivi
Déterminez le moment où l’utilisateur déclenche l’intention de lecture (l’utilisateur clique sur le bouton de lecture et/ou la lecture automatique est activée) et créez une instance MediaObject
.
MediaObject
Référence :
Nom de variable | Description | Obligatoire |
---|---|---|
name |
Nom de la vidéo | Oui |
mediaid |
Identifiant unique de la vidéo | Oui |
length |
Durée de la vidéo | Oui |
streamType |
Type de diffusion (voir les constantes StreamType ci-dessous) | Oui |
mediaType |
Type de média (voir les constantes MediaType ci-dessous) | Oui |
StreamType
Constantes :
Nom de constante | Description |
---|---|
MEDIA_STREAM_TYPE_VOD |
Type de diffusion pour la vidéo à la demande. |
MEDIA_STREAM_TYPE_LIVE |
Type de diffusion pour le contenu en direct. |
MEDIA_STREAM_TYPE_LINEAR |
Type de diffusion pour le contenu linéaire. |
MEDIA_STREAM_TYPE_AOD |
Type de diffusion pour l’audio à la demande. |
MEDIA_STREAM_TYPE_AUDIOBOOK |
Type de diffusion pour les livres audio. |
MEDIA_STREAM_TYPE_PODCAST |
Type de diffusion pour les podcasts. |
MediaType
Constantes :
Nom de constante | Description |
---|---|
MEDIA_STREAM_TYPE_AUDIO |
Type de média pour les diffusions audio. |
MEDIA_STREAM_TYPE_VIDEO |
Type de média pour les diffusions vidéo. |
Créez un objet d’informations sur le média pour une vidéo avec du contenu VOD :
mediaInfo = adb_media_init_mediainfo(
"<MEDIA_NAME>",
"<MEDIA_ID>",
600,
ADBMobile().MEDIA_STREAM_TYPE_VOD,
ADBMobile().MEDIA_TYPE_VIDEO
)
ou
mediaInfo = adb_media_init_mediainfo()
mediaInfo.name = "<MEDIA_NAME>"
mediaInfo.id = "<MEDIA_ID>"
mediaInfo.length = 600
mediaInfo.streamType = ADBMobile().MEDIA_STREAM_TYPE_VOD
mediaInfo.mediaType = ADBMobile().MEDIA_TYPE_VIDEO
Créez un objet d’informations sur le média pour une vidéo avec du contenu AOD :
mediaInfo = adb_media_init_mediainfo(
"<MEDIA_NAME>",
"<MEDIA_ID>",
600,
ADBMobile().MEDIA_STREAM_TYPE_AOD,
ADBMobile().MEDIA_TYPE_AUDIO
)
ou
mediaInfo = adb_media_init_mediainfo()
mediaInfo.name = "<MEDIA_NAME>"
mediaInfo.id = "<MEDIA_ID>"
mediaInfo.length = 600
mediaInfo.streamType = ADBMobile().MEDIA_STREAM_TYPE_AOD
mediaInfo.mediaType = ADBMobile().MEDIA_TYPE_AUDIO
Ajout de métadonnées
Vous pouvez joindre des métadonnées standard et/ou de publicité à la session de suivi par le biais de variables de données contextuelles.
Métadonnées standard
Mise en œuvre de métadonnées standard sur JavaScript
Il est facultatif de joindre un objet de métadonnées standard à l’objet multimédia.
Référence à l’API des clés de métadonnées multimédia - Clés de métadonnées standard - JavaScript
Consultez la liste complète des métadonnées disponibles dans la rubrique Paramètres audio et vidéo.
Métadonnées personnalisées
Créez un objet de variable pour les variables personnalisées et renseignez les données de ce média. Par exemple :
/* Set custom context data */
var customVideoMetadata = {
isUserLoggedIn: "false",
tvStation: "Sample TV station",
programmer: "Sample programmer"
};
Suivi de l’intention de démarrer la lecture
Pour commencer le suivi d’une session multimédia, appelez trackSessionStart
sur l’instance Media Heartbeat :
mediaHeartbeat.trackSessionStart(mediaObject, customVideoMetadata);
La deuxième valeur est le nom d’objet de métadonnées multimédia personnalisé que vous avez créé à l’étape 2.
trackSessionStart
effectue le suivi de l’intention de lecture de l’utilisateur, et non du début de la lecture. Cette API est utilisée pour charger les données/métadonnées et estimer le temps jusqu’au démarrage de la mesure QoS (durée entre trackSessionStart
et trackPlay
).
Si vous n’utilisez pas de métadonnées personnalisées, envoyez simplement un objet vide pour l’argument data
dans trackSessionStart
, tel que décrit dans la ligne commentée de l’exemple iOS ci-dessus.
Suivi du début réel de la lecture
Identifiez l’événement du lecteur multimédia correspondant au début de la lecture, où la première image du média s’affiche à l’écran, et appelez trackPlay
:
mediaHeartbeat.trackPlay();
Suivi de la fin de la lecture
Identifiez l’événement du lecteur multimédia correspondant à la fin de la lecture, où l’utilisateur a visionné le contenu jusqu’à la fin, et appelez trackComplete
:
mediaHeartbeat.trackComplete();
Suivi de la fin de la session
Identifiez l’événement du lecteur multimédia correspondant au déchargement/à la fermeture de la lecture, où l’utilisateur ferme la vidéo et/ou le contenu média est terminé et déchargé, et appelez trackSessionEnd
:
mediaHeartbeat.trackSessionEnd();
Un trackSessionEnd
marque la fin d’une session de suivi. Si la session a été visionnée jusqu’à la fin, où l’utilisateur a visionné le contenu jusqu’à la fin, assurez-vous que trackComplete
est appelé avant trackSessionEnd
. Tout autre appel à l’API track*
est ignoré après trackSessionEnd
, sauf trackSessionStart
dans le cadre d’une nouvelle session de suivi. Méthode de suivi de lecture de média pour suivre le chargement du média et définir la session actuelle sur active :
‘ Create a media info object
mediaInfo = adb_media_init_mediainfo()
mediaInfo.id = <MEDIA_ID>
mediaInfo.playhead = "0"
mediaInfo.length = "600"
Ajout de métadonnées vidéo
Vous pouvez joindre des objets de métadonnées vidéo standard et/ou personnalisés à la session de suivi vidéo par le biais de variables de données contextuelles.
Métadonnées vidéo standard
Mise en œuvre de métadonnées standard sur Roku
Il est facultatif de joindre un objet de métadonnées vidéo standard à l’objet multimédia.
Métadonnées personnalisées
Créez un objet de variable pour les variables personnalisées et renseignez les données de cette vidéo. Par exemple :
mediaContextData = {}
mediaContextData["cmk1"] = "cmv1"
mediaContextData["cmk2"] = "cmv2"
Suivi de l’intention de démarrer la lecture
Pour commencer le suivi d’une session multimédia, appelez trackSessionStart
sur l’instance Media Heartbeat :
ADBMobile().mediaTrackSessionStart(mediaInfo,mediaContextData)
La deuxième valeur est le nom d’objet de métadonnées vidéo personnalisé que vous avez créé à l’étape 2.
trackSessionStart
effectue le suivi de l’intention de lecture de l’utilisateur, et non du début de la lecture. Cette API est utilisée pour charger les données/métadonnées de la vidéo et estimer le temps jusqu’au démarrage de la mesure QoS (durée entre trackSessionStart
et trackPlay
).
Si vous n’utilisez pas de métadonnées vidéo personnalisées, envoyez simplement un objet vide pour l’argument data
dans trackSessionStart
, tel que décrit dans la ligne commentée de l’exemple iOS ci-dessus.
Suivi du début réel de la lecture
Identifiez l’événement du lecteur vidéo correspondant au début de la lecture vidéo, où la première image de la vidéo s’affiche à l’écran, et appelez trackPlay
:
ADBMobile().mediaTrackPlay()
Suivi de la fin de la lecture
Identifiez l’événement du lecteur vidéo correspondant à la fin de la lecture vidéo, où l’utilisateur a visionné le contenu jusqu’à la fin, et appelez trackComplete
:
ADBMobile().mediaTrackComplete()
Suivi de la fin de la session
Identifiez l’événement du lecteur vidéo correspondant au déchargement/à la fermeture de la lecture vidéo, où l’utilisateur ferme la vidéo et/ou la vidéo est terminée et déchargée, et appelez trackSessionEnd
:
ADBMobile().mediaTrackSessionEnd()
trackSessionEnd
marque la fin d’une session de suivi vidéo. Si la session a été visionnée jusqu’à la fin, où l’utilisateur a visionné le contenu jusqu’à la fin, assurez-vous que trackComplete
est appelé avant trackSessionEnd
. Tout autre appel à l’API track*
est ignoré après trackSessionEnd
, sauf trackSessionStart
dans le cadre d’une nouvelle session de suivi vidéo.
Suivi de tous les scénarios de mise en pause possibles
Identifiez l’événement du lecteur vidéo correspondant à l’interruption de la vidéo et appelez trackPause
:
ADBMobile().mediaTrackPause()
Scénarios de mise en pause
Identifiez tous les scénarios dans lesquels le lecteur vidéo sera interrompu et assurez-vous que trackPause
est correctement appelé. Les scénarios suivants exigent tous que votre application appelle trackPause()
:
Identifiez l’événement du lecteur correspondant à la lecture vidéo et/ou à la reprise vidéo après une interruption et appelez trackPlay
:
ADBMobile().mediaTrackPlay()
Il peut s’agir de la même source d’événement utilisée à l’étape 4. Assurez-vous que chaque appel de l’API trackPause()
est suivi d’un appel de l’API trackPlay()
à la reprise de la lecture vidéo.