In dit artikel vindt u opmerkingen en voorbeelden van hoe u een H5-game-interstitial-advertentie toont met de bibliotheek voor de Google-uitgeverstag (GPT). Game-interstitials zijn door GPT beheerde advertenties op volledige paginagrootte die zichtbaar worden gemaakt voor gebruikers via een handmatige trigger in games die worden uitgevoerd op webpagina's.
De volgende GPT-gebeurtenissen worden gebruikt om game-interstitial-advertenties te tonen en ermee te communiceren:
| Gebeurtenis | Wordt geactiveerd als... |
|---|---|
|
|
Een game-interstitial-advertentieruimte is klaar om te worden getoond. Als u de interstitial wilt tonen, roept u |
|
|
Een game-interstitial-advertentieruimte die werd getoond, is nu gesloten. Wordt gebruikt om aangepaste logica uit te voeren als de game-interstitial wordt gesloten. |
De game-interstitial kan op volledig scherm of in het gameframe worden gerenderd, afhankelijk van hoe de game wordt getoond. Meer informatie over structuren van advertenties voor H5-games
In de volgende voorbeeldcode wordt ervan uitgegaan dat de H5-game rechtstreeks in hetzelfde bovenste frame als de pagina wordt geplaatst (met de structuur Volledig scherm). Als dat het geval is, wordt de interstitial-advertentie voor games ook op volledig scherm weergegeven.
Dezelfde code werkt ook als deze in een onderliggend frame wordt geplaatst (met de structuur iFrame/WebView). Als u de game-interstitial-advertentie wilt beperken tot het H5-gamecanvas, moet u de game in een iframe plaatsen.
Voorbeeld
<!doctype html>
<html>
<head>
<!-- Deze Google-uitgeverstag, indien van toepassing, is alleen verantwoordelijk voor de weergave van advertenties buiten de H5-game. -->
<title>Pagina voor deze voorbeeld H5-game</title>
<!-- Uw <head>-content hier. -->
</head>
<body>
<span id="example-text">Voorbeeld H5-game</span>
<iframe src="https://www.example-game.com" title="Voorbeeldgame" toestemming="autoplay">
<!-- Voorbeeldcode wordt hier weergegeven. De Google-uitgeverstag die in dit frame is geladen, wordt alleen gebruikt in de H5-game. -->
</iframe>
</body>
</html>
Opmerkingen voor gebruik
- GPT vraagt alleen interstitial-advertenties voor games aan op pagina's die de indeling correct ondersteunen om een optimale gebruikerservaring te garanderen. Hierdoor kan
defineOutOfPageSlot()null retourneren. Vraag alleen game-interstitial-advertenties aan op pagina's of in omgevingen waar u een interstitial wilt tonen. Interstitial-advertenties voor games komen in aanmerking voor weergave op desktops, tablets en mobiele apparaten. - De interstitial wordt weergegeven als u
makeGameManualInterstitialVisibleaanroept via de gebeurtenismakeGameManualInterstitialVisible. - Handmatige interstitial-advertenties voor games hebben een vaste frequentielimiet. Hiermee wordt voorkomen dat de gebeurtenis
gameManualInterstitialSlotReadymeer dan 1 keer per 120 seconden wordt geactiveerd.
Vereisten en aanbevelingen
- Uitgevers mogen geen H5-game-interstitials gebruiken voor niet-gamevoorraad. Door deze indeling te implementeren, gaan uitgevers automatisch akkoord met deze voorwaarde. U moet ook voldoen aan het Google-beleid voor uitgevers en de Partnerrichtlijnen van Google Ad Manager.
- Google behoudt zich het recht voor om op elk moment uitgevers goed te keuren of te weigeren. Uitgevers die het beleid schenden, worden daarna van de toelatingslijst verwijderd.
- Game-interstitial-advertenties genereren hun eigen advertentieruimte. In tegenstelling tot andere advertentietypen is het niet nodig om een <div>-element te definiëren voor game-interstitial-advertenties. Deze advertenties maken automatisch een eigen container en voegen deze in op de pagina als een advertentie wordt gevuld.
- Als u Single Request Architecture (SRA) gebruikt op een pagina met meerdere advertentieruimten, moet u
display()pas aanroepen nadat er statische div-elementen voor advertentieruimten zijn gemaakt. Zoals uitgelegd in de best practices voor advertenties, wordt bij de eerste aanroep vandisplay()elke advertentieruimte opgevraagd die vóór dat punt is gedefinieerd. Hoewel er voor interstitial-ruimten voor games geen vooraf gedefinieerde <div> is vereist, is dat wel het geval voor statische advertentieruimtes. Als udisplay()aanroept voordat deze elementen op de pagina aanwezig zijn, kan dit leiden tot signalen van lagere kwaliteit. We raden u daarom aan de eerste aanroep uit te stellen totdat er statische ruimtes zijn gedefinieerd. - Voor trafficking van handmatige interstitials moet u dezelfde instellingen voor advertentieblokken en regelitems gebruiken als voor standaard webinterstitials.
Aan de slag
- Taggen
- Maak een GPT-ruimte met
googletag.defineOutOfPageSlot()en stel de indeling buiten de pagina in opgoogletag.defineOutOfPageSlot().
Bekijk de GPT-richtlijnen voor technische ontwikkelaars voor H5-game-interstitials. - Nadat de advertentieruimte is gedefinieerd, voegt u een event-listener toe die luistert naar de gebeurtenis
gameManualInterstitialSlotReady. Roep in de callback van de event-listener de methodemakeGameManualInterstitialVisible()aan voor het verstrekte gebeurtenisobject om de advertentie te tonen. - Nadat u alle andere statische advertentieruimtes heeft gedefinieerd, activeert een aanroep naar
googletag.displayeen verzoek om de game-interstitial-advertentieruimte te vullen.
- Maak een GPT-ruimte met
Voorbeeld
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Voorbeeld van handmatige interstitial-advertentie voor games</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 () {
// Definieer een handmatige game-interstitial-advertentieruimte.
defineGameManualInterstitialSlot();
// Definieer statische advertentieruimtes.
staticSlot = googletag.defineSlot(
'/6355419/Travel/Europe', [100, 100], 'static-ad-1')
.addService(googletag.pubads());
// SRA en services aanzetten.
googletag.pubads().enableSingleRequest();
googletag.enableServices();
});
function defineGameManualInterstitialSlot() {
gameManualInterstitialSlot = googletag.defineOutOfPageSlot(
'/6355419/Travel/Europe/France/Paris',
googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL);
// Ruimte retourneert null als de pagina of het apparaat geen interstitials ondersteunt.
if (gameManualInterstitialSlot) {
gameManualInterstitialSlot.addService(googletag.pubads());
printStatus('Wachten tot interstitial klaar is...');
// Voeg event-listener toe om de klikhandler te registreren nadat de interstitial is geladen.
// Als deze gebeurtenis niet wordt geactiveerd, probeer dan de lokale opslag te wissen en te vernieuwen
// de pagina.
googletag.pubads().addEventListener('gameManualInterstitialSlotReady',
(slotReadyEvent) => {
if (gameManualInterstitialSlot === slotReadyEvent.slot) {
printStatus('Interstitial is klaar.');
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';
// Handmatige interstitial-advertentieruimtes voor games worden eenmalig gebruikt, dus vernietig de dus vernietig de oude ruimte en maak een nieuwe.
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">Handmatige interstitial voor game wordt niet ondersteund op deze pagina.</span>
<p>
<button id="trigger">TRIGGER INTERSTITIAL</button>
</p>
</div>
<script>
googletag.cmd.push(function () {
// Zorg ervoor dat de eerste aanroep naar display volgt na de statische advertentieruimte
// divs zijn gedefinieerd.
googletag.display(staticSlot);
});
</script>
</body>
</html>
Trafficking
- Maak een nieuw advertentieblok of gebruik een bestaand advertentieblok opnieuw. Selecteer 320 x 480, 300 x 250 en 336 x 280 als het formaat van het advertentieblok.
- Maak regelitems. Selecteer de juiste regeliteminstellingen op basis van uw toepassing:
| Regeliteminstellingen | ||||
|---|---|---|---|---|
| Toepassing | Advertentietype | Regelitemtype | Verwachte advertentiemateriaalitems | Targeting > Voorraad |
| Een display-reserveringsadvertentie weergeven | Display |
|
320 x 480, 300 x 250 of 336 x 280 |
Het advertentieblok dat u in de vorige stap heeft gemaakt of geselecteerd |
| Een niet-gereserveerde advertentie weergeven | Display |
|
||
| Een gereserveerde videoadvertentie weergeven (bijvoorbeeld een VAST-tag of een MP4) | Video of audio |
|
300 x 250v of 320 x 480v | |
| Advertenties voor aanvulling/open veiling weergeven | Display | Ad Exchange | Alle gevraagde formaten | |
