Corrija problemas com recursos HTML5 para campanhas de apps

Quando estiver a carregar recursos HTML5 no Google Ads, pode receber uma mensagem de erro. Na maior parte das situações, é possível corrigir o problema ao alterar o ficheiro e ao voltar a guardá-lo. Em seguida, pode tentar carregar o ficheiro novamente.

Em algumas situações, pode usar uma ferramenta como o HTML5 Validator do Google Ads, que lhe permite testar os seus recursos antes de os carregar para o Google Ads e verificar a existência de potenciais problemas.

Este artigo ajuda a resolver problemas específicos que possam surgir ao trabalhar com recursos HTML5 nas suas campanhas de apps. Saiba mais acerca dos anúncios em HTML5/jogáveis para campanhas de apps

Problemas de carregamento

O tamanho do ficheiro é demasiado grande

Os recursos HTML5 nas dimensões de anúncios intercalares (320 x 480 e 480 x 320) podem ter um tamanho de ficheiro até 5,2 MB. Os recursos maiores são rejeitados imediatamente, por isso, reduza o tamanho do ficheiro do recurso conforme necessário.

Nota: se o ficheiro estiver perto do limite de tamanho, por vezes, pode causar problemas. Reduzir um pouco o tamanho do ficheiro também deve ajudar.

As dimensões não são permitidas

Existem apenas 2 dimensões de recursos suportadas:

• 320 x 480 (vertical)
• 480 x 320 (horizontal)

Para corrigir o problema, altere as dimensões do recurso para as dimensões suportadas ou use a metatag "ad.orientation" e defina o valor de orientação correto em que o recurso deve ser renderizado.

Nota: pode optar por não usar a metatag "ad.size" e, em alternativa, usar a nova metatag "ad.orientation" para definir o valor de orientação pretendido do recurso:

• "portrait" (para recursos verticais)
• "landscape" (para recursos horizontais)
• "portrait,landscape" ou "landscape,portrait" (para recursos totalmente dinâmicos que funcionam em ambas as orientações)

Se continuar a usar a metatag "ad.size" e fornecer dimensões diferentes das suportadas, a mensagem de erro vai continuar a ser apresentada no momento do carregamento.

Se ambas as metatags forem declaradas em HTML, é usado o valor "ad.orientation".

Se não usar quaisquer metatags ou tiver definido incorretamente os valores de orientação, os recursos não são rejeitados no momento do carregamento, mas só são renderizados na orientação vertical.

O ficheiro seguinte está num caminho que contém um ou mais carateres que não suportamos. Remova todas as ocorrências destes carateres do nome do ficheiro, bem como de todos os diretórios e, em seguida, tente novamente.

Os nomes de ficheiros e pastas no ficheiro ZIP só podem conter carateres suportados, como letras, números, pontos finais ( . ), hífenes (-) e sublinhados (_). Se usar outros carateres não suportados nos nomes de ficheiros e pastas (incluindo espaços), poderá acionar um erro.

Para corrigir o problema, mude o nome das pastas e dos ficheiros para conterem carateres suportados, remova todas as instâncias de carateres não suportados do nome do ficheiro, bem como de todos os diretórios e, em seguida, tente novamente.

Os ficheiros afetados são apresentados na mensagem de erro em vez do parâmetro do caminho do ficheiro, ao passo que os carateres em violação são apresentados em vez do parâmetro do caminho dos carateres inválidos.

Nota: se os ficheiros com o nome mudado forem referenciados no código-fonte, também tem de os atualizar para que o ficheiro possa ser renderizado corretamente.

O ficheiro seguinte corresponde a um tipo não suportado. Deve remover ou substituir este ficheiro e, em seguida, tente novamente.

Atualmente, estes são os únicos tipos de ficheiros suportados em pacotes de anúncios em HTML5:

• .CSS
• .GIF
• .HTML
• .JPEG
• .JS
• .PNG
• .SVG

Se carregar outros tipos de ficheiros não suportados, como .MPEG ou .FLA, poderá acionar um erro. Para corrigir o problema, deve remover ou substituir o ficheiro e, em seguida, carregá-lo novamente.

O seu anúncio em HTML5 está a tentar fazer referência a um recurso externo ao ficheiro ZIP. Apenas são permitidas referências a ficheiros internas (por exemplo, "path/to/asset/in-zip.png"). Certifique-se de que incluiu todos os recursos no ficheiro ZIP e de que todas as referências a ficheiros são internas. Assim que fizer as alterações, tente novamente.

Quando carrega o pacote de anúncios em HTML5, as referências a ficheiros externas não são permitidas, exceto para o seguinte:

• createjs
• cssplugin
• easeljs
• easepack
• Google Fonts
• CreateJS alojada na Google
• Greensock alojada na Google (os ficheiros deverão funcionar independentemente da versão)
• jQuery alojada na Google
• timelinelite
• timelinemax
• tweenjs
• tweenlite
• tweenmax

Para corrigir o problema, certifique-se de que remove do seu pacote de anúncios em HTML5 todas as referências a ficheiros externas não permitidas. Depois de fazer as alterações, tente carregar novamente.

O seu anúncio em HTML5 está a tentar fazer referência a um recurso que não foi possível encontrar no ficheiro ZIP. Certifique-se de que incluiu todos os recursos no ficheiro ZIP e, em seguida, tente novamente.

Todos os recursos locais referenciados em todos os ficheiros têm de estar presentes no pacote. Se fizer referência a um caminho para uma imagem que não existe no pacote, o ficheiro será rejeitado.

Para corrigir o problema, certifique-se de que remove as referências a ficheiros que não existem no pacote ou adiciona os ficheiros referenciados ao pacote e, em seguida, carregue novamente.

O seu anúncio em HTML5 não tem um ficheiro HTML principal. Os ficheiros HTML principais incluem uma etiqueta de tamanho do anúncio, como <meta name="ad.size" content="width=320,height=480">. Certifique-se de que existe um ficheiro HTML com uma etiqueta de tamanho de anúncio no anúncio em HTML5 e, em seguida, tente novamente.

O recurso que mostra este erro não contém um dos parâmetros de metadados necessários em nenhum dos ficheiros HTML no pacote, como a etiqueta de tamanho do anúncio: <meta name="ad.size" content="width=320,height=480">. Isto não se aplica a recursos do Google Web Designer.

Para corrigir o problema, certifique-se de que o seu recurso HTML5 tem um ficheiro HTML principal com uma etiqueta de tamanho do anúncio incluída na secção <head> do código-fonte. Também deve adicionar todas as etiquetas obrigatórias ao código-fonte do recurso:

• A declaração <!DOCTYPE html>
• A etiqueta <html>
• A etiqueta <body>
• A metatag de orientação de formato de anúncio dentro da etiqueta <head>. Por exemplo, <meta name="ad.orientation" content="portrait">

Etiquetas inválidas como <path><path /> não serão aceites.

Para cumprir estes requisitos, pode ter de extrair etiquetas SVG inline para ficheiros separados.

Nota: embora tenha de especificar o tamanho, o recurso também tem de ser dinâmico, uma vez que será publicado em espaços de anúncios intercalares com uma faixa de tamanho variável. Para publicar anúncios intercalares de orientação horizontal, use "width=480,height=320".

O pacote multimédia contém demasiados ficheiros. Certifique-se de que o número de ficheiros no ficheiro ZIP é inferior ou igual a 512.

Para os tamanhos de anúncios intercalares, os recursos podem conter até 512 ficheiros no pacote multimédia. Os recursos com um número de ficheiros superior ao permitido serão rejeitados.

Para corrigir o problema, certifique-se de que o número de ficheiros no ficheiro ZIP é inferior ou igual a 512.

Nota: as pastas no pacote multimédia não aumentam o número geral de ficheiros no pacote.

Não é possível processar o ficheiro ZIP porque o ficheiro em si ou um dos ficheiros do pacote estava corrompido. Verifique os ficheiros, volte a comprimi-los e, em seguida, tente novamente.

Para corrigir o problema, verifique os ficheiros no pacote, volte a comprimir para se certificar de que o ficheiro resultante é um arquivo ZIP adequado e, em seguida, tente carregar novamente.

Funcionalidade de HTML5 não suportada no recurso HTML5

Este erro sugere que o código-fonte dos ficheiros no pacote tem algumas funcionalidades não suportadas pelo Google Ads.

Para corrigir este problema, remova as funcionalidades não suportadas do pacote de anúncios em HTML5. O HTML5 Validator do Google Ads pode ajudar a resolver esta questão.

Nota: na secção "Verificação de HTML5 avançada" do HTML5 Validator do Google Ads, poderá encontrar a seguinte mensagem de erro: UNSUPPORTED_HTML5_FEATURE: rdf:description

Se o problema estiver nas etiquetas SVG não suportadas, podem existir etiquetas no código de criativo que não estejam incluídas numa das categorias suportadas, tais como elementos de contentor, elementos de gradação e elementos gráficos.

Para corrigir este problema, verifique todos os ficheiros armazenados no ficheiro ZIP e pesquise etiquetas não suportadas no código de criativo e, em seguida, elimine-as. Pode ver a lista de todas as etiquetas SVG suportadas. Saiba mais acerca da lista de etiquetas SVG suportadas e respetivas categorias

Por exemplo, quando um ficheiro SVG de exemplo no pacote é aberto num editor de texto, a etiqueta "rdf:Description" pode ser apresentada. Quando essa etiqueta é removida de todos os ficheiros SVG, o pacote pode ser carregado.

O ficheiro ZIP do Google Web Designer não está publicado

Não é possível carregar ficheiros de origem comprimidos manualmente que ainda sejam editáveis no Google Web Designer depois de os descomprimir. Os recursos do Google Web Designer têm de ser publicados localmente antes de serem elegíveis para carregamento no Google Ads.

Para corrigir o problema, no Google Web Designer:

1. Clique em Publicar.
2. Selecione Publicar localmente.
3. Carregue o ficheiro ZIP resultante para o Google Ads.

O Google Web Designer não foi criado para o ambiente "Google Ads"

Os recursos do Google Web Designer têm de ter o "gwd-googleads" ou o "gwd-admob" especificados como o ambiente do anúncio na metatag "environment". No entanto, se o ambiente do anúncio for "gwd-genericad" ou "gwd-dv360", o anúncio será rejeitado. Isto não se aplica a recursos não pertencentes ao Google Web Designer.

Para corrigir o problema, abra o ficheiro de origem (não o recurso publicado) no Google Web Designer e altere o ambiente para "Google Ads". Saiba como selecionar o ambiente do anúncio

O pacote multimédia necessita do tipo de produto dinâmico com o vertical correto

Os seus recursos podem conter a seguinte linha no código-fonte sem incluir a etiqueta vertical do produto: <meta name="productType" content="dynamic">. Esta etiqueta é definida para o Remarketing Dinâmico para recursos HTML5 baseados em feeds.

Para corrigir o problema, remova manualmente a linha <meta name="productType" content="dynamic"> do código-fonte, uma vez que, neste momento, as campanhas de apps não suportam recursos HTML5 personalizados baseados em feeds.

O pacote multimédia não é compatível com o tipo de produto atual

O seu recurso pode estar a fazer referência à etiqueta <meta name="productType" content="dynamic">, mas, geralmente, os recursos HTML5 dinâmicos não são suportados em campanhas de apps.

Para corrigir o problema, remova <meta name="productType" content="dynamic"><meta name="vertical" content="{content_type}"> do código-fonte do ficheiro index.html.

Nota: podem existir valores diferentes no marcador de posição {content_type}, como RETAIL, CUSTOM, entre outros.

Não são suportados anúncios em HTML5 com ficheiros ZIP criados com o DoubleClick Studio

Em geral, os recursos criados no Studio (anteriormente denominado "DoubleClick Studio") não são compatíveis com o Google Ads. O sistema determina esta situação ao verificar a presença de uma referência da biblioteca JS específica do Studio denominada "Enabler". A biblioteca Enabler.js não é suportada e não pode ser usada para recursos personalizados não pertencentes ao Google Web Designer.

Nota: os ficheiros do Google Web Designer contêm a biblioteca Enabler.js por predefinição, que é totalmente suportada nos mesmos, mas não em pacotes HTML5 personalizados.

Para corrigir o problema, remova as referências à biblioteca Enabler.js do recurso HTML5 personalizado.

O comportamento de saída do anúncio está configurado incorretamente

Os criativos do Google Web Designer não suportam o ExitAPI. Para corrigir o problema, remova todas as referências ao ExitAPI e, em alternativa, use o componente da área de toque para atribuir a área clicável personalizada.

Problemas pós-carregamento

Os seus recursos HTML5 foram reprovados devido a "Outra chamada inválida", "Anúncio em HTML5 inaceitável" ou ambos.

Prevê-se que os recursos HTML5 com um dos seguintes elementos sejam reprovados devido a "Outra chamada inválida" ou "Anúncio em HTML5 inaceitável":

• Etiqueta <video> sem o atributo src
• Referências externas não detetadas
• Os tipos de letra externos à Google que estejam incorporados diretamente no ficheiro e não sejam referenciados a partir do domínio fonts.googleapis.com vão resultar na reprovação, exceto os tipos de letra nos formatos apresentados abaixo:
  • .dfont
  • .eot
  • .otf
  • .tte
  • .ttf
  • .woff
  • .woff2
    • Nota: pode verificar a lista de todos os tipos de letra suportados no Google Fonts.
• Recursos incorporados em frames secundários
  • Procure etiquetas como <frameset>, <frame> ou <iframe> no código-fonte. Os frames permitem-lhe incorporar conteúdo externo e mesmo Websites completos num ficheiro HTML, mas não são suportados em recursos HTML5.
• Criativos do Google Web Designer e em HTML com AMP
  • Procure etiquetas que comecem pelo prefixo "amp", como <amp-img> ou <amp-ad-exit>, no código-fonte. Também pode encontrar referências a scripts alojados em cdn.ampproject.org.

Além disso, pode verificar se o seu recurso está a fazer outras chamadas específicas através do separador "Rede" nas Ferramentas para programadores do Chrome. Como aceder:

1. Clique com o botão direito do rato na pré-visualização do recurso no Google Ads ou no HTML5 Validator do Google Ads.
2. Selecione "Inspecionar" no menu de contexto.
3. Clique no separador Rede.

Para corrigir o problema, reveja os seus recursos, procure elementos e etiquetas não suportados com o HTML5 Validator do Google Ads e faça as edições necessárias. Em seguida, tente carregar novamente. Também pode saber mais acerca dos requisitos técnicos do tópico "Anúncio em HTML5 inaceitável".

Não é possível carregar a pré-visualização do anúncio

Não se prevê que a pré-visualização do anúncio seja carregada se o recurso carregado usar um recurso que viola a Política de Segurança de Conteúdos.

Para corrigir o problema, pode verificar o que o navegador está a comunicar sobre o seu recurso (se o navegador está a rejeitar intencionalmente alguns recursos no anúncio em HTML5) através do separador "Consola" nas Ferramentas para programadores do Chrome. Como aceder:

1. Clique com o botão direito do rato na pré-visualização do recurso no Google Ads ou no HTML5 Validator do Google Ads.
2. Selecione "Inspecionar" no menu de contexto.
3. Clique no separador Consola.

Renderização incorreta da pré-visualização do anúncio

As renderizações incorretas da pré-visualização do anúncio podem dever-se a determinados recursos que usam a biblioteca PixiJS (ou outras bibliotecas externas), que podem não funcionar corretamente num sandbox.

Para corrigir o problema, certifique-se de que os seus recursos HTML5 são criados para funcionar num iFrame em sandbox apenas com a sinalização "allow-scripts".

Nota: uma vez que os anúncios em HTML5 são executados em sandbox sem Permitir a mesma origem, as imagens têm de ser carregadas com crossorigin="anonymous" para serem usadas numa tela.

Recurso não clicável na pré-visualização

Prevê-se que o serviço de pré-visualização do anúncio bloqueie a funcionalidade de clique de navegação, o que significa que deve poder interagir com o recurso, mas não clicar para sair do mesmo e ir para o URL final.

Para corrigir o problema, pode testar a funcionalidade de clique quando carrega o seu recurso no HTML5 Validator do Google Ads.

O recurso HTML5 não está a ser publicado

Se o seu recurso HTML5 não estiver a ser publicado (nenhuma impressão), consulte este artigo do Centro de Ajuda para saber como corrigir campanhas de apps do Google Ads que não estão a ser apresentadas ou têm pouco tráfego.

Taxa de cliques (CTR) elevada com taxa de conversão (CVR) baixa

Uma solução possível que poderá corrigir o problema é o facto de o script ExitAPI ter de ser incluído como uma etiqueta <script> literal no <head> e não adicionado através de outro JavaScript. Caso contrário, os criativos de publicação em direto serão totalmente clicáveis em toda a área do anúncio, o que pode gerar um grande número de cliques não intencionais e resultar num fraco desempenho.