Mostrar um anúncio intersticial de jogos H5

Este exemplo mostra um anúncio intersticial de jogos usando a biblioteca de Tag do editor do Google (GPT). Os intersticiais de jogos são anúncios de página inteira gerenciados pela GPT que você mostra aos usuários que jogam jogos na Web com base em um acionador manual. Para mais informações sobre intersticiais de jogos, consulte Mostrar um anúncio intersticial de jogos H5.

Para mostrar e interagir com anúncios intersticiais de jogos, use os seguintes eventos da GPT:

Evento Disparado quando…
GamingInterstitialSlotReady Um anúncio intersticial de jogos está pronto para ser mostrado ao usuário.

Para mostrar o intersticial, chame makeGameManualInterstitialVisible() no objeto de evento fornecido.
GamingInterstitialSlotClosed O usuário fechou um anúncio intersticial de jogos exibido anteriormente.

Use esse evento para executar uma lógica personalizada sempre que um anúncio intersticial de jogos for fechado.

Estruturas de jogos

Os anúncios intersticiais de jogos podem aparecer em tela cheia ou dentro do frame do jogo, dependendo de como ele é estruturado. Para mais detalhes, consulte Estruturas de jogos H5.

A implementação de exemplo pressupõe que o jogo H5 seja renderizado diretamente na janela superior, usando a estrutura tela cheia. Nesse cenário, o anúncio intersticial de jogos também é renderizado em tela cheia.

No entanto, esse mesmo código também funciona quando colocado dentro de um frame filho, usando a estrutura iFrame/WebView. Para restringir o anúncio intersticial de jogos à tela do jogo H5, coloque o jogo em um iFrame, conforme mostrado no exemplo a seguir:

<!doctype html>
<html>
  <head>
    <!-- The Google Publisher Tag here, if any, will only be responsible for serving ads outside of the H5 game. -->
    <title>Page for this example H5 game</title>
    <!-- Your <head> content here. -->
  </head>
  <body>
    <span id="example-text">Example H5 game</span>

    <!-- Sample code is served here. The Google Publisher Tag loaded in this frame will only be used within the H5 game. -->
    <iframe src="https://www.example.com" title="Example game" allow="autoplay"></iframe>
  </body>
</html>

Notas de uso

  • Para garantir uma experiência ideal do usuário, a GPT só solicita anúncios intersticiais de jogos em páginas que oferecem suporte adequado ao formato. Devido a essa restrição, defineOutOfPageSlot() pode retornar nulo. Você precisa verificar esse caso para garantir que não está fazendo um trabalho desnecessário.

  • Solicite anúncios intersticiais de jogos somente em páginas ou ambientes onde você quer que um intersticial apareça. Esse tipo de anúncio pode ser veiculado em computadores, tablets e dispositivos móveis.

  • Os anúncios intersticiais de jogos geram o próprio espaço do anúncio. Ao contrário de outros tipos de anúncios, não é necessário definir um <div> para anúncios intersticiais de jogos. Esses anúncios criam e inserem automaticamente o próprio contêiner na página quando um anúncio é preenchido.

  • Os anúncios intersticiais de jogos são de uso único. Não é possível atualizar um espaço de anúncio intersticial de jogos. Em vez disso, é necessário destruir e recriar o slot, conforme mostrado na implementação de exemplo.

  • Os anúncios intersticiais de jogos têm um limite de frequência fixo. O limite de frequência impede que o evento gamingInterstitialSlotReady seja acionado mais de uma vez a cada 120 segundos.

  • Se você usar a arquitetura de solicitação única (SRA, na sigla em inglês) em uma página com vários espaços, não chame display() até que os divs de espaços do anúncio estático sejam criados. Conforme explicado nas Práticas recomendadas de anúncios, a primeira chamada de display() solicita todos os espaços de anúncio definidos antes desse ponto. Embora os espaços intersticiais de jogos não exijam um <div> predefinido, os espaços de anúncios estáticos exigem. Chamar display() antes que esses elementos estejam presentes na página pode resultar em indicadores de qualidade mais baixos. Recomendamos atrasar a chamada inicial até que os slots estáticos sejam definidos.

Exemplo de implementação

Confira a demonstração