Pular para conteúdo

Configurações Avançadas para o Recurso Análise de Mídia

Neste guia, você aprenderá como personalizar como o seu conteúdo de mídia de vídeo e áudio é rastreado (por exemplo, como personalizar os títulos e URLs dos vídeos) e como especificar quais vídeos e áudios devem ser rastreados ou ignorados.

Definir títulos de vídeo e áudio

Ao analisar os seus relatórios de mídia no MVMCloud Analytics, os títulos de mídia costumam ser mais úteis do que os URLs HTTP de mídia (que podem conter apenas números e letras aleatórios). O player do YouTube e do Vimeo nos permite recuperar o título do vídeo automaticamente, para que os seus relatórios de vídeo mostrem diretamente os títulos de vídeo originais. Se você usa vídeos ou áudios HTML5 ou se deseja personalizar os títulos dos vídeos em seus relatórios analíticos, continue lendo. O recurso Análise de Mídia detectará o título da mídia pesquisando as seguintes informações:

  • Em primeiro lugar, o atributo HTML data-mvm-title;
  • Título de mídia do player do YouTube / Vimeo;
  • O Atributo HTML title;
  • Finalmente, o atributo HTML alt.

Os títulos são detectados nesta prioridade, o que significa que você pode definir um atributo data-mvm-title para substituir o título do vídeo do YouTube ou Vimeo. O atributo data-mvm-title sempre tem a prioridade mais alta e substitui qualquer título recebido de um reprodutor de mídia.

<video data-mvm-title="Meu título prioritário do vídeo" 
       title="Título original do vídeo"></video>

No exemplo acima, os seus relatórios de análise de vídeo no MVMCloud Analytics mostrarão "Meu título prioritário do vídeo" como o título da mídia. Se o título do vídeo não puder ser detectado (dependendo do seu reprodutor de mídia) e nenhum desses atributos HTML estiver definido, o título será mostrado como "Desconhecido".

JW Player

Se você deseja rastrear um título personalizado diferente do título do seu vídeo, pode fornecer um título personalizado que será usado apenas para fins de rastreamento especificando um item da lista de reprodução no método de configuração como este:

playerInstance.setup({
    playlist: [{
        file: "https://example.org/actualUrl.mp4",
        title: "Meu Vdeo",
        mvmTitle: "Meu título personalizado do vídeo"
    }]
});

Flowplayer

Se você deseja rastrear um título personalizado diferente do título do seu vídeo, pode fornecer um título personalizado que será usado apenas para fins de rastreamento especificando um item da lista de reprodução no método de configuração como este:

flowplayer("#player", {
    clip: {
        sources: [
            {type: "application/x-mpegurl", src: "https://example.org/actualUrl.m3u8"},
            {type: "video/mp4", src: "https://example.org/actualUrl.mp4" }
        ],
        title: "Título do vídeo",
        mvmTitle: "Meu título personalizado do vídeo"
    }
});

Se você incorporar o Flowplayer usando o elemento <video>, poderá definir o atributo data-mvm-title no elemento de vídeo diretamente.

Substituindo o URL do recurso de vídeo/áudio que está sendo rastreado

Por padrão, o URL HTTP de uma mídia é obtido da API do player ou lido no DOM. Pode haver casos de uso em que você queira rastrear um URL de recurso personalizado em vez do recurso real. Por exemplo, quando os seus URLs de mídia contêm IDs exclusivos e você prefere ter URLs mais legíveis ao analisar os relatórios do MVMCloud Analytics. Para fazer isso, você pode definir um recurso personalizado por meio do atributo HTML data-mvm-resource. Por exemplo:

<video src="https://example.org/Urlreal.mp4"
       data-mvm-resource="https://example.org/Urlrastreada.mp4"></video>

JW Player

Se o URL do seu recurso for, por exemplo, dependente do usuário e você sempre quiser rastrear o mesmo recurso, poderá fornecer um recurso personalizado especificando um item da lista de reprodução no método de configuração da seguinte forma:

playerInstance.setup({
    playlist: [{
        file: "https://example.org/actualUrl.mp4",
        title: "Meu Vídeo",
        mvmResource: "https://example.org/trackedUrl.mp4"
    }]
});

Flowplayer

Você pode fornecer um URL de recurso personalizado ao usar o flowplayer especificando a propriedade mvmResource:

flowplayer("#player", {
    clip: {
        sources: [
            {type: "application/x-mpegurl", src: "https://example.org/Urlreal.m3u8"},
            {type: "video/mp4", src: "https://example.org/actualUrl.mp4" }
        ],
        title: "Javascript setup",
        mvmResource: "https://example.org/Urlrastreada"
    }
});

Se você incorporar o flowplayer usando o elemento <video>, poderá definir o atributo data-mvm-resource no elemento <vídeo> diretamente.

Restringindo quais dados de mídia são rastreados

Excluir mídias específicas do rastreamento

Por padrão, todos os vídeos e áudios detectados serão rastreados. Para evitar o rastreamento de uma mídia específica enquanto ainda rastreia outra mídia, você pode definir um atributo data-mvm-ignore em um elemento <video> ou <audio>para ignorá-lo. Por exemplo:

<video data-mvm-ignore>...</video>
<audio data-mvm-ignore>...</audio>
<iframe data-mvm-ignore src="..."></iframe>

Ignorando todas as mídias que usam um determinado reprodutor de mídia

Para evitar rastrear qualquer mídia de um reprodutor de mídia específico, você pode desabilitar a análise para um ou mais reprodutores usando o método removePlayer:

_paq.push(['MvmMediaAnalytics::removePlayer', 'playerName']);

playerName deve ser um player de html5, vimeo ou youtube. Por exemplo, se você não deseja rastrear nenhum vídeo do Vimeo, pode remover esse player da seguinte maneira:

_paq.push(['MvmMediaAnalytics::disableMediaAnalytics']);

Para ativar o rastreamento novamente posteriormente, chame o método enableMediaAnalytics seguido por um scanForMedia:

_paq.push(['MvmMediaAnalytics::enableMediaAnalytics']);
_paq.push(['MvmMediaAnalytics::scanForMedia']);

É possível desativar o rastreamento de eventos de mídia, como reproduzir, pausar, retomar e concluir?

Sim, o rastreamento de eventos de mídia pode ser desabilitado chamando o seguinte método:

_paq.push(['MvmMediaAnalytics.disableTrackEvents']);

Isso interromperá o rastreamento de qualquer evento de ação, enquanto ainda rastreia o uso dos vídeos e do próprio áudio. Isso significa que você ainda receberá todos os relatórios de mídia listados na categoria de menu "Mídia", mas não verá nenhum evento de mídia no Registro de visitas ou no relatório "Ação => Eventos".

É recomendável chamar esse método o mais cedo possível, por exemplo, logo após _paq.push(['setSiteId', 'X']);

É possível desabilitar o rastreamento de dados de mídia, como com que frequência ou por quanto tempo uma mídia foi reproduzida, enquanto ainda rastreia eventos como 'reproduzir' e 'pausar'?

Sim, o rastreamento de mídia pode ser desativado chamando o seguinte método:

_paq.push(['MvmMediaAnalytics.disableTrackProgress']);

Isso interromperá o rastreamento do progresso da mídia. Na categoria de menu "Mídia", a maioria dos relatórios não mostra nenhum dado. O Log de visitas e o relatório "Ações => Eventos" ainda mostrarão dados, a menos que você desabilite o rastreamento de eventos também.

É recomendável chamar esse método o mais cedo possível, por exemplo, logo após _paq.push(['setSiteId', 'X']);