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