Show Menu
TOPICS×

Migração do Marco para o Media Analytics

Visão geral

Os principais conceitos de medição de vídeo são os mesmos para Marco e Media Analytics, que estão realizando eventos do reprodutor de vídeo e mapeando-os para os métodos de análise, além de capturar metadados e valores do reprodutor e mapeá-los para variáveis​de análise. A solução do Media Analytics surgiu no Marco, portanto, muitos dos métodos e métricas são os mesmos. No entanto, a abordagem e o código de configuração mudaram significativamente. Deve ser possível atualizar o código de evento do reprodutor para apontar para os novos métodos do Media Analytics. Consulte Visão geral do SDK e Visão geral do rastreamento para obter mais detalhes sobre a implementação do Media Analytics.
As tabelas a seguir fornecem as traduções entre as soluções de Marco e do Media Analytics.

Guia de migração

Referência da variável

Métrica de marco
Tipo de variável
Métrica do Media Analytics
Conteúdo
eVar
Expiração padrão: visita
Conteúdo
Tipo de conteúdo
Expiração
padrão do eVar: Visualização de página
Tipo de conteúdo
Tempo gasto no conteúdo
Tipo
de evento: Contador
Tempo gasto no conteúdo
Inicialização de vídeo
Tipo
de evento: Contador
Inicialização de vídeo
Término do vídeo
Tipo
de evento: Contador
Conteúdo concluído

Variáveis do módulo de mídia

Etapa
Sintaxe do marco
Media Analytics
Sintaxe do Media Analytics
Media.trackUsingContextData
s.Media.trackUsingContextData = true;
N/D
Todos os dados do Media Analytics são enviados somente usando os dados de contexto.
Media.contextDataMapping
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" } };
N/D
Os dados de contexto do Media Analytics são preenchidos automaticamente em variáveis reservadas. O mapeamento para eVars, as propriedades e os eventos que não são mais necessários no código de implementação. Os clientes podem mapear dados de contexto para variáveis usando regras de processamento.
Media.trackVars
s.Media.trackVars = "events, prop2, eVar1, eVar2, eVar3";
N/D
Não é mais necessário, pois o mapeamento ocorre por meio de variáveis reservadas e regras de processamento.
Media.trackEvents
s.Media.trackEvents = "event1, event2, event3, event4, event5, event6, event7"
N/D
Não é mais necessário, pois o mapeamento ocorre por meio de variáveis reservadas e regras de processamento.

Variáveis opcionais

Etapa
Sintaxe do marco
Media Analytics
Sintaxe do Media Analytics
Media.autoTrack
s.Media.autoTrack = true;
N/D
Os mapeamentos de reprodutores criados previamente não são mais fornecidos.
Media.autoTrackNetStreams
s.Media. autoTrackNetStreams = true
N/D
Os mapeamentos de reprodutores criados previamente não são mais fornecidos.
Media.completeByCloseOffset
s.Media. completeByCloseOffset = true
N/D
O Conteúdo concluído suporta apenas um marcador de 100% de progresso.
Media.completeCloseOffsetThreshold
s.Media. completeCloseOffsetThreshold = 1
N/D
O Conteúdo concluído suporta apenas um marcador de 100% de progresso.
Media.playerName
s.Media.playerName = "Custom Player Name"
Chave do SDK: playerName; Chave da API: media.playerName
MediaHeartbeatConfig. playerName
Media.trackSeconds
s.Media. trackSeconds = 15
N/D
O Media Analytics está definido para 10 segundos para conteúdo e 1 segundo para anúncios. Nenhuma outra opção está disponível.
Media.trackMilestones
s.Media. trackMilestones = "25,50,75";
N/D
Media Analytics sempre rastreia marcadores de progresso em 10%, 25%, 50%, 75%, 95%
Media.trackOffsetMilestones
s.Media. trackOffsetMilestones = "20,40,60";
N/D
Media Analytics sempre rastreia marcadores de progresso em 10%, 25%, 50%, 75%, 95%
Media.segmentByMilestones
s.Media.segmentByMilestones = true;
N/D
A faixa automática não está mais disponível
Media.segmentByOffsetMilestones
s.Media. segmentByOffsetMilestones = true;
N/D
A faixa automática não está mais disponível

Variáveis de rastreamento de anúncios

Etapa
Sintaxe do marco
Media Analytics
Sintaxe do Media Analytics
Media.adTrackSeconds
s.Media. adTrackSeconds = 15
N/D
O Media Analytics está definido para 10 segundos para conteúdo e 1 segundo para anúncios. Nenhuma outra opção está disponível.
Media.adTrackMilestones
s.Media. adTrackMilestones = "25,50,75";
N/D
Os marcadores de progresso não são fornecidos aos anúncios por padrão. Use as métricas calculadas para criar marcadores de progresso de anúncios.
Media.adTrackOffsetMilestones
s.Media. adTrackOffsetMilestones = "20,40,60";
N/D
Media Analytics está definido para 1 segundo para anúncios. Nenhuma outra opção está disponível.
Media.adSegmentByMilestones
s.Media. adSegmentByMilestones = true;
N/D
A faixa automática não está mais disponível
Media.adSegmentByOffsetMilestones
s.Media. adSegmentByOffsetMilestones = true;
N/D
A faixa automática não está mais disponível

Métodos do módulo de mídia

Etapa
Sintaxe do marco
Media Analytics
Sintaxe do Media Analytics
Media.open
s.Media.open(mediaName,mediaLength,mediaPlayerName)
trackSessionStart
trackSessionStart( mediaObject, contextData)
mediaName — (obrigatório) O nome do vídeo conforme você quer que ele seja exibido nos relatórios de vídeo.
mediaName
name
createMediaObject( name, mediaId, length, streamType)
mediaLength — (obrigatório) A duração do vídeo, em segundos.
mediaLength
length
createMediaObject( name, mediaId, length, streamType)
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.
mediaPlayerName
playerName
MediaHeartbeatConfig. playerName
Media.openAd
s.Media.openAd(name,length,playerName,parentName,parentPod,parentPodPosition,CPM)
trackEvent
mediaHeartbeat.trackEvent( MediaHeartbeat. Evento. AdBreakStart, adBreakObject); ... trackEvent( MediaHeartbeat. Evento. AdStart, adObject, adCustomMetadata);
name — (obrigatório) o nome ou a ID do anúncio.
name
name
createAdObject( name, adId, position, length)
length (obrigatório) a duração do anúncio.
length
length
createAdObject( name, adId, position, length)
playerName — (obrigatório) O nome do reprodutor de mídia utilizado para exibir o anúncio.
playerName
playerName
MediaHeartbeatConfig. playerName
parentName — o nome ou a ID do conteúdo principal no qual o anúncio está incorporado.
parentName
N/D
Herdado automaticamente
parentPod — a posição, no conteúdo principal, em que o anúncio foi reproduzido.
parentPod
position
createAdBreakObject( name, position, startTime)
parentPodPosition — a posição, no pod, de reprodução do anúncio.
parentPodPosition
position
createAdObject( name, adId, position, length)
CPM O CPM ou o CPM criptografado (com prefixo “~”) que se aplica a essa reprodução.
CPM
N/D
Por padrão, não disponível no Media Analytics
Media.click
s.Media.click(name,offset)
N/D
Usar uma chamada de análise de link personalizado para rastrear os cliques.
Media.close
s.Media.close(mediaName)
trackSessionEnd
trackSessionEnd()
Media.complete
s.Media.complete(name,offset)
trackComplete
trackComplete()
Media.play
s.Media.play(name,offset,segmentNum,segment,segmentLength)
trackPlay
trackPlay()
Media.stop
s.Media.stop(mediaName,mediaOffset)
trackPause
ou
trackEvent
trackPause()
ou
trackEvent( MediaHeartbeat. Evento. SeekStart)
ou
trackEvent( MediaHeartbeat. Evento. BufferStart);
Media.monitor
s.Media.monitor(s, media)
Use os metadados personalizados ou padrão para definir variáveis adicionais.
var customVideoMetadata = { isUserLoggedIn: "false", tvStation: "Sample TV station", programmer: "Sample programmer" }; ... var standardVideoMetadata = {}; standardVideoMetadata [MediaHeartbeat. VideoMetadataKeys. EPISODE] = "Episódio de amostra"; standardVideoMetadata [MediaHeartbeat. VideoMetadataKeys. SHOW] = "Show de amostra"; ... mediaObject.setValue( MediaHeartbeat. MediaObjectKey. StandardVideoMetadata, standardVideoMetadata);
Media.track
s.Media.track(mediaName)
N/D
O rastreamento da frequência de chamada é automaticamente definido.