Ez a cikk megjegyzéseket és példákat tartalmaz arra vonatkozóan, hogyan lehet játékon belüli manuális közbeiktatott hirdetéseket megjeleníteni a Google megjelenítői címke (GPT) könyvtárának használatával. A játékokon belüli manuális közbeiktatott hirdetések olyan, a GPT által kezelt, teljes oldalas hirdetések, amelyek manuális aktiválással jelennek meg a felhasználók számára.
A következő GPT-események használhatók a közbeiktatott hirdetések megjelenítésére és a velük való interakcióra:
| Esemény | Akkor aktiválódik, amikor... |
|---|---|
|
|
Egy játékon belüli manuális közbeiktatott hirdetési helye készen áll a megjelenítésre. A közbeiktatott hirdetés megjelenítéséhez hívja meg a |
A játékon belüli manuális közbeiktatott hirdetés megjelenhet teljes képernyős módban vagy a játék keretén belül is, a játék megjelenítési módjától függően. További információ a H5-játékon belüli hirdetések szerkezetéről.
Az alábbi mintakód azt feltételezi, hogy a H5-játék közvetlenül ugyanarra a felső keretre van elhelyezve, mint az oldal (a „Teljes képernyős” szerkezet használatával). Ebben az esetben a manuális közbeiktatott hirdetés is teljes képernyős módban jelenik meg.
Azonban ugyanez a kód akkor is működik, ha alárendelt kereten belül helyezi el (az „iFrame/WebView” struktúra használatával). Ahhoz, hogy a manuális közbeiktatott hirdetés a H5-játék vásznára legyen korlátozva, a játékot iFrame-ben kell elhelyezni.
Példa
<!doctype html>
<html>
<head>
<!-- Az itt található Google megjelenítői címke (ha van) a hirdetéseknek csak a H5-játékon kívüli megjelenítéséért lesz felelős. -->
<title>A példa H5-játék oldala</title>
<!-- Ide kerül a <head> tartalom. -->
</head>
<body>
<span id="example-text">Példa H5-játék</span>
<iframe src="https://www.example-game.com" title="Példajáték" allow="autoplay">
<!-- A mintakód itt jelenik meg. Az ebbe a keretbe betöltött Google megjelenítői címkét a rendszer csak a H5-játékban használja. -->
</iframe>
</body>
</html>
Használati megjegyzések
- Az optimális felhasználói élmény biztosítása érdekében a GPT csak olyan oldalakon kér játékbeli manuális közbeiktatott hirdetéseket, amelyek megfelelően támogatják a formátumot. Emiatt a
defineOutOfPageSlot()null értéket adhat vissza. Ezt ellenőrizze, hogy nem végezzen felesleges munkát. - Csak olyan oldalakon vagy környezetekben kérjen játékbeli manuális közbeiktatott hirdetéseket, ahol közbeiktatott hirdetést szeretne megjeleníteni. A játékon belüli manuális közbeiktatott hirdetések asztali számítógépen, táblagépen és mobileszközökön is megjelenhetnek.
- A közbeiktatott hirdetés akkor jelenik meg, amikor meghívja a
makeGameManualInterstitialVisibleelemet aGameManualInterstitialSlotReadyeseményből. - A játékokban megjelenő manuális közbeiktatott hirdetések rögzített gyakoriságkorláttal rendelkeznek. Ez megakadályozza, hogy a
gameManualInterstitialSlotReadyesemény 120 másodpercenként egynél többször aktiválódjon.
Követelmények és javaslatok
- A játékon belüli manuális közbeiktatott hirdetések saját hirdetési helyet hoznak létre. A többi hirdetéstípussal ellentétben a játékbeli manuális közbeiktatott hirdetésekhez nem szükséges
<div>címkét megadni. Ezek a hirdetések automatikusan létrehozzák és beillesztik a saját tárolójukat az oldalba a hirdetés kitöltésekor. - Ha egykéréses architektúrát (SRA) használ egy több helyet tartalmazó oldalon, ne hívja meg a
display()függvényt mindaddig, amíg nem jönnek létre statikus hirdetéshely divek. Ahogyan a hirdetések bevált módszereiben is olvasható, adisplay()első meghívása az adott pont előtt meghatározott összes hirdetéshelyet lekéri. Bár a játékbeli manuális közbeiktatott hirdetési helyek nem igényelnek előre definiált<div>elemet, a statikus hirdetéshelyek igen. Adisplay()meghívása még azelőtt, hogy ezek az elemek jelen lennének az oldalon, rosszabb minőségű jeleket eredményezhet, ezért javasoljuk, hogy késleltesse a kezdeti hívást addig, amíg meg nem jelennek a statikus helyek. - A manuális közbeiktatott hirdetések forgalmazásához ugyanúgy kell beállítani a hirdetési egységet és a sort, mint a normál webes közbeiktatott hirdetések esetében.
Példa
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Példa játékbeli manuális közbeiktatott hirdetésre</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 () {
// Játékbeli manuális közbeiktatott hirdetési hely meghatározása.
defineGameManualInterstitialSlot();
// Statikus hirdetéshelyek meghatározása.
staticSlot = googletag.defineSlot(
'/6355419/Travel/Europe', [100, 100], 'static-ad-1')
.addService(googletag.pubads());
// Az SRA és a szolgáltatások engedélyezése.
googletag.pubads().enableSingleRequest();
googletag.enableServices();
});
function defineGameManualInterstitialSlot() {
gameManualInterstitialSlot = googletag.defineOutOfPageSlot(
'/6355419/Travel/Europe/France/Paris',
googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL);
// A hely null értéket ad vissza, ha az oldal vagy az eszköz nem támogatja a közbeiktatott hirdetéseket.
if (gameManualInterstitialSlot) {
gameManualInterstitialSlot.addService(googletag.pubads());
printStatus('Waiting for interstitial to be ready...');
// Eseményfigyelő hozzáadása a kattintáskezelő regisztrálásához a közbeiktatott hirdetés betöltésekor.
// Ha az esemény nem aktiválódik, próbálkozzon a helyi tárhely ürítésével, majd
// az oldal frissítésével.
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';
// A játékon belüli manuális közbeiktatott hirdetési helyek csak egyszer használatosak, ezért semmisítse meg arégi hirdetéshelyet, és hozzon létre egy újat.
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">A játékon belüli manuális közbeiktatott hirdetéseket ez az oldal nem támogatja.</span>
<p>
<button id="trigger">KÖZBEIKTATOTT HIRDETÉS AKTIVÁLÁSA</button>
</p>
</div>
<script>
googletag.cmd.push(function () {
// Gondoskodjon róla, hogy az első megjelenítési hívás a statikus hirdetéshely
// divek meghatározása után történik.
googletag.display(staticSlot);
});
</script>
</body>
</html>
