Show Menu
TOPICS×

Suivi de la lecture principale sur Roku

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 .
  1. 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
    Constantes 
    StreamType
     :
    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.
    Constantes 
    MediaType
     :
    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
  2. 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
      Il est facultatif de joindre un objet de métadonnées 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 ce média. Par exemple :
      /* Set custom context data */ var customVideoMetadata = { isUserLoggedIn: "false", tvStation: "Sample TV station", programmer: "Sample programmer" };
  3. 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.
  4. 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();
  5. 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();
  6. 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"
  7. 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
      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"
  8. 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.
  9. 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()
  10. 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()
  11. 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.
  12. 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()
     :
    • L’utilisateur appuie explicitement sur le bouton de pause dans l’application.
    • Le lecteur se place dans l’état de pause.
    • (
      Applications mobiles
      ) - L’utilisateur place l’application en arrière-plan, mais vous souhaitez que l’application maintienne la session ouverte.
    • (
      Applications mobiles
      ) - Tout type d’interruption système qui entraîne la mise en arrière-plan d’une application. Par exemple, l’utilisateur reçoit un appel ou une fenêtre contextuelle d’une autre application apparaît, mais vous souhaitez que l’application maintienne la session active afin que l’utilisateur ait l’opportunité de reprendre la vidéo à partir du point d’interruption.
  13. 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.