DocumentaçãoAnalyticsGuia do Media Analytics

Migração do Marco para o Media Analytics migrating-from-milestone-to-media-analytics

Last update: Tue Jan 03 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • User
  • Admin
  • Developer

Visão geral overview

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

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.
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb