Migração do Marco para o Media Analytics

Visão geral

Os conceitos principais de avaliação de vídeo são os mesmos para o Milestone e o Media Analytics, que está pegando eventos do player de vídeo e mapeando-os para métodos de análise, além de capturar metadados e valores de player e mapeá-los para variáveis de análise. A solução do Media Analytics surgiu do Milestone, mas muitos dos métodos e métricas são os mesmos, no entanto, a abordagem de configuração e o código mudaram bastante. Deve ser possível atualizar o código de evento do player 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 Expiração da eVar
padrão: Visita		 Conteúdo
Tipo de conteúdo Expiração da eVar
padrão: 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 de vídeo Tipo de evento:
Contador		 Conteúdo concluído

Variáveis do módulo de mídia

Milestone Sintaxe do Milestone Media Analytics Sintaxe do Media Analytics
Media.trackUsingContextData s.Media.trackUsingContextData
= true;		 N/D Todos os dados do Media Analytics são enviados somente com 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

Milestone Sintaxe do Milestone Media Analytics Sintaxe do Media Analytics
Media.autoTrack s.Media.autoTrack
= true;		 N/D Não fornecemos mais mapeamentos pré-criados de player.
Media.autoTrackNetStreams s.Media.
autoTrackNetStreams
= true		 N/D Não fornecemos mais mapeamentos pré-criados de player.
Media.completeByCloseOffset s.Media.
completeByCloseOffset
= true		 N/D A Conclusão de conteúdo é compatível apenas com um marcador de progresso de 100%.
Media.completeCloseOffsetThreshold s.Media.
completeCloseOffsetThreshold
= 1		 N/D A Conclusão de conteúdo é compatível apenas com um marcador de progresso de 100%.
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 O Media Analytics sempre rastreia marcadores de progresso em 10%, 25%, 50%, 75%, 95%.
Media.trackOffsetMilestones s.Media.
trackOffsetMilestones
= "20,40,60";		 N/D O Media Analytics sempre rastreia marcadores de progresso em 10%, 25%, 50%, 75%, 95%.
Media.segmentByMilestones s.Media.segmentByMilestones
= true;		 N/D O rastreamento automático não está mais disponível.
Media.segmentByOffsetMilestones s.Media.
segmentByOffsetMilestones
= true;		 N/D O rastreamento automático não está mais disponível.

Variáveis de rastreamento de anúncios

Milestone Sintaxe do Milestone 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 por padrão para anúncios. 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 O rastreamento automático não está mais disponível.
Media.adSegmentByOffsetMilestones s.Media.
adSegmentByOffsetMilestones
= true;		 N/D O rastreamento automático não está mais disponível.

Métodos do módulo de mídia

Milestone Sintaxe do Milestone Media Analytics Sintaxe do Media Analytics
Media.open s.Media.open(
mediaName,
mediaLength,
mediaPlayerName)		 trackSessionStart trackSessionStart(
mediaObject,
contextData)
mediaName mediaName: (obrigatório) o nome do vídeo conforme você quer que ele seja exibido nos relatórios de vídeo. name createMediaObject(
name,
mediaId,
length,
streamType)
mediaLength mediaLength: (obrigatório) a duração do vídeo, em segundos. length createMediaObject(
name,
mediaId,
length,
streamType)
mediaPlayerName 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. playerName MediaHeartbeatConfig.
playerName
Media.openAd s.Media.openAd(
name,
length,
playerName,
parentName,
parentPod,
parentPodPosition,
CPM)		 trackEvent mediaHeartbeat.trackEvent(
MediaHeartbeat.
Event.
AdBreakStart,
adBreakObject);
...
trackEvent(
MediaHeartbeat.
Event.
AdStart,
adObject,
adCustomMetadata);
name name: (obrigatório) o nome ou a ID do anúncio. name createAdObject(
name,
adId,
position,
length)
length length: (obrigatório) a duração do anúncio. length createAdObject(
name,
adId,
position,
length)
playerName playerName: (obrigatório) o nome do reprodutor de mídia utilizado para exibir o anúncio. playerName MediaHeartbeatConfig.
playerName
parentName parentName: O nome ou a ID do conteúdo principal no qual o anúncio está incorporado. N/D Herdado automaticamente.
parentPod parentPod: A posição, no conteúdo principal, da reprodução do anúncio. position createAdBreakObject(
name,
position,
startTime)
parentPodPosition parentPodPosition: A posição, no pod, da reprodução do anúncio. position createAdObject(
name,
adId,
position,
length)
CPM CPM: O CPM ou o CPM criptografado (com prefixo "~") que se aplica a essa reprodução. 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.
Event.
SeekStart)
ou
trackEvent(
MediaHeartbeat.
Event.
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] =
"Sample Episode";
standardVideoMetadata
[MediaHeartbeat.
VideoMetadataKeys.
SHOW] = "Sample Show";
...
mediaObject.setValue(
MediaHeartbeat.
MediaObjectKey.
StandardVideoMetadata,
standardVideoMetadata);
Media.track s.Media.track(mediaName) N/D A frequência de chamada de rastreamento é definida automaticamente.

Nesta página