- Por que não estou retornando anúncios para todos os formatos?
- Como é um bom descriptionUrl?
- Por que recebo o erro "A resposta do anúncio não contém um tipo de anúncio válido"?
- Há uma tag de anúncio em vídeo do Ad Manager que eu possa usar para teste?
- Devo definir adSlotWidth e adSlotHeight com os mesmos valores que o sz na minha tag de anúncio do Ad Manager?
- A tag de anúncio de demonstração parece ótima, mas quando ela é trocada pela tag de anúncio, nenhum anúncio é exibido.
- Quero solicitar anúncios usando a mesma tag mais de uma vez, mas só recebo anúncios na minha primeira solicitação. Como resolvo esse problema?
- Como solicito anúncios de sobreposição do AdSense e de espaço inteiro usando o SDK do IMA?
- Recebo o erro "URL de clique inválido" quando clico no anúncio. Qual pode ser essa causa?
- Por que vejo o erro "O documento VAST está vazio"?
- Posso mudar o tamanho/texto da caixa "Pular anúncio" ou outros elementos de IU?
- Os controles de vídeo nativos são compatíveis com o SDK HTML5?
- Vejo a mensagem "Falha ao executar 'reproduzir' em 'HTMLMediaElement': a API só pode ser iniciada por um gesto de usuário" na minha implementação de HTML5. Como resolvo esse problema?
- Como lidar com o foco do teclado em cliques no anúncio?
- 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áginadescriptionUrl
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 umadescriptionUrl
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 apublisherId
de teste, você terá a certeza de que eles serão processados corretamente usando opublisherId
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
eadSlotHeight
com os mesmos valores desz
na minha tag de anúncio do Ad Manager? - Não necessariamente. A
adSlotWidth
e aadSlotHeight
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-valorsz
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:
- Chame
destroy()
na instânciaAdsManager
. Isso impedirá que os anúncios finais sejam reproduzidos quando você fizer a chamada abaixo paracontentComplete()
. Você receberá um novoAdsManager
ao fazer sua próxima solicitação. - Chame
contentComplete()
na instânciaAdsLoader
. Isso redefine o SDK para que a nova solicitação de anúncio não pareça uma cópia da anterior.
requestAds()
na instância deAdsLoader
para conseguir outro conjunto de anúncios para exibir no novo vídeo. - Chame
- 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- No
AdsRequest
, defina os ViewModes comoNORMAL
. - Na sua tag de anúncio, adicione o parâmetro
overlay=1
.
- No
AdsRequest
, defina os ViewModes comoFULLSCREEN
. - Na sua tag de anúncio, adicione o parâmetro
overlay=0
.
- No
- 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 chamarinitialize()
, o SDK retornará esse erro. Chameinitialize()
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 eventoCLICK
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. });