Informações para ajudá-lo com o Video Analytics.
A avaliação de vídeo é descrita em detalhes no guia Medição de vídeo e áudio no Adobe Analytics . O processo geral para avaliar vídeos é muito semelhante em todas as plataformas AppMeasurement. Esta seção de start rápido fornece uma visão geral básica das tarefas do desenvolvedor junto com exemplos de código.
A tabela a seguir lista os dados de mídia que são enviados para o Analytics. Usar as regras de processamento para mapear os dados de contexto para uma variável do Analytics.
a.media.name
(Obrigatório) Coleta o nome do vídeo, conforme especificado na implementação, quando um visitante visualização o vídeo de alguma forma.Você pode adicionar classificações para essa variável.
(Opcional) A variável Insight personalizado fornece informações de definição de caminho de vídeo.
a.media.name
(Opcional) Fornece informações sobre o caminho do vídeo. A definição de caminho deve ser ativada para essa variável pelo ClientCare.
a.media.segment
(Obrigatório) Coleta dados de segmento do vídeo, incluindo o nome do segmento e a ordem na qual ele ocorre no vídeo.
Essa variável é preenchida com a habilitação da variável segmentByMilestones
durante o monitoramento de eventos de player de modo automático, ou ao configurar um nome de segmento personalizado durante o monitoramento manual dos eventos do player. For example, when a visitor views the first segment in a video, SiteCatalyst might collect the following in the 1:M:0-25
segments eVar.
O método padrão de coleta de dados de vídeo coleta dados nos seguintes pontos: start de vídeo (play), início do segmento e fim do vídeo (stop). O Analytics conta a primeira visualização de segmento no início do segmento, quando o visitante começa a assistir. As visualizações de segmento subsequentes ocorrem conforme o segmento começa.
a.contentType
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 "vídeo". Essa variável não precisa ser reservada exclusivamente para rastreamento de vídeo. Quando outros conteúdos relatam tipos usando essa mesma variável, você pode analisar a distribuição de visitantes entre os diferentes tipos de conteúdo. Por exemplo, é possível marcar outros tipos de conteúdo por meio de valores como “artigo” ou “página do produto” 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.
a.media.timePlayed
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).
a.media.view
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.
a.media.segmentView
Indica que um visitante visualizou uma parte de um segmento de vídeo. No entanto, não fornece informações sobre quanto ou qual parte de um vídeo o visitante visualizou.
a .media.complete
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.
Defina um objeto MediaSettings
com as configurações que deseja usar para monitorar o vídeo:
var mySettings = ADB.Media.settingsWith("name", 10, "playerName", "playerId");
Para avaliar a reprodução de vídeo, os métodos Play
, Stop
, e Close
devem ser chamados em momentos apropriados. Por exemplo, quando o reprodutor está pausado, Stop
. Play
é chamado quando a reprodução começa ou é retomada.
property Platform::String ^name;
property Platform::String ^playerName;
property Platform::String ^playerID;
property double length;
property Platform::String ^channel;
property Platform::String ^milestones;
property Platform::String ^offsetMilestones;
property bool segmentByMilestones;
property bool segmentByOffsetMilestones;
property int trackSeconds;
property int completeCloseOffsetThreshold;
// MediaAnalytics Ad settings
property Platform::String ^parentName;
property Platform::String ^parentPod;
property Platform::String ^CPM;
property double parentPodPosition;
property bool isMediaAd;
SettingsWith (winJS: settingsWith)
Retorna um objeto MediaSettings
com parâmetros especificados.
Esta é a sintaxe para este método:
static MediaSettings ^SettingsWith(Platform::String ^name, double length, Platform::String ^playerName, Platform::String ^playerID);
Esta é a amostra de código para este método:
var mySettings = ADB.Media.settingsWith("name", 10, "playerName", "playerId");
AdSettingsWith (winJS: adSettingsWith)
Retorna um objeto MediaSettings
para utilizar no monitoramento de um vídeo de anúncio.
Esta é a sintaxe para este método:
static MediaSettings ^AdSettingsWith(Platform::String ^name, double length, Platform::String ^playerName, Platform::String ^parentName, Platform::String ^parentPod, double parentPosition, Platform::String ^CPM);
Esta é a amostra de código para este método:
var myAdSettings = ADB.Media.adSettingsWith("name", 10, "playerName", "parentName", "parentPod", 5, "myCPM");
Open (winJS: open)
Rastreia uma abertura de mídia usando as configurações definidas em settings
.
Esta é a sintaxe para este método:
static void Open(MediaSettings ^settings);
Esta é a amostra de código para este método:
ADB.Media.open(mySettings);
Close (winJS: fechar)
Rastreia um fechamento de mídia para o item de mídia chamado name
.
Esta é a sintaxe para este método:
static void Close(Platform::String ^name);
Esta é a amostra de código para este método:
ADB.Media.close("mediaName");
Reproduzir (winJS: play)
Rastreia uma reprodução de mídia para o item de mídia nomeado name
no deslocamento especificado (em segundos).
Esta é a sintaxe para este método:
static void Play(Platform::String ^name, double offset);
Esta é a amostra de código para este método:
ADB.Media.play("mediaName", 0);
Concluído (winJS: concluído)
Marca manualmente o item de mídia como concluído no offset em questão (em segundos).
Esta é a sintaxe para este método:
static void Complete(Platform::String ^name, double offset);
Esta é a amostra de código para este método:
ADB.Media.complete("mediaName", 8);
Stop (winJS: parar)
Notifica ao módulo de mídia que o vídeo foi interrompido ou pausado no offset em questão.
Esta é a sintaxe para este método:
static void Stop(Platform::String ^name, double offset);
Esta é a amostra de código para este método:
ADB.Media.stop("mediaName", 4);
Clique em (winJS: clique)
Notifica ao módulo de mídia que o item de mídia foi clicado.
Esta é a sintaxe para este método:
static void Click(Platform::String ^name, double offset);
Esta é a amostra de código para este método:
ADB.Media.click("mediaName", 3);
Track (winJS: track)
Envia uma chamada de ação de rastreamento (sem exibição de página) para o estado de mídia atual.
Esta é a sintaxe para este método:
static void Track(Platform::String ^name, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object> ^contextData);
Esta é a amostra de código para este método:
ADB.Media.track("mediaName", null);