Tasti di metadati Roku

I metadati video, audio e degli annunci standard possono essere impostati rispettivamente sugli oggetti multimediali e sulle informazioni degli annunci. Utilizzando le chiavi costanti per i metadati video/ad, impostate il dizionario contenente i metadati standard sull’oggetto info prima di chiamare le API track. Per l’elenco completo delle costanti di metadati standard, consultate le tabelle di seguito, seguite da un esempio.

Costanti di metadati video

Nome metadati Chiave dati contestuali Nome costante
Mostra le informazioni a.media.show MEDIA_VideoMetadataKeySHOW
Stagione a.media.season MEDIA_VideoMetadataKeySEASON
Episodio a.media.episode MEDIA_VideoMetadataKeyEPISODE
Risorsa a.media.asset MEDIA_VideoMetadataKeyASSET_ID
Genere a.media.genre MEDIA_VideoMetadataKeyGENRE
Data primo Air a.media.airDate MEDIA_VideoMetadataKeyFIRST_AIR_DATE
Prima data aria digitale a.media.digitalDate MEDIA_VideoMetadataKeyFIRST_DIGITAL_DATE
Valutazione a.media.rating MEDIA_VideoMetadataKeyRATING
Creatore a.media.originator MEDIA_VideoMetadataKeyORIGINATOR
Rete a.media.network MEDIA_VideoMetadataKeyNETWORK
Mostra tipo a.media.type MEDIA_VideoMetadataKeySHOW_TYPE
Caricamento annuncio a.media.adLoad MEDIA_VideoMetadataKeyAD_LOAD
MVPD a.media.pass.mvpd MEDIA_VideoMetadataKeyMVPD
Autorizzato a.media.pass.auth MEDIA_VideoMetadataKeyAUTHORIZED
Parte giorno a.media.dayPart MEDIA_VideoMetadataKeyDAY_PART
Feed a.media.feed MEDIA_VideoMetadataKeyFEED
Formato flusso a.media.format MEDIA_VideoMetadataKeySTREAM_FORMAT

Costanti di metadati audio

Nome metadati Chiave dati contestuali Nome costante
Artista a.media.artist MEDIA_AudioMetadataKeyARTIST
Album a.media.album MEDIA_AudioMetadataKeyALBUM
Etichetta a.media.label MEDIA_AudioMetadataKeyLABEL
Autore a.media.author MEDIA_AudioMetadataKeyAUTHOR
Stazione a.media.station MEDIA_AudioMetadataKeySTATION
Editore a.media.publisher MEDIA_AudioMetadataKeyPUBLISHER

Aggiungi costanti di metadati

Nome metadati Chiave dati contestuali Nome costante
Inserzionista a.media.ad.advertiser MEDIA_AdMetadataKeyADVERTISER
ID campagna a.media.ad.campaign MEDIA_AdMetadataKeyCAMPAIGN_ID
Creative ID a.media.ad.creative MEDIA_AdMetadataKeyCREATIVE_ID
ID posizionamento a.media.ad.placement MEDIA_AdMetadataKeyPLACEMENT_ID
ID sito a.media.ad.site MEDIA_AdMetadataKeyPLACEMENT_ID
URL creativo a.media.ad.creativeURL MEDIA_AdMetadataKeyCREATIVE_URL

Costanti

Per tenere traccia degli eventi multimediali potete usare le seguenti costanti:

Altre costanti

Costante Descrizione
ERROR_SOURCE_PLAYER Costante per il lettore della fonte di errore

Costanti MediaObject (utilizzate come chiavi nelle istanze MediaObject)

Costante Descrizione
MEDIA_STANDARD_MEDIA_METADATA Costante per impostare i metadati sul MediaInfo trackLoad
MEDIA_STANDARD_AD_METADATA Costante per impostare i metadati dell’annuncio sul pannello EventData trackEvent
MEDIA_RESUMED Costante per l’invio di heartbeat ripreso video. Per riprendere il tracciamento video del contenuto precedentemente interrotto, è necessario impostare la MEDIA_RESUMED proprietà sull’ mediaInfo oggetto al momento della chiamata mediaTrackLoad. (MEDIA_RESUMED non è un evento che puoi monitorare utilizzando l’ mediaTrackEvent API). MEDIA_RESUMED deve essere impostato su true quando un’applicazione desidera continuare a monitorare il contenuto che un utente ha interrotto ma che intende riprendere la visualizzazione.

Ad esempio, se un utente guarda il 30% del contenuto, chiude l’app. In questo modo la sessione verrà terminata. In seguito, se lo stesso utente torna allo stesso contenuto e l’applicazione consente all’utente di riprendere dallo stesso punto in cui l’ha interrotto, l’applicazione deve impostare MEDIA_RESUMED “true” mentre chiama l’ mediaTrackLoad API. Il risultato è che queste due diverse sessioni multimediali per lo stesso contenuto video possono essere collegate tra loro. Esempio di implementazione:

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

questo modo verrà creata una nuova sessione per il video, ma l’SDK invierà anche una richiesta heartbeat con il tipo di evento “curriculum”, che può essere utilizzato nel reporting per collegare insieme due diverse sessioni multimediali.

Costanti del tipo di contenuto

Costante Descrizione
MEDIA_STREAM_TYPE_LIVE Costante per tipo di flusso LIVE
MEDIA_STREAM_TYPE_VOD Costante per il tipo di flusso VOD

Costanti del tipo di evento (utilizzate per la chiamata trackEvent)

Costante Descrizione
MEDIA_BUFFER_START Tipo evento per avvio buffer
MEDIA_BUFFER_COMPLETE Tipo evento per Buffer Complete
MEDIA_SEEK_START Tipo di evento per la ricerca
MEDIA_SEEK_COMPLETE Tipo evento per ricerca completa
MEDIA_BITRATE_CHANGE Tipo evento per modifica bitrate
MEDIA_CHAPTER_START Tipo evento per inizio capitolo
MEDIA_CHAPTER_COMPLETE Tipo evento per il capitolo completo
MEDIA_CHAPTER_SKIP Tipo evento per Ad Start
MEDIA_AD_BREAK_START Tipo evento per Ad Start
MEDIA_AD_BREAK_COMPLETE Tipo evento per AdBreak Complete
MEDIA_AD_BREAK_SKIP Tipo di evento per AdBreak Skip
MEDIA_AD_START Tipo evento per Ad Start
MEDIA_AD_COMPLETE Tipo evento per annuncio completo
MEDIA_AD_SKIP Tipo evento per Salto annuncio

In questa pagina