Chaves de metadados do Roku

Última atualização: 18 de julho de 2024
  • Tópicos:

Criado para:

  • Usuário
  • Administrador
  • Desenvolvedor

Os metadados padrão de vídeo, áudio e anúncios podem ser definidos em objetos de informação de mídia e anúncio respectivamente. Usando as chaves de constantes para metadados de vídeo/anúncio, defina o dicionário que contém os metadados padrão em um objeto de informação antes de chamar as APIs de rastreamento. Consulte as tabelas abaixo para obter a lista completa de constantes de metadados padrão, seguida de exemplos.

Constantes de metadados de vídeo

Nome dos metadadosChave de dados de contextoNome da constante
Programaa.media.showMEDIA_VideoMetadataKeySHOW
Temporadaa.media.seasonMEDIA_VideoMetadataKeySEASON
Episódioa.media.episodeMEDIA_VideoMetadataKeyEPISODE
Ativoa.media.assetMEDIA_VideoMetadataKeyASSET_ID
Gêneroa.media.genreMEDIA_VideoMetadataKeyGENRE
Data da primeira exibiçãoa.media.airDateMEDIA_VideoMetadataKeyFIRST_AIR_DATE
Data da primeira exibição digitala.media.digitalDateMEDIA_VideoMetadataKeyFIRST_DIGITAL_DATE
Classificaçãoa.media.ratingMEDIA_VideoMetadataKeyRATING
Originadora.media.originatorMEDIA_VideoMetadataKeyORIGINATOR
Redea.media.networkMEDIA_VideoMetadataKeyNETWORK
Mostrar tipoa.media.typeMEDIA_VideoMetadataKeySHOW_TYPE
Carregamento do anúncioa.media.adLoadMEDIA_VideoMetadataKeyAD_LOAD
MVPDa.media.pass.mvpdMEDIA_VideoMetadataKeyMVPD
Autorizadoa.media.pass.authMEDIA_VideoMetadataKeyAUTHORIZED
Faixa de horárioa.media.dayPartMEDIA_VideoMetadataKeyDAY_PART
Feeda.media.feedMEDIA_VideoMetadataKeyFEED
Formato de transmissãoa.media.formatMEDIA_VideoMetadataKeySTREAM_FORMAT

Constantes de metadados de áudio

Nome dos metadadosChave de dados de contextoNome da constante
Artistaa.media.artistMEDIA_AudioMetadataKeyARTIST
Álbuma.media.albumMEDIA_AudioMetadataKeyALBUM
Rótuloa.media.labelMEDIA_AudioMetadataKeyLABEL
Autora.media.authorMEDIA_AudioMetadataKeyAUTHOR
Estaçãoa.media.stationMEDIA_AudioMetadataKeySTATION
Editora.media.publisherMEDIA_AudioMetadataKeyPUBLISHER

Constantes de metadados de anúncio

Nome dos metadadosChave de dados de contextoNome da constante
Anunciantea.media.ad.advertiserMEDIA_AdMetadataKeyADVERTISER
ID da campanhaa.media.ad.campaignMEDIA_AdMetadataKeyCAMPAIGN_ID
ID de criaçãoa.media.ad.creativeMEDIA_AdMetadataKeyCREATIVE_ID
ID de posicionamentoa.media.ad.placementMEDIA_AdMetadataKeyPLACEMENT_ID
ID do sitea.media.ad.siteMEDIA_AdMetadataKeyPLACEMENT_ID
URL da artea.media.ad.creativeURLMEDIA_AdMetadataKeyCREATIVE_URL

Constantes

Você pode usar as seguintes constantes para rastrear eventos de mídia:

Outras constantes

ConstanteDescrição
ERROR_SOURCE_PLAYERConstante para a fonte do erro como Reprodutor

Constantes de MediaObjectkey (usadas como chaves nas instâncias MediaObject)

ConstanteDescrição
MEDIA_STANDARD_MEDIA_METADATAConstante para definir metadados no MediaInfo trackLoad
MEDIA_STANDARD_AD_METADATAConstante para definir os metadados de anúncios no EventData trackEvent
MEDIA_RESUMEDConstante para enviar um heartbeat de vídeo retomada. Para retomar o rastreamento de vídeo de um conteúdo anteriormente interrompido, você precisa definir a propriedade MEDIA_RESUMED no objeto mediaInfo quando chamar mediaTrackLoad. (MEDIA_RESUMED não é um evento que você pode rastrear usando a API mediaTrackEvent.) MEDIA_RESUMED deve ser definido como true quando um aplicativo deseja continuar a rastrear o conteúdo que um usuário parou de assistir, mas que agora pretende retomar.

Por exemplo, digamos que um usuário assista 30% do conteúdo e então feche o aplicativo. Isso levará à sessão que está sendo encerrada. Posteriormente, se o usuário retornar ao mesmo conteúdo e o aplicativo permitir que ele retome do ponto em que parou, o aplicativo deverá definir MEDIA_RESUMED como "true" enquanto chama a API mediaTrackLoad. O resultado é que essas duas sessões de mídia diferentes para o mesmo conteúdo de vídeo podem ser vinculadas. Este é um exemplo de implementação:

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

Isso criará uma nova sessão para o vídeo, mas também fará com que o SDK envie uma solicitação de heartbeat contendo o tipo de evento “retomar”, que pode ser usado nos relatórios para vincular duas sessões de mídia diferentes.