Video Custom Cue Tracker: Documentação da extensão BrightCove

Pré-requisitos

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

  • 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 de lançamento da plataforma 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%.

If the webpage you are planning to use with this extension has a chance of interacting with the video before the Platform Launch tag has had a chance to completely load, consider loading the Platform Launch library synchronously, and place the <script type="text/javascript">\_satellite.pageBottom();\</script\> tag before the video embed on the page to mitigate potential timing issues. 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 de inicialização de plataforma.
  • 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 de lançamento de plataforma para cada Evento de vídeo (os sete eventos listados acima). Crie uma regra de lançamento de plataforma específica para cada evento que 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 de inicialização de plataforma para "Start de 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

DICA

For those who might not want to provision multiple eVars or props for each video element, data elements values can be concatenated within Platform Launch, and then parsed into Classification reports using the Classification Rule Builder Tool, https://docs.adobe.com/content/help/pt-BR/analytics/components/classifications/classifications-rulebuilder/classification-rule-builder.html, and then applied as a segment in Analysis Workspace.

Para fazer isso, crie um novo elemento de dados chamado "Video MetaData" e programe-o para reunir todos os elementos de dados de vídeo (listados acima) e concatená-los juntos.

var r = [];

r.push( \_satellite.getVar( &#39;Video ID&#39; ) );

r.push( \_satellite.getVar( &#39;Video Name&#39; ) );

r.push( \_satellite.getVar( &#39;Video Duraction&#39; ) );


return r.join(&#39;|&#39;);

Nesta página