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.
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 |
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 |
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 |
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é |