Clés de métadonnées Roku

Dernière mise à jour : 2023-01-03
  • Créé pour :
  • User
    Admin
    Developer

Les métadonnées audio, vidéo et de publicité standard peuvent être définies respectivement sur les objets info de multimédia et de publicité. À l’aide des clés constantes des métadonnées vidéo/de publicité, définissez le dictionnaire contenant les métadonnées standard sur l’objet info avant d’appeler les API de suivi. Consultez les tableaux ci-dessous pour obtenir la liste complète des constantes de métadonnées standard, suivies d’un exemple.

Constantes de métadonnées vidéo

Nom de métadonnées Clé de données contextuelles Nom de constante
Programme a.media.show MEDIA_VideoMetadataKeySHOW
Saison a.media.season MEDIA_VideoMetadataKeySEASON
Épisode a.media.episode MEDIA_VideoMetadataKeyEPISODE
Ressource a.media.asset MEDIA_VideoMetadataKeyASSET_ID
Genre a.media.genre MEDIA_VideoMetadataKeyGENRE
Date de première diffusion a.media.airDate MEDIA_VideoMetadataKeyFIRST_AIR_DATE
Date de première diffusion numérique a.media.digitalDate MEDIA_VideoMetadataKeyFIRST_DIGITAL_DATE
Évaluation a.media.rating MEDIA_VideoMetadataKeyRATING
Créateur a.media.originator MEDIA_VideoMetadataKeyORIGINATOR
Réseau a.media.network MEDIA_VideoMetadataKeyNETWORK
Type de programme a.media.type MEDIA_VideoMetadataKeySHOW_TYPE
Chargement de publicité a.media.adLoad MEDIA_VideoMetadataKeyAD_LOAD
MVPD a.media.pass.mvpd MEDIA_VideoMetadataKeyMVPD
Autorisé a.media.pass.auth MEDIA_VideoMetadataKeyAUTHORIZED
Partie de la journée a.media.dayPart MEDIA_VideoMetadataKeyDAY_PART
Flux a.media.feed MEDIA_VideoMetadataKeyFEED
Format de diffusion a.media.format MEDIA_VideoMetadataKeySTREAM_FORMAT

Constantes de métadonnées audio

Nom de métadonnées Clé de données contextuelles Nom de constante
Artiste a.media.artist MEDIA_AudioMetadataKeyARTIST
Album a.media.album MEDIA_AudioMetadataKeyALBUM
Étiquette a.media.label MEDIA_AudioMetadataKeyLABEL
Auteur a.media.author MEDIA_AudioMetadataKeyAUTHOR
Station a.media.station MEDIA_AudioMetadataKeySTATION
Éditeur a.media.publisher MEDIA_AudioMetadataKeyPUBLISHER

Constantes de métadonnées de publicité

Nom de métadonnées Clé de données contextuelles Nom de constante
Annonceur a.media.ad.advertiser MEDIA_AdMetadataKeyADVERTISER
ID de campagne a.media.ad.campaign MEDIA_AdMetadataKeyCAMPAIGN_ID
ID d’élément créatif a.media.ad.creative MEDIA_AdMetadataKeyCREATIVE_ID
Identifiant de référencement a.media.ad.placement MEDIA_AdMetadataKeyPLACEMENT_ID
ID du site a.media.ad.site MEDIA_AdMetadataKeyPLACEMENT_ID
URL de l’élément créatif a.media.ad.creativeURL MEDIA_AdMetadataKeyCREATIVE_URL

Constantes

Vous pouvez utiliser les constantes suivantes pour suivre les événements de média :

Autres constantes

Constante Description
ERROR_SOURCE_PLAYER Constante pour la source d’erreur résidant dans le lecteur

Constantes MediaObjectkey (utilisées comme clés dans les instances MediaObject)

Constante Description
MEDIA_STANDARD_MEDIA_METADATA Constante permettant de définir des métadonnées sur le MediaInfo trackLoad
MEDIA_STANDARD_AD_METADATA Constante permettant de définir les métadonnées publicitaires sur le EventData trackEvent
MEDIA_RESUMED Constante pour envoyer un heartbeat repris par vidéo. Pour reprendre le suivi vidéo du contenu précédemment arrêté, vous devez définir la propriété MEDIA_RESUMED sur l’objet mediaInfo lorsque vous appelez mediaTrackLoad. (MEDIA_RESUMED n’est pas un événement que vous pouvez suivre à l’aide de l’API mediaTrackEvent.) La propriété MEDIA_RESUMED doit être définie sur true lorsqu’une application souhaite continuer à suivre le contenu que l’utilisateur a arrêté de regarder mais qu’il désire continuer à regarder.

Par exemple, supposons qu’un utilisateur regarde 30 % du contenu, puis ferme l’application. La session est alors terminée. Par la suite, si le même utilisateur revient au même contenu et que l’application permet à l’utilisateur de reprendre à partir de l’endroit où il s’est arrêté, l’application doit définir MEDIA_RESUMED sur « true » lors de l’appel de l’API mediaTrackLoad. Il en résulte que ces deux sessions multimédia distinctes correspondant au même contenu vidéo peuvent être liées. Exemple :

mediaInfo =
  adb_media_init_mediainfo(
    "test_media_name",
    "test_media_id",
     10,
     "vod"
)
mediaInfo[ADBMobile().MEDIA_RESUMED] = true
mediaContextData = {}
ADBMobile().mediaTrackLoad(mediaInfo, mediaContextData)

Cette opération crée une nouvelle session pour la vidéo, mais elle provoque également l’envoi par le kit SDK d’une demande de pulsation avec le type d’événement « resume », qui peut être utilisé dans les rapports pour relier deux sessions multimédia différentes.

Constantes de type de contenu

Constante Description
MEDIA_STREAM_TYPE_LIVE Constante pour le type de diffusion LIVE
MEDIA_STREAM_TYPE_VOD Constante pour le type de diffusion VOD

Constantes de type d’événement (utilisées pour l’appel trackEvent)

Constante Description
MEDIA_BUFFER_START Type d’événement pour le début de la mémoire tampon
MEDIA_BUFFER_COMPLETE Type d’événement pour la fin de la mémoire tampon
MEDIA_SEEK_START Type d’événement pour le début de la recherche
MEDIA_SEEK_COMPLETE Type d’événement pour la fin de la recherche
MEDIA_BITRATE_CHANGE Type d’événement pour le changement de débit binaire
MEDIA_CHAPTER_START Type d’événement pour le début du chapitre
MEDIA_CHAPTER_COMPLETE Type d’événement pour la fin du chapitre
MEDIA_CHAPTER_SKIP Type d’événement pour le début de la publicité
MEDIA_AD_BREAK_START Type d’événement pour le début de la publicité
MEDIA_AD_BREAK_COMPLETE Type d’événement pour la fin de l’AdBreak
MEDIA_AD_BREAK_SKIP Type d’événement pour le saut de l’AdBreak
MEDIA_AD_START Type d’événement pour le début de la publicité
MEDIA_AD_COMPLETE Type d’événement pour la fin de la publicité
MEDIA_AD_SKIP Type d’événement pour le saut de la publicité

Sur cette page