Ez a cikk megjegyzéseket és példákat tartalmaz arra vonatkozóan, hogyan lehet H5-játékon belüli 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 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 weboldalakon futó játékokban.
A következő GPT-események szolgálnak a játékon belüli közbeiktatott hirdetések megjelenítéséhez és a velük való interakcióhoz:
| Esemény | Akkor aktiválódik, amikor... |
|---|---|
|
|
Egy játékon belüli közbeiktatott hirdetési hely készen áll a megjelenítésre. A közbeiktatott hirdetés megjelenítéséhez hívja meg a |
|
|
A megjelenített játékon belüli közbeiktatott hirdetési hely bezárult. A játékon belüli közbeiktatott hirdetés bezárásakor egyéni logika végrehajtására szolgál. |
A játékon belüli 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 ugyanabban a felső keretben van elhelyezve, mint az oldal („Teljes képernyős” struktúra használatával). Ebben az esetben a játékon belüli 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 játékon belüli 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>
<!-- Itt adja meg a <head> tartalmát. -->
</head>
<body>
<span id="example-text">Példa H5-játékra</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 azokon az oldalakon kéri a játékon belüli közbeiktatott hirdetéseket, amelyek megfelelően támogatják a formátumot. Emiatt a
defineOutOfPageSlot()null értéket adhat vissza. Csak olyan oldalakon vagy környezetekben kérjen játékon belüli közbeiktatott hirdetéseket, ahol közbeiktatott hirdetést szeretne megjeleníteni. A játékon belüli közbeiktatott hirdetések asztali számítógépen, táblagépen és mobileszközön is megjelenhetnek. - A közbeiktatott hirdetés akkor jelenik meg, amikor meghívja a
makeGameManualInterstitialVisibleelemet aGameManualInterstitialSlotReadyeseményből. - A játékon belüli 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 megjelenítők nem használhatnak H5-játékon belüli közbeiktatott hirdetéseket nem játék típusú készletben. A formátum megvalósításával a megjelenítők automatikusan elfogadják ezt a feltételt. A Google megjelenítői irányelveit és a Google Ad Manager partneri irányelveit is be kell tartani.
- A Google fenntartja a jogot arra, hogy bármikor jóváhagyja vagy elutasítsa a megjelenítőket. Az irányelveket megsértő megjelenítők lekerülnek az engedélyezőlistáról.
- A játékon belüli közbeiktatott hirdetések saját hirdetési helyet hoznak létre. A többi hirdetéstípussal ellentétben a játékon belüli közbeiktatott hirdetésekhez nem szükséges <div> elemet megadni. Ezek a hirdetések automatikusan létrehozzák saját tárolójukat és beszúródnak a saját tárolójukba az oldalon, amikor egy hirdetés kitöltődik.
- 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ékon belüli 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.
Kezdés
- Címkézés
- Hozzon létre egy GPT-helyet a
googletag.defineOutOfPageSlot()használatával, és állítsa az OutOfPage formátumot agoogletag.defineOutOfPageSlot()értékre.
Tekintse meg a GPT H5-játékon belüli közbeiktatott hirdetésekre vonatkozó műszaki fejlesztői útmutatóját. - A hely meghatározása után adjon hozzá egy eseményfigyelőt, amely a
gameManualInterstitialSlotReadyeseményre figyel. A hirdetés megjelenítéséhez hívja meg az eseményfigyelő visszahívási függvényében amakeGameManualInterstitialVisible()metódust a megadott eseményobjektumon. - Miután deklarálta az összes többi statikus hirdetési helyet, a
googletag.displayhívása aktiválja a játékon belüli közbeiktatott hirdetési hely kitöltésére vonatkozó kérelmet.
- Hozzon létre egy GPT-helyet a
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ékon belüli 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ékon belüli 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());
// Engedélyezze az SRA-t és a szolgáltatásokat.
googletag.pubads().enableSingleRequest();
googletag.enableServices();
});
function defineGameManualInterstitialSlot() {
gameManualInterstitialSlot = googletag.defineOutOfPageSlot(
'/6355419/Travel/Europe/France/Paris',
googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL);
// A hirdetéshely 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, miután a közbeiktatott hirdetés betöltődött.
// 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éshelyek egyszer használatosak, ezért semmisítse meg a régi helyet, é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>
Hirdetésforgalmazás
- Hozzon létre új hirdetési egységet, vagy használjon fel újra egy meglévőt. A hirdetési egység méreteként válassza a 320 x 480, a 300 x 250 és a 336 x 280 értéket.
- Sorok létrehozása A használati eset alapján válassza ki a megfelelő sorbeállításokat:
| Sorbeállítások | ||||
|---|---|---|---|---|
| Használati eset | Hirdetés típusa | Sor típusa | Várható kreatívok | Célzás > Készlet |
| Foglalási vizuális hirdetés megjelenítése | Vizuális |
|
320 x 480, 300 x 250 vagy 336 x 280 |
Az előző lépésben létrehozott vagy kiválasztott hirdetési egység |
| Nem foglalási hirdetés megjelenítése | Vizuális |
|
||
| Foglalásos videóhirdetés (pl. VAST-címke vagy MP4) megjelenítése | Videó vagy audio |
|
300x250v vagy 320x480v | |
| Háttérkitöltési/nyílt aukciós hirdetések megjelenítése | Vizuális | Ad Exchange | Minden kért méret | |