Guia de implementação

Vídeo mid-roll

Mid-roll video ads

Anúncio em vídeo que entra no meio do conteúdo, como um intervalo comercial, e depois o vídeo continua de onde parou.

Ad Manager
Ad Exchange
AdSense (via Ad Manager)
dentro do player de vídeo (celular e desktop)

Aprender o formato Conferir no meu site

Desktop

Celular

Entenda em 1 minuto

O que é o vídeo mid-roll

Pense num jogo de futebol na TV: no intervalo entram os comerciais e, depois, o jogo volta. O mid-roll é o intervalo comercial do vídeo do seu site. O vídeo para num ponto combinado, toca um ou mais anúncios dentro do mesmo player e depois continua exatamente de onde parou. Quando entram vários anúncios seguidos, o Google chama esse grupo de conjunto de anúncios (em inglês, ad pod), que é como um bloco de comerciais.

Quem decide a hora dos intervalos? No Ad Manager, isso é feito pelas regras de anúncio de vídeo, chamadas ad rules. Elas dizem quando e como os anúncios aparecem dentro de um vídeo. Você pode escolher horários fixos, como os segundos 60, 120 e 180, ou um intervalo a cada tantos segundos. Também pode usar cue points, que são marquinhas dentro do vídeo mostrando os melhores lugares para parar, como o fim de uma cena. O player recebe esse plano numa resposta VMAP, que funciona como a grade de horários dos intervalos, e o IMA SDK toca cada intervalo na hora certa.

Tem detalhes importantes. As regras de anúncio de vídeo só existem no Google Ad Manager 360 com contrato de vídeo avançado. Para o mid-roll funcionar, o Ad Manager precisa saber quanto o vídeo dura e onde estão os pontos de parada. Você pode cadastrar os vídeos no Ad Manager (isso se chama ingestão de conteúdo) e mandar os códigos cmsid e vid na tag. Ou, sem esse cadastro, pode mandar a duração do vídeo em segundos (vid_d) e a lista de pontos de parada em milissegundos (allcues). O Google diz que a duração precisa ser enviada para ter mid-rolls.

O IMA também precisa saber em que segundo o vídeo está. Por isso você entrega o próprio elemento de vídeo ao IMA e liga o gerenciador de anúncios antes de o conteúdo começar, porque é aí que ele começa a contar o tempo. O mid-roll faz sentido em vídeos em que a pessoa fica um bom tempo assistindo. Pense sempre em quem está vendo: o Ad Manager deixa limitar quantos anúncios entram em cada intervalo, quanto cada um pode durar e usar limites de frequência por intervalo, por vídeo ou pelos dois.

Passo a passo

Como implementar

Ative as regras de anúncioNo Ad Manager 360, vá em Administrador, Vídeo e áudio, Configurações de áudio e vídeo. Ative a opção Regras de anúncio e salve.
Crie uma regra padrãoVá em Vídeo, Regras de anúncios, Nova regra de anúncio. Dê um nome, escolha Padrão como tipo, escolha a prioridade e marque Anúncios intermediários em vídeo como Ativar.
Escolha quando entram os intervalosNa frequência dos mid-rolls, escolha Em horários fixos, A cada n segundos, Em pontos de inserção fixos ou A cada n pontos de inserção. Depois defina o conjunto: Número máximo de anúncios e Duração máxima do anúncio. Os tempos precisam ser números inteiros.
Mande a duração e os pontos na tagNa tag, peça regras de anúncio com ad_rule=1. Sem vídeos cadastrados no Ad Manager, informe a duração em segundos (vid_d) e os pontos de parada em milissegundos (allcues). Com vídeos cadastrados, mande cmsid e vid.
Ligue o IMA ao vídeoEntregue ao IMA o elemento de vídeo, que informa o tempo atual do vídeo. Ligue o gerenciador de anúncios antes de tocar o conteúdo, porque é aí que o IMA começa a acompanhar o tempo.
Pause e retome nos intervalosPause o vídeo quando o IMA pedir pausa e volte a tocar quando ele pedir para continuar. Assim cada intervalo entra e sai no momento certo.

Exemplo implementado

O código e como fica na tela

Vai no mesmo código do player com IMA: muda só a tag (com ad_rule=1, vid_d e allcues) e o elemento de vídeo é entregue ao IMA para ele saber o tempo.

<script src="//imasdk.googleapis.com/js/sdkloader/ima3.js"></script>
<script>
  // Vídeo de 10 minutos (vid_d=600)
  // com intervalos em 2 e 5 minutos (allcues em ms)
  var adsRequest = new google.ima.AdsRequest();
  adsRequest.adTagUrl = 'https://pubads.g.doubleclick.net/gampad/ads?' +
      'iu=/1234567/exemplo&sz=640x480&env=vp&gdfp_req=1' +
      '&ad_rule=1&output=vmap&vid_d=600&allcues=120000,300000' +
      '&unviewed_position_start=1&vpa=click&vpmute=0&plcmt=1' +
      '&description_url=https%3A%2F%2Fwww.exemplo.com%2Fvideo&correlator=';
  adsRequest.linearAdSlotWidth = 640;
  adsRequest.linearAdSlotHeight = 400;
  adsLoader.requestAds(adsRequest);

  adsLoader.addEventListener(
      google.ima.AdsManagerLoadedEvent.Type.ADS_MANAGER_LOADED,
      function (e) {
        // O próprio <video> informa o tempo atual (currentTime) ao IMA
        adsManager = e.getAdsManager(video);
        adsManager.addEventListener(
            google.ima.AdEvent.Type.CONTENT_PAUSE_REQUESTED,
            function () { video.pause(); });
        adsManager.addEventListener(
            google.ima.AdEvent.Type.CONTENT_RESUME_REQUESTED,
            function () { video.play(); });
      });

  // No clique de play: init() antes de tocar o conteúdo
  // adDisplayContainer.initialize();
  // adsManager.init(640, 360, google.ima.ViewMode.NORMAL);
  // adsManager.start();
</script>

No desktopO vídeo pausa no ponto marcado, o anúncio toca no mesmo player e, quando ele acaba, o conteúdo continua de onde parou.

No celularFunciona igual dentro do player do celular. Se a pessoa arrastar a barra do vídeo para frente e o player não tratar isso, vários intervalos podem tocar um atrás do outro.

O que o Google orienta

Pode e não pode

Pode

Escolher os intervalos por horários fixos, a cada N segundos, em cue points fixos ou a cada N cue points.
Servir mid-roll sem cadastrar os vídeos no Ad Manager, mandando vid_d e allcues na tag.
Definir quantos anúncios entram em cada intervalo e quanto cada um pode durar.
Usar limite de frequência por intervalo, por vídeo ou pelos dois.
Desligar o início automático dos intervalos no IMA e decidir na hora se cada intervalo pronto vai tocar.

Não pode

Não dá para ter mid-roll sem informar a duração do conteúdo: o Google diz que vid_d precisa ser enviado para mid-rolls.
Regras de sessão não servem para mid-roll: elas só podem ser aplicadas a pre-roll.
Não pode deixar os controles do vídeo e do anúncio cobertos, escondidos ou sem funcionar.
Não pode avisar o fim do conteúdo quando quem terminou foi um anúncio: esse aviso é só para o fim do vídeo.

Dicas

Para fazer do jeito certo

Quando a pessoa arrastar a barra, guarde o tempo de onde ela começou e informe esse tempo ao IMA até o vídeo voltar ao normal. Assim não tocam vários intervalos seguidos.
No Safari do celular, a detecção de arraste do vídeo não funciona direito. O guia do IMA mostra um jeito manual de perceber o arraste.
Se você cadastra os vídeos no Ad Manager, confira em Vídeo, Conteúdo se Duração e Pontos de inserção de anúncios intermediários foram importados certo.
Existe uma opção beta, Especificar as configurações do último anúncio intermediário, para o último intervalo ter configurações próprias. Ela não entra na previsão de inventário.

Cuidado

Erros comuns

Avisar fim de conteúdo no fim do anúncio

O aviso de fim de conteúdo é só para quando o vídeo acaba. Como o IMA pode usar o mesmo player para os anúncios, avisar no fim de um anúncio confunde o SDK.

Tocar o vídeo antes de ligar o IMA

O IMA só começa a acompanhar o tempo quando o gerenciador de anúncios é ligado. Por isso o Google pede para ligá-lo sempre antes de tocar o conteúdo.

Player que muda o tempo enquanto arrasta

Se o seu player atualiza o tempo durante o arraste da barra, o Google recomenda entregar ao IMA um objeto próprio que informe o tempo certo.

Procurar regras de anúncio numa conta sem 360

As regras de anúncio de vídeo são só do Google Ad Manager 360 com contrato de vídeo avançado. Numa conta comum, essa opção não aparece.

Perguntas frequentes

Preciso cadastrar meus vídeos no Ad Manager?

Não. O Google diz que a ingestão de conteúdo não é obrigatória para mid-rolls com regras de anúncio. Sem ela, mande a duração (vid_d) e os pontos de parada (allcues) na tag.

O que é um cue point?

É uma marquinha num ponto do vídeo dizendo que ali pode entrar um intervalo. Na tag, os cue points vão em milissegundos, separados por vírgula, como 10000,20000.

Dá para ter mid-roll sem as regras de anúncio?

O Google diz que as regras de anúncio são necessárias para o Ad Manager devolver mid-rolls, e elas são um recurso do Ad Manager 360. A duração do vídeo (vid_d) também precisa ser enviada.

Quantos anúncios entram em cada intervalo?

Você decide no conjunto com Número máximo de anúncios. A opção Sem valor máximo só existe nos Conjuntos otimizados, que também deixam limitar a duração total do intervalo.

Biblioteca

Fonte oficial do Google

Tudo nesta página segue a documentação oficial do Google. Leia direto na fonte:

Seu site usa este formato do jeito certo?

A auditoria lê o site como um visitante, sem clicar em nada, e mostra o que corrigir.

Fazer uma auditoria