Show Menu
TOPICS×

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 o relatórios de vídeo para uma implementação de etapa, acesse
Admin > Report Suite Manager.
​Selecione o conjunto de relatórios e escolha​
Video Management > Video Reporting:
Na primeira tela, somente o Vídeo principal funcionará com os dados do Marco. Selecione
Video Core
e clique em
Save.
Na tela seguinte, selecione
Use Custom Variables.
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. */