Visão geral da extensão de rastreamento de vídeo BrightCove

Pré-requisitos

Cada propriedade de tag no Adobe Experience Platform precisa das seguintes extensões instaladas e configuradas na tela Extension:

• Adobe Analytics
• Serviço do Experience Cloud Visitor ID
• Extensões principais instaladas

Use o trecho de código "Código incorporado na página (avançado)" no HTML de cada página da Web em que um reprodutor de vídeo deve ser renderizado. O trecho HTML "Código incorporado na página (avançado)" pode ser encontrado na documentação do Brightcove. O link a seguir fornece mais informações sobre como gerar código incorporado para players de visualização e vídeo publicados.

Esta extensão versão 1.1.0 é compatível com a incorporação de vários vídeos do BrightCove em uma única página da Web. Se houver várias id propriedades nas tags incorporadas avançadas, verifique se cada uma tem valores exclusivos. Por exemplo, player1, player2 e assim por diante.

Se a página da Web que usa essa extensão interagir com o vídeo antes que o script relevante tenha sido totalmente carregado, há duas ações que você pode tomar para corrigir o problema. Em primeiro lugar, é possível carregar a biblioteca de tags de forma síncrona e, em segundo lugar, colocar o elemento <script type="text/javascript">\_satellite.pageBottom();\</script\> antes de o vídeo ser incorporado na página.

Consulte a documentação da API do BrightCove para obter mais informações sobre os métodos e eventos de componentes usados nesta extensão.

Elementos de dados

Há sete elementos de dados disponíveis na extensão, e nenhum deles precisa ser configurado.

• Posição do indicador de reprodução: quando esse elemento de dados é chamado em uma regra de tag, ele registra, em segundos, o local da posição do indicador de reprodução na linha do tempo do vídeo.
• ID da conta do vídeo: esse elemento de dados registra a ID da conta do Brightcove que publicou o vídeo.
• Duração do vídeo: esse elemento de dados registra a duração total, em segundos, do conteúdo do vídeo. Além disso, uma Métrica calculada pode ser criada no Analytics para converter o número em segundos, em minutos ou horas.
• Suporte para anúncio de vídeo: esse elemento de dados especifica se os anúncios são ou não compatíveis com o vídeo.
• ID do vídeo: esse elemento de dados especifica a ID do BrightCove associada ao vídeo.
• Nome do vídeo: esse elemento de dados especifica o nome descritivo ou amigável do vídeo.
• Tags de vídeo: esse elemento de dados especifica os scripts específicos associados ao vídeo.

Eventos

Há sete eventos disponíveis na extensão. Somente o rastreamento de ponto de sinalização personalizado requer configuração.

• Custom Cue Point Tracking: esse evento dispara quando o vídeo atinge a porcentagem limite de vídeo especificada. Por exemplo, se um vídeo tiver 60 segundos e o ponto de sinalização especificado for 50%, o evento será acionado na marca de 30 segundos.

• Vídeo concluído: esse evento dispara quando um vídeo é totalmente concluído.
• Metadados de vídeo carregados: esse evento é acionado quando o reprodutor recebe informações de duração e dimensão iniciais.
• Pausar vídeo: esse evento é acionado quando o vídeo é pausado.
• Resumo do vídeo: esse evento é acionado quando o conteúdo do vídeo é retomado após um evento de pausa.
• Alteração na tela do vídeo: o evento é acionado quando o vídeo é alternado para dentro ou para fora do modo de tela cheia.
• Início do vídeo: esse evento é acionado quando o conteúdo do vídeo é iniciado pela primeira vez.

Uso

Uma regra de tag pode ser definida para cada evento de vídeo (os sete eventos listados acima). Crie uma regra de tag específica para cada evento que deseja rastrear. Caso não queira rastrear um evento, basta omitir a criação de uma regra para ele.

As regras têm três ações:

1. Definir as variáveis do Adobe Analytics. (Crie elementos de dados para todos ou alguns dos elementos de dados listados acima.)
2. Enviar o sinal do Adobe Analytics.
3. Limpar as variáveis do Adobe Analytics.

Exemplo de regra de tag para "Início do vídeo"

Os seguintes objetos de extensão de vídeo devem ser incluídos:

• Eventos

  1. "Início do vídeo": este evento faz com que a regra seja acionada quando os visitantes começam a reproduzir um vídeo do BrightCove.

• Condição

  1. None

• Ações

  1. Em uma ação "Set Variables" do Analytics, defina:

     • O evento para Início do vídeo (exemplo: event17)
     • Uma prop/eVar para o elemento de dados Nome do vídeo (exemplo: eVar10)
     • Uma prop/eVar para o elemento de dados Duração do vídeo (exemplo: eVar11)
     • Uma prop/eVar para o elemento de dados Local do vídeo atual (exemplo: eVar12)

  2. A ação "Send Beacon" do Analytics (s.tl)

  3. A ação "Clear Variables" do Analytics

var r = [];

r.push( \_satellite.getVar( 'Video ID' ) );

r.push( \_satellite.getVar( 'Video Name' ) );

r.push( \_satellite.getVar( 'Video Duraction' ) );


return r.join('|');