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.
Nos SDKs do Android e do iOS, existe uma forma de tornar todo o anúncio em vídeo clicável?
No que diz respeito ao rastreamento de cliques de vídeos inteiros, a experiência padrão dos espectadores para vídeos em dispositivos móveis é que, ao tocar em um vídeo, ele o pausa ou exibe os controles do player. Para evitar que os usuários cliquem inadvertidamente em anúncios quando realmente querem ter acesso aos controles do player, o botão Saiba mais permite que o usuário clique em um anúncio e saiba mais sobre o produto anunciado.
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.
Por que estou recebendo erros de "Nenhum método virtual" no momento da execução?

As mensagens de erro semelhantes às seguintes são causadas pelo uso de uma versão mais antiga do Google Play Services que não inclui o ID de publicidade.

No virtual method
getInfo()Lcom/google/android/gms/ads/identifier/AdvertisingIdClient$Info; in
class Lcom/google/android/gms/ads/identifier/AdvertisingIdClient; or its
super classes (declaration of 'com.google.android.gms.ads.identifier.AdvertisingIdClient'

Fazer upgrade para a versão 4.0 ou posterior (de preferência, a mais recente) resolve esse problema.

Posso usar várias linhas de execução para inicializar e manipular a IU?
Não, toda a inicialização e manipulação da IU precisam ser feitas na linha de execução principal. No Android, os objetos de IU não são thread-safe. Consulte Linhas de execução para mais informações.