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

Pré-requisitos

Cada propriedade do Adobe Experience Platform Launch precisa das seguintes extensões instaladas e configuradas na tela Extension:

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

De acordo com https://studio.support.brightcove.com/publish/choosing-correct-embed-code.html, 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 player de vídeo deve ser renderizado. Consulte também: https://studio.support.brightcove.com/players/generating-player-embed-code.html

Embora esta extensão versão 1.1.0 seja compatível com a incorporação de vários vídeos do BrightCove em uma única página da Web, verifique se a id propriedade nas tags incorporadas avançadas, caso existam, tem valores diferentes, como: player1, player2 e assim por diante.

Em páginas com vários vídeos, observe que cada vídeo usa o mesmo conjunto de configurações na regra do Platform Launch executada nessa página. Por exemplo, se você criar uma regra com um evento que é acionado no vídeo 50% concluído, cada vídeo na página acionará a regra no ponto de sinalização de 50%.

Se a página da Web que você pretende usar com essa extensão tiver a chance de interagir com o vídeo antes que a tag do Platform Launch seja totalmente carregada, considere carregar a biblioteca do Platform Launch de forma síncrona e insira a tag <script type="text/javascript">\_satellite.pageBottom();\</script\> antes de o vídeo ser incorporado na página para atenuar possíveis problemas de tempo. Para referência, consulte https://docs.brightcove.com/brightcove-player/1.x/Player.html#vjsplayer, para ver a API do BrightCove usada com essa 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: esse elemento de dados registra o local, em segundos, da posição do indicador de reprodução na linha do tempo do vídeo, quando ele é chamado em uma regra do Platform Launch.
• 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: esses elementos de dados especificam 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 as tags associadas 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 for de 60 segundos e o ponto de sinalização especificado for de 50%, o evento será acionado na marca de 30 segundos.
  Esse evento dispara toda vez que esse ponto de sinalização é atingido. Por exemplo, se o usuário atingir a marca de 50%, buscar o vídeo antes da marca de 50% e, em seguida, atingir a marca de 50% novamente, o gatilho será acionado novamente.
• Vídeo concluído: esse evento dispara quando um vídeo é totalmente concluído.
• Metadados carregados pelo vídeo: esse evento é acionado quando o player 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

Haverá uma regra do Platform Launch para cada Evento de vídeo (os sete eventos listados acima). Crie uma regra específica do Platform Launch para cada evento que você deseja rastrear. Em outras palavras, se você não quiser rastrear a pausa de vídeo, não crie uma regra para ela.

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 do Platform Launch 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:

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 do nome do vídeo (exemplo: eVar10)
   • Uma prop/eVar para o Elemento de dados de duração do vídeo (exemplo: eVar11)
   • Uma prop/eVar para o Elemento de dados do local atual do vídeo (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('|');