Guia de implementação

Vídeo post-roll

Post-roll video ads

Anúncio em vídeo que toca no mesmo player logo depois que o vídeo termina, como os comerciais do fim de um programa.

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 post-roll

Sabe quando o programa de TV acaba e, antes de começar o próximo, passam uns comerciais? O post-roll é isso no seu site: um anúncio em vídeo que toca no fim do vídeo, dentro do mesmo player. A pessoa já assistiu ao que queria e o anúncio aparece logo depois. Pre quer dizer antes, mid quer dizer meio e post quer dizer depois.

O segredo do post-roll é avisar o player que o vídeo acabou. O IMA SDK, que é o pacote de código do Google para colocar anúncios no player, não adivinha sozinho que o conteúdo terminou. O guia do Google diz assim: para o post-roll tocar, você precisa avisar o SDK quando o conteúdo acabou, e aí ele toca o intervalo do fim, se houver um programado. Esse aviso só deve ser dado quando o vídeo acaba, nunca quando um anúncio acaba, porque o IMA pode usar o mesmo player para os anúncios. É como tocar o sinal da escola só quando a aula termina, e não no meio do recreio.

Os intervalos podem ser organizados pelas regras de anúncio de vídeo, um recurso do Google Ad Manager 360. Nelas, o post-roll pode ser ligado (Ativar), desligado (Desativar) ou deixado para uma regra de menor prioridade decidir (Adiar). Com as regras, a resposta vem em VMAP, que é como a programação da TV, dizendo quais intervalos existem. Sem regras, o próprio player pode fazer o pedido no fim do vídeo e dizer na tag que é um post-roll.

Quando vale a pena? Quando você já tem vídeos no site e quer mais um momento para anúncio que não interrompe o começo nem o meio do conteúdo. As regras de qualquer anúncio In-stream continuam valendo: o espaço precisa ser declarado do jeito certo, os controles não podem ficar escondidos e só um player pode tocar sozinho visível por vez. E, quando todos os intervalos já tocaram, o IMA avisa com um evento próprio, que você pode usar para arrumar a página.

Passo a passo

Como implementar

Prepare o player com o IMAMonte o player com o IMA SDK como no pre-roll: script do IMA, caixa do anúncio por cima do vídeo, AdsLoader e AdsRequest com a sua tag.
Ligue o post-roll na regraNo Ad Manager 360, vá em Vídeo, Regras de anúncios, Nova regra de anúncio, escolha Padrão e marque os anúncios finais em vídeo como Ativar. Depois defina Número máximo de anúncios e Duração máxima do anúncio.
Ajuste a tagCom regras de anúncio, a tag leva ad_rule=1. Sem regras, o player faz o pedido no fim do vídeo e pode informar vpos=postroll, que diz que o pedido é de fim de vídeo.
Avise o fim do conteúdoEscute o fim do vídeo e chame o aviso de conteúdo completo do AdsLoader. Tire esse ouvinte quando um anúncio começar e coloque de volta quando o conteúdo voltar.
Finalize depois dos anúnciosO IMA avisa com o evento ALL_ADS_COMPLETED quando todos os intervalos já tocaram. Use esse aviso para limpar o player, se precisar.

Exemplo implementado

O código e como fica na tela

Vai junto do código do player com IMA: avisa o fim do vídeo para o post-roll tocar e cuida dos ouvintes enquanto os anúncios passam.

<script>
  var video = document.getElementById('conteudo');

  // Avisa o IMA que o CONTEÚDO acabou (nunca no fim de um anúncio)
  var contentEndedListener = function () { adsLoader.contentComplete(); };
  video.addEventListener('ended', contentEndedListener);

  adsLoader.addEventListener(
      google.ima.AdsManagerLoadedEvent.Type.ADS_MANAGER_LOADED,
      function (e) {
        adsManager = e.getAdsManager(video);

        adsManager.addEventListener(
            google.ima.AdEvent.Type.CONTENT_PAUSE_REQUESTED,
            function () {
              // anúncio vai tocar: tira o ouvinte de fim do vídeo
              video.removeEventListener('ended', contentEndedListener);
              video.pause();
            });

        adsManager.addEventListener(
            google.ima.AdEvent.Type.CONTENT_RESUME_REQUESTED,
            function () {
              // conteúdo volta: coloca o ouvinte de novo
              video.addEventListener('ended', contentEndedListener);
              if (!video.ended) { video.play(); }
            });

        adsManager.addEventListener(
            google.ima.AdEvent.Type.ALL_ADS_COMPLETED,
            function () { console.log('Todos os intervalos tocaram'); });
      });
</script>

No desktopQuando o vídeo chega ao fim, o anúncio toca no mesmo player. Depois do anúncio, o vídeo não recomeça sozinho.

No celularIgual ao computador: o anúncio toca no player do celular logo depois que o vídeo termina.

O que o Google orienta

Pode e não pode

Pode

Tocar um anúncio no fim do vídeo, dentro do mesmo player, usando o IMA SDK.
Ligar, desligar ou deixar para outra regra decidir o post-roll nas regras de anúncio de vídeo do Ad Manager 360.
Fazer o pedido no fim do vídeo sem regras de anúncio e informar na tag que é um post-roll.
Usar o evento de todos os anúncios completos para arrumar a página depois do último intervalo.

Não pode

Não pode avisar fim de conteúdo quando quem terminou foi um anúncio: o aviso é só para o fim do vídeo.
Não pode deixar os controles do vídeo e do anúncio cobertos, escondidos ou sem funcionar.
Não pode declarar o espaço errado: player com vídeo precisa ser In-stream ou Conteúdo complementar.
Não pode ter mais de um player tocando sozinho visível ao mesmo tempo.
Não pode usar os produtos IMA para ganhar dinheiro com vídeos do YouTube.

Dicas

Para fazer do jeito certo

Se esquecer de avisar o fim do conteúdo, o post-roll simplesmente não toca.
O exemplo do Google não avisa o fim do conteúdo se um anúncio estiver tocando naquele momento.
Quando o conteúdo volta depois de um anúncio, o exemplo do Google só manda tocar se o vídeo ainda não terminou.

Cuidado

Erros comuns

Não avisar o fim do vídeo

O Google diz que, para o post-roll tocar, o SDK precisa saber que o conteúdo acabou. Sem esse aviso, o intervalo do fim não acontece.

Avisar no fim de um anúncio

Se o ouvinte de fim de vídeo continuar ligado enquanto o anúncio toca no mesmo player, o aviso pode sair na hora errada. Tire o ouvinte na pausa e coloque de volta quando o conteúdo voltar.

Mandar tocar um vídeo que já acabou

Depois do post-roll, o IMA pede para retomar o conteúdo. Se o vídeo já terminou, não mande tocar de novo, senão ele pode recomeçar sem a pessoa pedir.

Perguntas frequentes

Por que meu post-roll não aparece?

Um motivo possível é não avisar o IMA que o vídeo acabou. O Google pede que o site avise o fim do conteúdo para o SDK tocar o intervalo do fim, se houver um programado.

Preciso das regras de anúncio para ter post-roll?

Não obrigatoriamente. Com regras (Ad Manager 360), o post-roll vem programado no VMAP. Sem regras, o player pode pedir o anúncio no fim do vídeo e informar vpos=postroll na tag.

O post-roll interrompe o vídeo?

Não. Ele toca depois que o conteúdo termina, no mesmo player.

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