Visão geral do marco milestone-overview

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ável

Descrição

Sintaxe:

s.Media.trackUsingContextData = true;
Essa opção habilita o monitoramento integrado de vídeos. Quando definido como true, 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

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 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

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.

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ável

Descrição

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 player.

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.

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 true 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.

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 true 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.

Sintaxe:

s.Media.playerName = "Custom Player Name"

Especifica um nome de player de vídeo personalizado.

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.

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.

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.

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

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ável

Descrição

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.

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.

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.

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

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étodo

Descrição

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.

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.

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.

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. Este método usa o seguinte parâmetro:

mediaName: o nome do vídeo. Deve corresponder ao nome utilizado em Media.open.

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.

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 maior que 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)

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.

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.

Consulte Avaliação de métricas adicionais com Media.monitor.

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: um objeto NSDate contendo dados sobre quando Media.open 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: Quando a reprodução é interrompida devido a uma pausa no início da depuração por Media.autoTrack 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;

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.

Consulte Avaliação de métricas adicionais com 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.