Este artigo inclui notas e exemplos que demonstram como apresentar um anúncio intercalar de jogos H5 através da biblioteca da Etiqueta do Publicador Google (GPT). Os anúncios intercalares de videojogos são anúncios de página inteira geridos pela GPT que são tornados visíveis para os utilizadores através de um acionador manual em jogos executados em páginas Web.
Os eventos da GPT seguintes são usados para apresentar e interagir com anúncios intercalares de jogos:
| Evento | Acionado quando… |
|---|---|
|
|
Um espaço de anúncio intercalar de videojogos está pronto para ser apresentado. Para apresentar o anúncio intercalar, chame |
|
|
Um espaço de anúncio intercalar de videojogos que estava a ser apresentado está agora fechado. Usado para executar lógica personalizada sempre que o anúncio intercalar de videojogos é fechado. |
O anúncio intercalar de videojogos pode ser renderizado em ecrã inteiro ou dentro do frame do jogo, consoante a forma como o jogo é apresentado. Saiba mais acerca das estruturas dos Anúncios para Jogos H5.
O exemplo de código seguinte pressupõe que o jogo H5 esteja posicionado diretamente no mesmo frame superior que a página (através da estrutura "Ecrã inteiro"). Se for esse o caso, o anúncio intercalar de videojogos também é renderizado em ecrã inteiro.
No entanto, este mesmo código também funciona quando posicionado dentro de um frame secundário (através da estrutura "iFrame/WebView"). Para restringir o anúncio intercalar de jogos à tela do jogo H5, este tem de ser posicionado num iFrame.
Exemplo
<!doctype html>
<html>
<head>
<!-- A Etiqueta do Publicador Google aqui, se existir, apenas é responsável por publicar anúncios fora do jogo H5. -->
<title>Página deste exemplo de jogo H5</title>
<!-- O seu conteúdo <head> aqui. -->
</head>
<body>
<span id="example-text">Jogo H5 de exemplo</span>
<iframe src="https://www.example-game.com" title="Jogo de exemplo allow="autoplay">
<!-- O exemplo de código é apresentado aqui. A Etiqueta do Publicador Google carregada neste frame apenas é usada no jogo H5. -->
</iframe>
</body>
</html>
Notas de utilização
- Para garantir uma experiência do utilizador ideal, a GPT apenas pede anúncios intercalares de jogos em páginas que suportem corretamente o formato. Por este motivo,
defineOutOfPageSlot()pode devolver um valor nulo. Peça anúncios intercalares de videojogos apenas em páginas ou ambientes onde quer que um anúncio intercalar seja apresentado. Os anúncios intercalares de videojogos são elegíveis para publicação em computadores, tablets e dispositivos móveis. - O anúncio intercalar é apresentado quando chamar
makeGameManualInterstitialVisiblea partir doGameManualInterstitialSlotReady event. - Os anúncios intercalares de jogos têm um limite de frequência fixo. Isto impede que o evento
gameManualInterstitialSlotReadyseja acionado mais do que uma vez a cada 120 segundos.
Requisitos e recomendações
- Os publicadores não podem usar anúncios intercalares de videojogos H5 em inventário não relacionado com jogos. Ao implementar este formato, os publicadores aceitam automaticamente esta condição. Também deve aceitar as Políticas para Publicadores Google e as Diretrizes para parceiros do Google Ad Manager.
- A Google reserva-se o direito de aprovar ou reprovar publicadores em qualquer altura e, posteriormente, os publicadores que violarem as políticas são removidos da lista de autorizações.
- Os anúncios intercalares de videojogos geram o seu próprio espaço de anúncio. Ao contrário de outros tipos de anúncios, não é necessário definir um elemento <div> para anúncios intercalares de videojogos. Estes anúncios criam e inserem automaticamente o respetivo contentor na página quando um anúncio é preenchido.
- Se estiver a usar a arquitetura de pedido único (SRA) numa página com vários espaços, não chame
display()até que sejam criados divs de espaços de anúncios estáticos. Conforme explicado nas Práticas recomendadas do Google Ads, a primeira chamada dedisplay()pede todos os espaços de anúncios definidos antes desse ponto. Embora os espaços de anúncios intercalares manuais de jogos não requeiram um <div> predefinido, os espaços de anúncios estáticos fazem-no. Chamardisplay()antes de estes elementos estarem presentes na página pode resultar em sinais de menor qualidade, por isso, recomendamos que atrase a chamada inicial até depois de os espaços estáticos serem definidos. - A gestão do tráfego de anúncios intercalares manuais requer a mesma configuração de bloco de anúncios e elemento publicitário que os anúncios intercalares da Web padrão.
Como começar
- Etiquetagem
- Crie um espaço da GPT com
googletag.defineOutOfPageSlot()e defina o formato OutOfPage paragoogletag.defineOutOfPageSlot().
Consulte as orientações técnicas para programadores da GPT para anúncios intercalares de videojogos H5. - Assim que o espaço estiver definido, adicione um ouvinte de evento que ouça o evento
gameManualInterstitialSlotReady. Na chamada de resposta do ouvinte de evento, chame o métodomakeGameManualInterstitialVisible()no objeto de evento indicado para apresentar o anúncio. - Depois de declarar todos os outros espaços de anúncios estáticos, uma chamada para
googletag.displayaciona um pedido para preencher o espaço de anúncios intercalares de videojogos.
- Crie um espaço da GPT com
Exemplo
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Game Manual Interstitial Ad Example</title>
<script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>
<script>
window.googletag = window.googletag || { cmd: [] };
let gameManualInterstitialSlot;
googletag.cmd.push(function () {
// Define a game manual interstitial ad slot.
defineGameManualInterstitialSlot();
// Define static ad slots.
staticSlot = googletag.defineSlot(
'/6355419/Travel/Europe', [100, 100], 'static-ad-1')
.addService(googletag.pubads());
// Enable SRA and services.
googletag.pubads().enableSingleRequest();
googletag.enableServices();
});
function defineGameManualInterstitialSlot() {
gameManualInterstitialSlot = googletag.defineOutOfPageSlot(
'/6355419/Travel/Europe/France/Paris',
googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL);
// Slot returns null if the page or device does not support interstitials.
if (gameManualInterstitialSlot) {
gameManualInterstitialSlot.addService(googletag.pubads());
printStatus('Waiting for interstitial to be ready...');
// Add event listener to register click handler once interstitial loads.
// If this event doesn't fire, try clearing local storage and refreshing
// the page.
googletag.pubads().addEventListener('gameManualInterstitialSlotReady',
(slotReadyEvent) => {
if (gameManualInterstitialSlot === slotReadyEvent.slot) {
printStatus('Interstitial is ready.');
const button = document.getElementById('trigger');
button.style.display = 'block';
button.addEventListener('click', () => {
slotReadyEvent.makeGameManualInterstitialVisible();
printStatus('Interstitial is active.');
}, { once: true });
}
});
googletag.pubads().addEventListener('gameManualInterstitialSlotClosed',
resumeGame);
}
}
function resumeGame() {
document.getElementById('trigger').style.display = 'none';
// Game manual interstitial ad slots are one-time use, so destroy the old slot and create a new one.
googletag.destroySlots([gameManualInterstitialSlot]);
defineGameManualInterstitialSlot();
googletag.display(gameManualInterstitialSlot);
}
function printStatus(status) {
document.getElementById('status').innerText = status;
}
</script>
<style>
button {
display: none;
}
div.content {
position: fixed;
top: 50%;
}
</style>
</head>
<body>
<div id="static-ad-1" style="width: 100px; height: 100px;"></div>
<div class="content">
<span id="status">Game manual interstitial is not supported on this page.</span>
<p>
<button id="trigger">TRIGGER INTERSTITIAL</button>
</p>
</div>
<script>
googletag.cmd.push(function () {
// Ensure the first call to display comes after static ad slot
// divs are defined.
googletag.display(staticSlot);
});
</script>
</body>
</html>
Tráfego
- Crie um novo bloco de anúncios ou volte a usar um existente. Selecione 320 x 480, 300 x 250 e 336 x 280 como o tamanho do bloco de anúncios.
- Crie elementos publicitários. Selecione as definições do elemento publicitário adequadas com base no seu exemplo de utilização:
| Definições do item de linha | ||||
|---|---|---|---|---|
| Exemplo de utilização | Tipo de anúncio | Tipo de elemento publicitário | Criativos esperados | Segmentação > Inventário |
| Para publicar um anúncio de display por reserva | Rede de Display |
|
320 x 480, 300 x 250 ou 336 x 280 |
O bloco de anúncios criado ou selecionado no passo anterior |
| Para publicar um anúncio não reservado | Rede de Display |
|
||
| Para publicar um anúncio de vídeo de reserva (por exemplo, uma etiqueta VAST ou um MP4) | Vídeo ou áudio |
|
300 x 250 v ou 320 x 480 v | |
| Para publicar anúncios de repreenchimento/leilão aberto | Rede de Display | Ad Exchange | Todos os tamanhos solicitados | |