Úvodní technický průvodce (AFG)

V tomto průvodci se dozvíte, jak integrovat sadu IMA HTML5 SDK od Googlu, abyste mohli pomocí služby AdSense zobrazovat reklamy ve webových hrách ve formátu HTML 5.

Přehled technického nastavení

Služba AdSense pro hry funguje na bázi sady pro vývoj softwaru určené pro interaktivní mediální reklamy (IMA HTML5 SDK) od společnosti Google. Pomocí této sady SDK lze požadovat reklamy AdSense s využitím JavaScriptu, aby bylo možné těsněji kombinovat obsah a inzerci.

Poznámka: Na služby se vztahují smluvní podmínky AdSense, programové zásady AdSense a pravidla pro používání konkrétních služeb. Neúmyslná kliknutí pocházející z příliš agresivních nebo vadných implementací mohou vést až ke zrušení účtu.

Požadování reklam a jejich zobrazování prostřednictvím sady IMA HTML5 SDK spočívá v nastavení požadavku na reklamu, načtení výsledné reklamy a jejím přehrání ve správný okamžik. Integraci můžete otestovat pomocí výchozího ID majitele stránek ca-games-pub-4968145218643279.

Reklamy budete moci na svůj web umístit až poté, co poskytnete správci účtu příklad vaší integrace.

Jsou dva způsoby integrace: jednoduchá a pokročilá. 

Jednoduchá integrace

Nejsnazším způsobem, jak integrovat službu AdSense pro hry do vašich her ve formátu HTML5, je možnost jednoduché integrace. Tato možnost nabízí rychlou implementaci, která poskytuje všechny funkce a formáty reklam dostupné v rámci služby AdSense pro hry.

Pokud jste majitelem obsahu a chcete využít možnost jednoduché integrace, můžete se zaregistrovat jako zájemce o tuto funkci.

Pokročilá integrace

Pokud jste majitelem obsahu a hledáte pokročilejší nebo personalizovanější způsob integrace, implementujte svou hru ve formátu HTML5 s kompletní sadou IMA HTML5 SDK. Tato možnost vám poskytne ještě větší flexibilitu, jako například některé funkce dostupné prostřednictvím služby Google Ad Manager, integrace však zároveň bude složitější.

Začínáme s pokročilou integrací

Začněte tím, že do hry integrujete sadu IMA HTML5 SDK.

1. Nastavení integrace IMA HTML5 SDK

   Podle pokynů uvedených na webu Google Developers proveďte integraci sady IMA HTML5 SDK se svojí hrou. Pomůže vám v tom návod, jak začít, společně s ukázkou kódu ke stažení a kompletními referenčními materiály rozhraní API.

2. Nastavení kontejneru reklamy (AdDisplayContainer)

   Vzhledem k tomu, že sada IMA HTML5 SDK je určena jak vydavatelům her, tak vydavatelům videí, objekt AdDisplayContainer lze nakonfigurovat více způsoby.

   Při konfiguraci objektu AdDisplayContainer pro použití se službou AdSense pro hry jednoduše vložte referenci do kódu značky div, která bude danou reklamu obsahovat.

   Příklad:

   var adDisplayContainer = new google.ima.AdDisplayContainer(document.getElementById('adContainer'));

3. Konfigurace žádosti o reklamu (AdsRequest)

   Při vytváření objektu AdsRequest musíte zajistit, aby byly příslušné parametry a vlastnosti správně nakonfigurovány a reklamy se tak správně vracely a vykreslovaly.

   Příklad:

   // Požadavek na zobrazení reklam AdSense pro hry.
var adsRequest = new google.ima.AdsRequest();
 
// Nastavení značky reklamy AdSense pro hry
adsRequest.adTagUrl = 'https://googleads.g.doubleclick.net/pagead/ads?ad_type=video_image_text&client=ca-games-pub-4968145218643279&videoad_start_delay=0&description_url=http%3A%2F%2Fwww.google.com&max_ad_duration=20000&adtest=on';
 
// Vynucení vykreslování celoblokových grafických/textových reklam v uživatelském rozhraní
adsRequest.forceNonLinearFullSlot = true;
 
// Určení lineární i nelineární velikosti bloku.
adsRequest.linearAdSlotWidth = {your_game_width};
adsRequest.linearAdSlotHeight = {your_game_height};
adsRequest.nonLinearAdSlotWidth = {your_game_width};
adsRequest.nonLinearAdSlotHeight = {your_game_height};

4. Naslouchejte příslušným událostem a vytvořte zpětná volání

   Událostem, které jsou v sadě IMA SDK spuštěny, je třeba naslouchat, abyste věděli, kdy přestanou reklamu zobrazovat a dovolí vašim uživatelům pokračovat ve hře.

   Níže uvádíme některé události reklamy, které se běžně používají k určení umístění reklam do obsahu hry. Můžete například naslouchat události COMPLETE, abyste zjistili, kdy skončilo přehrávání reklamy, a poté uživateli zobrazit herní obsah. Úplný seznam událostí reklam najdete v referenčních materiálech rozhraní API.

   Název události	Popis
   AdEvent.Type.CLICK	Spustí se po kliknutí na reklamu.
   AdEvent.Type.COMPLETE	Spustí se po dokončení přehrávání reklamy.
   AdEvent.Type.LOADED	Spustí se, když jsou dostupné údaje reklamy.
   AdEvent.Type.SKIPPED	Spustí se, když uživatel reklamu přeskočí.
   AdEvent.Type.START	Spustí se po zahájení přehrávání reklamy.
   AdEvent.Type.USER_CLOSE	Spustí se, když uživatel reklamu zavře.
   AdErrorEvent.Type.AD_ERROR	Spustí se, když se vyskytne chybová událost reklamy. V reklamě se může vyskytnout řada chyb. Může například dojít k tomu, že se nepodaří načíst mediální podklady reklamy, nebo že se na žádost o reklamu vrátí prázdná odpověď. Seznam možných chyb najdete v referenčních materiálech rozhraní API.