Show Menu
TÓPICOS×

Visão geral do marco

Esta opção de medição foi descontinuada.

Configuração

Configuração de marco do vídeo

Para rastrear vídeos, atribua um conjunto de Variáveis de conversão personalizadas (eVars) e Eventos personalizados que serão utilizados no rastreamento e nos relatórios. Uma variável de Insight personalizado () também é usada para a definição de caminho. s.prop
As variáveis selecionadas para cada métrica são adicionadas à página de configuração do vídeo. Isso permite que o sistema gere e formate automaticamente os relatórios de vídeo padrão. A eVar de nome do vídeo e o contador de visualizações do vídeo são necessários. Outras variáveis são opcionais, mas são recomendadas para a medição completa. Depois que o rastreamento de vídeo estiver ativado, será possível visualizar os relatórios gerados a partir dos dados de vídeo que você reportou usando o rastreamento de vídeo.
Você também pode rastrear qualquer número de métricas adicionais para vídeos. Por exemplo, se você usar vários players de vídeo no site, será possível preencher uma eVar com o nome do player. Algumas das variáveis selecionadas também podem ser usadas em outras áreas do site. Por exemplo, se usada em todo o site, a variável tipo de conteúdo pode permitir a medição da porcentagem de suas visualizações de página que vêm do vídeo e permite relacionar eventos de conversão ao vídeo.

Configuração de relatórios de marco

Para configurar relatórios de vídeo para uma implementação do marco, acesse Administrador > Gerenciador do conjunto de relatórios. Selecione o conjunto de relatórios e escolha Gerenciamento de vídeo > Relatórios de vídeo:
Na primeira tela, somente o Vídeo principal funcionará com os dados do Marco. Selecione Vídeo principal e clique em Salvar.
Na próxima tela, selecione Usar variáveis personalizadas.
Na tela final, selecione os dois eVars e os três eventos a serem usados com a sua medição de vídeo:

Referência da variável de vídeo

A tabela a seguir contém mais detalhes sobre as variáveis de comércio e os eventos personalizados de vídeo:
Métrica de vídeo
Tipo de variável
Descrição
Conteúdo
Expiração
padrão do eVar: Visita
(Obrigatório) Coleta o nome do vídeo, conforme especificado na implementação.
Tipo de conteúdo
Expiração
padrão do eVar: Visualização de página
Coleta dados sobre o tipo de conteúdo exibido por um visitante. Ocorrências enviadas por avaliação de vídeo recebem um tipo de conteúdo de video.
Essa variável não precisa ser reservada exclusivamente para rastreamento de vídeo. Quando outros conteúdos relatam os tipos de conteúdo por meio da mesma variável, é possível analisar a distribuição de visitantes nesses tipos diferentes. Por exemplo, seria possível marcar outros tipos de conteúdo por meio de valores como article ou product page com essa variável.
Da perspectiva de avaliação do vídeo, o Tipo de conteúdo permite que você identifique visitantes de vídeo e, portanto, calcule as taxas de conversão do vídeo.
Tempo gasto no conteúdo
Tipo
de evento: Contador
Contabiliza o tempo, em segundos, que é gasto com a exibição de um vídeo desde o último processo de coleta de dados (solicitação da imagem).
Inicialização de vídeo
Tipo
de evento: Contador
Indica que um visitante visualizou uma parte de um de vídeo. No entanto, não fornece informações sobre quanto ou qual parte de um vídeo o visitante visualizou.
Término de vídeo
Tipo
de evento: Contador
Indica se o usuário exibiu um vídeo completo. Por padrão, o evento completo é avaliado um segundo antes do fim do vídeo.
Durante a implementação, é possível especificar quantos segundos a partir do fim do vídeo são necessários para considerar a visualização como concluída. Para vídeos ao vivo e outras transmissões que não têm um fim definido, você pode especificar um ponto personalizado para medir as conclusões. Por exemplo, depois de um tempo de exibição específico.

Variáveis do módulo de mídia

As variáveis a seguir permitem configurar a medição do vídeo. Você deve definir valores para as variáveis na tabela Variáveis obrigatórias. Além disso, para rastrear eventos no player de vídeo, é necessário ativar o autoTrack (para players compatíveis) ou implementar o rastreamento personalizado de eventos do player usando os métodos open, play, stop e close.
Variável   
Descrição
Media.trackUsingContextData
Sintaxe:
s.Media.trackUsingContextData = true;
Essa opção habilita o monitoramento integrado de vídeos. Quando definido como Verdadeiro, o módulo de mídia gera dados de contexto para o rastreamento de mídia, em vez do herdado pev3 .
Use Media.contextDataMapping para mapear os dados de contexto de acordo com as eVars e os Eventos selecionados.
Valor padrão: false
Media.contextDataMapping
Sintaxe:
s.Media.contextDataMapping = {
     "a.media.name":"eVar2, prop2",
     "a.media.segment":"eVar3",
     "a.contentType":"eVar1",
     "a.media.timePlayed":"event3",
     "a.media.view":"event1",
     "a.media.segmentView":"event2",
     "a.media.complete":"event7",
     "a.media.milestones":{
         25:"event4",
         50:"event5",
         75:"event6"
     }
};
Um objeto que define o mapeamento de variáveis para eVars e Eventos que você deseja usar na avaliação do vídeo. O objeto deve mapear os seguintes campos:
a.media.name: (obrigatório) preenche variáveis com o nome do vídeo. Forneça a eVar selecionada para armazenar o nome do vídeo e a variável Custom Insight Video ( s.prop ) que deseja utilizar para o caminho do vídeo. Os valores serão exibidos em uma lista separada por vírgulas.
a.media.segment: (opcional) a eVar na qual você deseja armazenar o nome do segmento de mídia. a.contentType: (opcional) a eVar na qual você deseja armazenar o valor do vídeo, que inclui os recursos de monitoramento de visitas e visitantes habilitados com o objetivo de gerar relatórios de visitas e visitantes do vídeo. A variável selecionada provavelmente já é usada para armazenar dados, como apresentações de slides ou uma página de produto
a.media.view: (obrigatório) o Evento no qual você deseja contabilizar as exibições de mídia.
a.media.segmentView: (opcional) o Evento no qual você deseja contabilizar exibições de segmentos.
a.media.complete: (opcional) o Evento no qual você deseja contabilizar as exibições concluídas.
a.media.timePlayed: (opcional, altamente recomendado) o Evento numérico no qual você deseja armazenar a quantidade de segundos reproduzidos dos vídeos.
a.media.milestones: (opcional) um objeto que mapeia marcos de s.Media.trackMilestones para contabilizar Eventos. Media.segmentByMilestones deve estar definido como verdadeiro (true) se você definir marcos.
Rastreamento de anúncios As variáveis de dados de contexto listadas abaixo estão disponíveis para o rastreamento de anúncios:
a.media.ad.name: (obrigatório) preenche variáveis com o nome do anúncio. Forneça a eVar selecionada para armazenar o nome do anúncio, e a variável Custom Insight Video ( s.prop ) que deseja utilizar para o caminho. Os valores serão exibidos em uma lista separada por vírgulas.
a.media.ad.pod: a posição no conteúdo principal em que o anúncio foi reproduzido.
a.media.ad.podPosition: a posição no pod para a reprodução do anúncio.
a.media.ad.CPM: o CPM ou CPM criptografado (com prefixo “~”) que se aplica a essa reprodução.
a.media.ad.view: funciona como a.media.view
a.media.ad.clicked: contabiliza a quantidade de cliques do anúncio (chamadas de Media.click )
a.media.ad.timePlayed: funciona como a.media.timePlayed
a.media.ad.complete: funciona como a.media.complete a.media.ad.segment: funciona como a.media.segment
a.media.ad.segmentView: funciona como a.media.segmentView
a.media.ad.milestones: funciona como a.media.milestones
a.media.ad.offsetMilestones: funciona como a.media.offsetMilestones
Media.trackVars
Sintaxe:
s.Media.trackVars =
   "events, prop2, eVar1, eVar2, eVar3";
Uma lista separada por vírgulas com todas as variáveis definidas no código de rastreamento do vídeo.
Media.trackEvents
Sintaxe:
s.Media.trackEvents =
   "event1, event2, event3, event4, event5, event6, event7"
Uma lista separada por vírgulas com todos os eventos definidos no código de rastreamento do vídeo.

Variáveis opcionais

 Variável   
Descrição
Media.autoTrack
Sintaxe:
s.Media.autoTrack = true
Habilita o rastreamento automático para os reprodutores suportados. Reprodutores suportados:
  • Open Source Media Framework (OSMF)
  • FLVPlayback (Players de vídeo criados pelo assistente de importação de vídeo no Flash Professional)
  • Silverlight
  • MediaDisplay
  • MediaPlayback
  • API Brightcove versões 2 e 3 (consulte Brightcove )
  • Windows Media Player, Quicktime ou Real Player com JavaScript
Se você não estiver utilizando um dos reprodutores acima, é possível usar Media.open Media.play Media.stop Media.close para rastrear os eventos do reprodutor.
Media.autoTrackNetStreams
Sintaxe:
s.Media.autoTrackNetStreams = true
O Flash 10.3 apresentou uma nova funcionalidade ao componente NetStream, que permite o rastreamento aprimorado de vídeos. Se você estiver usando um player Flash NetStream personalizado, é possível habilitar essa variável para ativar uma funcionalidade semelhante ao autoTrack. Este método requer que os vídeos sejam visualizados no Flash 10.3 ou posterior.
Media.completeByCloseOffset
Sintaxe:
s.Media.completeByCloseOffset = true
Essa configuração permite que você contabilize um vídeo que foi concluído alguns segundos antes do fim do vídeo.
O evento é enviado com base na quantidade de segundos especificada em completeCloseOffsetThreshold . Permite que você faça a avaliação das conclusões em players de vídeo que nunca relatam um deslocamento igual ao tamanho do vídeo.
Por padrão, esse valor está definido como verdadeiro e o limite está definido como 1 segundo. Com esses padrões, o evento de conclusão é enviado 1 segundo antes do fim do vídeo.
Media.completeCloseOffsetThreshold
Sintaxe:
s.Media.completeCloseOffsetThreshold = 1
Esse limite permite que você contabilize uma visualização de vídeo concluída alguns segundos antes do fim do vídeo. Media.completeByCloseOffset deve estar definido como verdadeiro para a utilização desse limite.
O valor inteiro que foi fornecido determina o deslocamento em segundos da duração do vídeo no momento do seu encerramento e ainda é considerado como concluído. Permite que você faça a avaliação das conclusões em players de vídeo que nunca relatam um deslocamento igual ao tamanho do vídeo.
O limite padrão é de 1 segundo.
Media.playerName
Sintaxe:
s.Media.playerName = "Custom Player Name"
Especifica um nome de player de vídeo personalizado.
Media.trackSeconds
Sintaxe:
s.Media.trackSeconds = 15
Define o intervalo, em segundos, para enviar dados de rastreamento de vídeo aos servidores de coleta de dados da Adobe durante a reprodução do vídeo. O valor deve ser definido em incrementos de 5 segundos.
Habilitar Media.trackSeconds aciona apenas os eventos definidos em Media.contextDataMapping . Para enviar variáveis além daquelas especificadas para a avaliação do vídeo, você deve usar o Media.Monitor.
Media.trackMilestones
Monitora marcos como o percentual da duração do vídeo.
Sintaxe:
s.Media.trackMilestones = "25, 50, 75";
Define o intervalo como um percentual da duração do vídeo, para enviar dados de rastreamento de vídeo aos servidores de coleta de dados da Adobe. Especifique os marcos como uma lista de números inteiros separada por vírgulas. Por exemplo: 10 = 10%, 23 = 23%.
Como esses marcos são pontos fixos no vídeo, se um visitante ultrapassar o marco de 10%, retornar e passar pelo marco de 10% novamente, o módulo de mídia enviará os dados de monitoramento diversas vezes. Da mesma maneira, se o visitante ultrapassar um marco, o módulo de mídia não enviará os dados de monitoramento para o marco.
Habilitar Media.trackMilestones aciona apenas os eventos definidos em Media.contextDataMapping . Para enviar variáveis além daquelas especificadas para a avaliação do vídeo, você deve usar o Media.Monitor.
Media.trackOffsetMilestones
Rastreia marcos como segundos passados desde o início do vídeo.
Sintaxe:
s.Media.trackOffsetMilestones = "20, 40, 60";
Define o intervalo, como segundos decorridos desde o início do anúncio, para o envio dos dados de monitoramento de vídeo para os servidores de coleta de dados da Adobe. Especifique os marcos como uma lista de números inteiros separada por vírgulas. Por exemplo: 20 = 20 segundos, 40 = 40 segundos).
Como esses marcos são pontos fixos no vídeo, se um visitante ultrapassar o marco de 20 segundos, retornar e passar pelo marco de 20 segundos novamente, o módulo de mídia enviará os dados de monitoramento diversas vezes. Da mesma maneira, se o visitante ultrapassar um marco, o módulo de mídia não enviará os dados de monitoramento para o marco.
Habilitar Media.trackOffsetMilestones aciona apenas os eventos definidos em Media.contextDataMapping . Para enviar variáveis além daquelas especificadas para a avaliação do vídeo, você deve usar o Media.Monitor.
Media.segmentByMilestones
Sintaxe:
s.Media.segmentByMilestones = true;
Gera automaticamente o nome do segmento, o número e os dados de duração do segmento, com base na duração da mídia e nos marcos especificados em Media.trackMilestones
A segmentação por marcos é a única maneira de definir segmentos ao usar autoTrack .
Valor padrão: false
Media.segmentByOffsetMilestones
Sintaxe:
s.Media.segmentByOffsetMilestones = true;
Gera automaticamente o nome do segmento, o número e os dados de duração do segmento, com base na duração da mídia e nos marcos especificados em Media.trackOffsetMilestones
A segmentação por marcos é a única maneira de definir segmentos ao usar autoTrack .
Valor padrão: false

Variáveis de rastreamento de anúncios

Essas variáveis são utilizadas para enviar informações de publicidade com o método openAd. Consulte Rastreamento do anúncio de vídeo VAST.
Variável   
Descrição
Media.adTrackSeconds
Sintaxe:
s.Media.adTrackSeconds = 15;
Define o intervalo, em segundos, para enviar dados de rastreamento de vídeos publicitários aos servidores de coleta de dados da Adobe durante a reprodução do vídeo. O valor deve ser definido em incrementos de 5 segundos.
Habilitar Media.adTrackSeconds aciona apenas os eventos definidos em Media.contextDataMapping . Para enviar variáveis adicionais além daquelas especificadas para a avaliação do vídeo, você deve usar o Media.monitor .
Media.adTrackMilestones
Rastreia marcos de publicidade como o percentual da sua duração.
Sintaxe:
s.Media.adTrackMilestones = "25, 50, 75";
Define o intervalo como um percentual da duração do anúncio, para enviar dados de rastreamento de vídeo publicitário aos servidores de coleta de dados da Adobe. Especifique os marcos como uma lista de números inteiros separada por vírgulas. Por exemplo: 10 = 10%, 23 = 23%).
Como esses marcos são pontos fixos no anúncio, se um visitante ultrapassar o marco de 10%, retornar e passar pelo marco de 10% novamente, o módulo de mídia enviará os dados de monitoramento diversas vezes. Da mesma maneira, se o visitante ultrapassar um marco, o módulo de mídia não enviará os dados de monitoramento para o marco.
Habilitar Media.adTrackMilestones aciona apenas os eventos definidos em Media.contextDataMapping . Para enviar variáveis adicionais além daquelas especificadas para a avaliação do vídeo, você deve usar o Media.monitor .
Media.adTrackOffsetMilestones
Rastreia marcos de publicidade como segundos passados desde o início do anúncio.
Sintaxe:
s.Media.adTrackOffsetMilestones = "20, 40, 60";
Define o intervalo como segundos decorridos desde o início do anúncio, para enviar os dados de rastreamento do anúncio aos servidores de coleta de dados da Adobe. Especifique os marcos como uma lista de números inteiros separada por vírgulas. Por exemplo: 20 = 20 segundos, 40 = 40 segundos).
Como esses marcos são pontos fixos no anúncio, se um visitante ultrapassar o marco de 20 segundos, retornar e passar pelo marco de 20 segundos novamente, o módulo de mídia enviará os dados de monitoramento diversas vezes. Da mesma maneira, se o visitante ultrapassar um marco, o módulo de mídia não enviará os dados de monitoramento para o marco.
Habilitar Media.adTrackOffsetMilestones aciona apenas os eventos definidos em Media.contextDataMapping . Para enviar variáveis adicionais além daquelas especificadas para a avaliação do vídeo, você deve usar o Media.monitor .
Media.adSegmentByMilestones
Sintaxe:
s.Media.adSegmentByMilestones = true;
Gera automaticamente o nome do segmento, o número e os dados de duração do segmento, com base na duração da mídia e nos marcos especificados em Media.adTrackMilestones
A segmentação por marcos é a única maneira de definir segmentos ao usar autoTrack .
Valor padrão: false
Media.adSegmentByOffsetMilestones
Sintaxe:
s.Media.adSegmentByOffsetMilestones = true;
Gera automaticamente o nome do segmento, o número e os dados de duração do segmento, com base na duração da mídia e nos marcos especificados em Media.adTrackOffsetMilestones
A segmentação por marcos é a única maneira de definir segmentos ao usar autoTrack .
Valor padrão: false

Métodos do módulo de mídia

Os métodos do módulo de mídia são utilizados para rastrear de forma manual os eventos, bem como para rastrear métricas adicionais que não fazem parte dos relatórios de vídeo padrão.
Se você estiver utilizando Media.autoTrack e não for rastrear métricas adicionais, não é necessário chamar todos esses métodos diretamente. Todos os argumentos são necessários, exceto quando especificado como opcional.
Método   
Descrição
Media.open
Sintaxe:
s.Media.open(mediaName, mediaLength, mediaPlayerName)
Prepara o módulo de mídia para coletar dados de rastreamento do vídeo. Este método usa os seguintes parâmetros:
  • mediaName: (obrigatório) o nome do vídeo conforme você quer que ele seja exibido nos relatórios de vídeo.
  • mediaLength: (obrigatório) a duração do vídeo, em segundos.
  • mediaPlayerName: (obrigatório) o nome do reprodutor de mídia utilizado para exibir o vídeo, conforme você quer que ele seja exibido nos relatórios de vídeo.
Media.openAd
Sintaxe:
s.Media.openAd(name, length, playerName, parentName,
   parentPod, parentPodPosition, CPM)
Prepara o módulo de mídia para coletar dados de rastreamento dos anúncios. Este método usa os seguintes parâmetros:
  • name: (obrigatório) o nome ou a ID do anúncio.
  • length: (obrigatório) a duração do anúncio.
  • playerName: (obrigatório) o nome do reprodutor de mídia utilizado para exibir o anúncio.
  • parentName: o nome ou a ID do conteúdo principal no qual o anúncio está incorporado.
  • parentPod: a posição, no conteúdo principal, de reprodução do anúncio.
  • parentPodPosition: a posição, no pod, de reprodução do anúncio.
  • CPM: o CPM ou o CPM criptografado (com prefixo "~") que se aplica a essa reprodução.
Media.click
Sintaxe:
s.Media.click(name, offset)
Rastreie situações nas quais um anúncio é clicado em um vídeo. Este método usa os seguintes parâmetros:
  • name: o nome do anúncio Deve corresponder ao nome usado em Media.openAd.
  • offset: o deslocamento no anúncio quando o clique ocorreu.
Media.close
Sintaxe:
s.Media.close(mediaName)
Encerra a coleta de dados do vídeo e envia informações para os servidores de coleta de dados da Adobe. Chame o método ao fim do vídeo. Esse método utiliza o seguinte parâmetro:
mediaName: o nome do vídeo. Deve corresponder ao nome utilizado em Media.open .
Media.complete
Sintaxe:
s.Media.complete(name, offset)
Este método rastreia manualmente um método de evento concluído. Ele é utilizado quando é necessário acionar eventos com uma lógica especial, que não pode ser manuseada com Media.completeByCloseOffset .
Por exemplo, se você estiver medindo um stream ao vivo que não tem hora para acabar, é possível acionar uma conclusão depois que o usuário exibir um stream ao vivo por X segundos. Você pode medir uma conclusão usando um cálculo de porcentagem com base no tamanho e tipo de conteúdo. Este método usa os seguintes parâmetros:
  • mediaName: o nome do vídeo. Deve corresponder ao nome utilizado em Media.open.
  • mediaOffset: o número de segundos no vídeo quando o evento completo deve ser enviado. Especifique o deslocamento com base no vídeo, iniciando no ponto zero.
    Se o player de mídia rastrear utilizando milissegundos, verifique se o valor é convertido em segundos antes de chamar Media.complete.
Se planeja chamar a conclusão manual, defina
s.Media.completeByCloseOffset = false .
Media.play
Sintaxe:
s.Media.play(name, offset, segmentNum, segment, segmentLength)
Chame esse método sempre que um vídeo começar a ser reproduzido. Ao utilizar a avaliação manual do vídeo, você pode fornecer os dados de segmento atuais no envio de dados.
Se o reprodutor mudar de um segmento para outro, por qualquer motivo, você deve chamar Media.stop Media.play .
Este método usa os seguintes parâmetros:
mediaName: o nome do vídeo. Deve corresponder ao nome utilizado em Media.open.
mediaOffset: o número de segundos após o início da reprodução. Especifique o deslocamento com base no vídeo, iniciando no ponto zero. Se o player de mídia rastrear utilizando milissegundos, verifique se o valor é convertido em segundos antes de chamar Media.play.
segmentNum: (opcional) o número do segmento atual, utilizado pelos relatórios de marketing para ordenar a exibição dos segmentos nos relatórios. O parâmetro segmentNum deve ser superior a zero.
segment: (opcional) o nome atual do segmento.
segmentLength: (opcional)
A duração do segmento atual, em segundos.
Por exemplo:
s.Media.play("My Video", 1800, 2,"Second Quarter", 1800)
s.Media.play("My Video", 0, 1,"Preroll", 30)
Media.stop
Sintaxe:
s.Media.stop(mediaName, mediaOffset)
Rastreia um evento de parada (parada, pausa etc.) para o vídeo especificado. Este método usa os seguintes parâmetros:
  • mediaName: o nome do vídeo. Deve corresponder ao nome utilizado em Media.open .
  • mediaOffset: o número de segundos no vídeo em que o evento de parada ou pausa ocorre. Especifique o deslocamento com base no vídeo, iniciando no ponto zero.
Media.monitor
Sintaxe:
s.Media.monitor(s, media)
Sintaxe do Silverlight:
s.Media.monitor =
   new AppMeasurement_Media_Monitor(myMediaMonitor);
O monitor do aplicativo Silverlight implementa o padrão de design delegado Objective-C. O método de classe myMediaMonitor utiliza os parâmetros s e media .
Utilize esse método para enviar métricas adicionais de vídeo. Você pode configurar outras variáveis (Props, eVars, Eventos) e enviá-las utilizando o Media.track e levando em conta o estado atual do vídeo durante a sua reprodução.
Este método usa os seguintes parâmetros:
s: A instância AppMeasurement (ou objeto s do JavaScript).
media: um objeto com membros, responsável por fornecer o estado do vídeo. Esses membros incluem:
  • media.name: O nome do vídeo. Deve corresponder ao nome utilizado em Media.open ;
  • media.length: a duração do vídeo em segundos, fornecida na chamada para Media.open ;
  • media.playerName: o nome do reprodutor de mídia fornecido na chamada para Media.open ;
  • media.openTime:``Media.open um objeto NSDate contendo dados sobre quando foi chamado;
  • media.offset: o deslocamento atual, em segundos, (ponto no vídeo) do vídeo. O deslocamento começa em zero (o primeiro segundo do vídeo é 0);
  • media.percent: o percentual atual do vídeo reproduzido, com base na duração do vídeo e do deslocamento atual.;
  • media.timePlayed: o número total de segundos reproduzidos até o momento;
  • media.eventFirstTime: indica se foi a primeira vez que o evento de mídia foi chamado para o vídeo;
  • media.mediaEvent: uma string contendo o nome do evento que provocou a chamada do monitor.
media.mediaEvent events:
  • OPEN: quando a reprodução ocorre por Media.autoTrack ou com uma chamada para Media.play ;
  • CLOSE: quando a reprodução termina ao concluir o vídeo por Media.autoTrack ou ao chamar Media.close ;
  • PLAY: quando a reprodução continua após uma pausa ou ao depurar Media.autoTrack , ou efetuar uma segunda chamada para Media.play ;
  • STOP:``Media.autoTrack quando a reprodução é interrompida devido a uma pausa no início da depuração por ou uma chamada para Media.stop ;
  • MONITOR: quando a monitoração automática verifica o estado do vídeo durante a reprodução (a cada segundo);
  • SECONDS: No segundo intervalo definido pela variável Media.trackSeconds ;
  • MILESTONE: Nos marcos definidos pela variável Media.trackMilestones ;
Media.track
Sintaxe:
s.Media.track(mediaName)
Envia imediatamente o estado atual do vídeo, juntamente com qualquer Media.trackVars e Media.trackEvents que já tenha sido definido. Esse método é utilizado em Media.monitor .
Chame Media.open e Media.play no vídeo antes de chamar esse método. Esse método utiliza o seguinte parâmetro:
  • mediaName : o nome do vídeo. Deve corresponder ao nome utilizado em Media.open .
Esse método é a única maneira de enviar variáveis adicionais enquanto o vídeo está sendo reproduzido. Ele redefine o intervalo de segundos e os contadores de marco percentual para zero, a fim de evitar várias ocorrências de rastreamento.

Monitoramento de eventos do reprodutor de vídeo

Você pode criar funções anexadas aos manipuladores do evento do reprodutor de vídeo para monitorar os reprodutores de mídia. Isso permite que você chame Media.open , Media.play , Media.stop e Media.close nos momentos apropriados. Por exemplo:
  • Carregar: Chame Media.open e Media.play
  • Pausar: Chame Media.stop . Por exemplo, se um usuário pausar um vídeo depois de 15 segundos, chama s.Media.stop("Video1", 15)
  • Buffer: chama a instância Media.stop durante o buffering do vídeo. Chama Media.play quando a reprodução é retomada.
  • Retomar: Chame Media.play . Por exemplo, quando um usuário retoma um vídeo após 15 segundos, chama s.Media.play("Video1", 15) .
  • Scrub (controle deslizante): quando o usuário arrasta o controle deslizante do vídeo, chamada de Media.stop . Quando um usuário solta a barra deslizante do vídeo, chama Media.play .
  • Finalizar: Chame Media.stop , depois Media.close . Por exemplo, ao fim de um vídeo de 100 segundos, chama s.Media.stop("Video1", 100) , em seguida s.Media.close("Video1") .
Para chegar a este resultado é possível definir quatro funções personalizadas que você pode chamar pelos manipuladores de evento do reprodutor de mídia. Os diferentes parâmetros passados para Media.open , Media.play , Media.stop e Media.close são originados pelo reprodutor. Os pseudo códigos demonstram como isto deve ser feito:
/* Call on video load */ 
function startMovie() { 
    s.Media.open(mediaName, mediaLength, mediaPlayerName); 
    playMovie(); 
} 
 
/* Call on video resume from pause and slider release */ 
function playMovie() { 
    s.Media.play(mediaName, 
                 mediaOffset,  
                 segmentNum,  
                 segment,  
                 segmentLength); 
} 
/* Call on video pause and slider grab */ 
function stopMovie() { 
    s.Media.stop(mediaName, mediaOffset); 
} 
 
/* Call on video end */ 
/* Measuring Video for Developers 43 */ 
function endMovie() { 
    stopMovie(); 
    s.Media.close(mediaName); 
} 

JavaScript autotrack

O módulo de mídia do JavaScript identifica todas as tags <embed> ou <object> no HTML da página. Em seguida, ele pesquisa os dados em cada tag para determinar o reprodutor de mídia, caso ele esteja em uso. Se o reprodutor for o Windows Media Player, o Quicktime ou o Real Player, a função autoTrack poderá ser usada, embora o autoTrack para o Windows Media Player funcione somente no Internet Explorer. O rastreamento manual para o Windows Media Player é necessário para oferecer suporte a todos os outros navegadores.
É necessário ter o atributo classid definido no objeto que você deseja rastrear. O classid é necessário para expor os manipuladores de evento utilizados pelo Módulo de mídia no monitoramento automático de vídeos.
s.Media.autoTrack = true

Código de amostra do JavaScript

// Sample implementation 
s.usePlugins=true 
function s_doPlugins(s) { 
    /* Add manual calls to modules and plugins here */ 
} 
 
s.doPlugins=s_doPlugins 
 
/*********Media Module Calls**************/ 
s.loadModule("Media") 
 
/*Configure Media Module Functions */ 
s.Media.autoTrack= true; 
s.Media.trackVars="events, prop2, eVar1, eVar2, eVar3"; 
s.Media.trackEvents="event1, event2, event3, event4, event5, event6, event7" 
s.Media.trackMilestones="25, 50, 75"; 
s.Media.playerName="My Media Player"; 
s.Media.segmentByMilestones = true; 
s.Media.trackUsingContextData = true; 
s.Media.contextDataMapping = { 
    "a.media.name":"eVar2, prop2", 
    "a.media.segment":"eVar3", 
    "a.contentType":"eVar1", 
    "a.media.timePlayed":"event3", 
    "a.media.view":"event1", 
    "a.media.segmentView":"event2", 
    "a.media.complete":"event7", 
    "a.media.milestones":{ 
        25:"event4", 
        50:"event5", 
        75:"event6" 
    } 
} 
 
s.Media.monitor = function (s, media) { } //If Needed

/* Turn on and configure debugging here */ 
s.debugTracking = true; 
s.trackLocal = true; 
 
/* WARNING: Changing any of the below variables will cause drastic changes to how your visitor 
data is collected. Changes should only be made when instructed to do so by your account 
manager.*/ 
s.visitorNamespace = "yourNamespace"; 
s.trackingServer="metrics.mysite.com" //Use only if using first party cookies 
s.trackingServerSecure="smetrics.mysite.com" // Use only if using first party cookies in  
                                             // conjunction with SSL 
s.dc = '122'; 
 
/************************** PLUGINS SECTION *************************/ 
/* Insert any plugins code you want to use here. */ 
 
/****************************** MODULES *****************************/ 
/* Insert the media module tracking code here. */