Perguntas frequentes sobre o SDK do Interactive Media Ads do Google

Por que não estou recebendo de volta anúncios de todos os formatos?
As tags de anúncio de teste são configuradas para sempre retornar anúncios de solicitações válidas. Isso facilita a integração e facilita o teste de como seu player solicita e renderiza anúncios. No entanto, os anúncios nem sempre estão disponíveis em todos os formatos para seu site, conta ou bloco de anúncios. Se a integração estiver funcionando corretamente para a tag de teste, mas não para sua própria tag, o motivo pode ser um dos seguintes:
  • Você está veiculando vídeos em um formato não compatível no seu ambiente. Por exemplo, apenas anúncios HTML5 serão veiculados no iOS ou no Android.
  • Se você está usando o Ad Manager, talvez seu ID de editor não tenha anúncios segmentados para ele no momento. Além disso, é preciso aprovar os anúncios e criativos relevantes no Ad Manager.
  • Se você estiver usando o Google AdSense, é possível que os critérios de segmentação do site ou da página de teste não tenham anúncios ativos. A causa mais comum é o uso de sites particulares não rastreados.
  • Se você estiver usando o Gerenciamento de parceiros de rede do Ad Exchange e descriptionURL não estiver definido ou não estiver na lista de gerenciamento de domínios pertencentes ou operados, os anúncios não serão veiculados.
  • Confira os limites de minCPM definidos no Ad Exchange para vídeos. Um CPM razoavelmente alto pode resultar em taxas de preenchimento muito baixas. Para corrigir isso, tente remover o minCPM ou o parâmetro do bloco de anúncios da solicitação de anúncio (ou seja, slotname) para verificar se isso está afetando a taxa de preenchimento.
Como é um bom descriptionUrl?
Para ser mais eficaz, o conteúdo da página apontada por descriptionUrl não deve ser um conjunto de palavras ou frases, mas de um a três parágrafos que descrevem o conteúdo e seu papel ao fornecê-lo. Um método que tem sido bem-sucedido no passado foi unir o conteúdo da página descriptionUrl dinamicamente dos blocos predefinidos. Por exemplo, algumas frases sobre o conteúdo, algumas sobre a oferta do site e alguns snippets predefinidos associados a cada canal do Google AdSense (como "Entretenimento" ou "Esportes"). Como resultado, cada conteúdo tem uma descriptionUrl razoavelmente diferente associada a ele, que fornece informações gerais (como descritores de gênero) e informações específicas (conteúdo sobre o conteúdo diretamente).

Esse HTML de metadados deve ser simples, por exemplo:

<html>
  <head>
    <title>Domain.com - Your tag line here!</title>
  </head>
  <body>
    <h1>Descriptions</h1>
    <h2>About this Content</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
    <h2>About Domain.com</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
  </body>
</html>
Por que recebo o erro "A resposta do anúncio não contém um tipo de anúncio válido"?
Esse erro geralmente aparece porque nenhum anúncio foi segmentado para o publisherId específico durante o período especificado. Essa condição pode variar ao longo do dia ou durante vários dias, conforme as campanhas começam e terminam. Verifique se o anúncio que você quer segmentar não expirou e se os critérios de segmentação estão corretos. Se os anúncios forem solicitados, recebidos e renderizados corretamente usando a publisherId de teste, você terá a certeza de que eles serão processados corretamente usando o publisherId ativo quando os anúncios estiverem disponíveis.
Vocês têm uma tag de anúncio em vídeo do Ad Manager que eu possa usar para teste?
As tags de amostra estão disponíveis na página Tags de exemplo.
Devo definir adSlotWidth e adSlotHeight com os mesmos valores de sz na minha tag de anúncio do Ad Manager?
Não necessariamente. A adSlotWidth e a adSlotHeight precisam ser definidas como a largura/altura do player ou da área que você quer que os anúncios preencham. Elas são usadas pelo Google AdSense para determinar quais anúncios estão disponíveis para caber nesse espaço. O par de chave-valor sz na tag de anúncio do Ad Manager é um parâmetro de segmentação e não afeta necessariamente o criativo veiculado. Veja mais informações abaixo.
A tag de anúncio de demonstração parece excelente, mas quando eu a troco por minha tag de anúncio, não aparece nenhum anúncio.
Verifique se algo é programado para a tag de anúncio que você está solicitando. A maneira mais fácil de descobrir é observar o tráfego HTTP. Se uma imagem grey.gif de 1 x 1 pixel for retornada em um bloco de âncora HTML, será necessário verificar a segmentação no Ad Manager.
Quero solicitar anúncios usando a mesma tag mais de uma vez, mas só recebo anúncios para minha primeira solicitação. Como resolvo esse problema?
Ao solicitar anúncios mais de uma vez, é necessário informar ao servidor que essas solicitações são legítimas, e não duplicadas. O SDK faz isso para você com duas chamadas rápidas de API:
  1. Chame destroy() na instância AdsManager. Isso impedirá que os anúncios finais sejam reproduzidos quando você fizer a chamada abaixo para contentComplete(). Você receberá um novo AdsManager ao fazer sua próxima solicitação.
  2. Chame contentComplete() na instância AdsLoader. Isso redefine o SDK para que a nova solicitação de anúncio não pareça uma cópia da anterior.
Depois de fazer as duas chamadas acima, você pode chamar requestAds() na instância de AdsLoader para conseguir outro conjunto de anúncios para exibir no novo vídeo.
Como solicito anúncios de sobreposição e de espaço completo do AdSense usando o SDK do IMA?

Para solicitar anúncios do Google AdSense usando o SDK, primeiro você precisa conseguir uma tag de anúncio do Google AdSense. Saiba mais sobre isso na página do AdSense para vídeos. Depois de criar sua tag, siga estas etapas para criar uma solicitação de sobreposição ou de anúncio de espaço completo:

Anúncios overlay
  1. No AdsRequest, defina os ViewModes como NORMAL.
  2. Na sua tag de anúncio, adicione o parâmetro overlay=1.
Anúncios de espaço inteiro
  1. No AdsRequest, defina os ViewModes como FULLSCREEN.
  2. Na sua tag de anúncio, adicione o parâmetro overlay=0.
O erro "URL de clique inválido" é exibido quando clico em meu anúncio. Qual pode ser essa causa?
A causa mais comum desse erro é um URL de clique com escape incorreto. Se você encontrar esse erro, verifique se o URL de clique tem escape correto na resposta VAST.
Por que vejo o erro "Documento vazio vazio"?
Esse erro ocorre quando a tag de anúncio retorna um documento VAST vazio, indicando que o anúncio não foi veiculado corretamente. Fale com seu gerente de contas ou representante do servidor de anúncios para saber por que sua tag de anúncio não está funcionando.
Posso mudar o tamanho/texto da caixa Pular anúncio ou outros elementos de IU?
Os SDKs do IMA não são compatíveis com a mudança de layout, tamanho ou conteúdo dos elementos da IU. Para ver mais detalhes sobre elementos da IU, consulte AdsManager.uiElements.
Os controles de vídeo nativos são compatíveis com o SDK HTML5?
Não, o SDK de HTML5 não é compatível com controles nativos.
A mensagem "Failed to execute 'play" em "HTMLMediaElement": a API só pode ser iniciada por um gesto do usuário" na minha implementação HTML5. Como resolvo esse problema?
Em dispositivos móveis, chame adDisplayContainer.initialize() como resultado de uma ação do usuário, como um toque. Se você encontrar esse erro, é provável que você o chame em um contexto não iniciado pelo usuário. Ela precisa ser o resultado direto de uma ação do usuário. Por exemplo, se você responder a um evento de toque ao reproduzir um vídeo e usar o evento de reprodução do player de vídeo para chamar initialize(), o SDK retornará esse erro. Chame initialize() como resultado do evento de toque em si.
Como lidar com o foco do teclado em cliques em anúncios?
Se você usar os controles de teclado do seu player, talvez eles não funcionem mais depois de cliques na adDisplayContainer. Isso ocorre porque, depois de clicar em um anúncio, o foco do teclado é alterado para o iframe do IMA. Para manter o foco do teclado no player de conteúdo, use o evento CLICK para transferir o foco do teclado de volta ao contêiner desejado. Consulte o snippet de código a seguir para ver mais detalhes: 
adsManager.addEventListener(
      google.ima.AdEvent.Type.CLICK,
      function(){
        window.focus();
        // Or another method to return focus to the desired container.
      });