Tehnički kratki vodič za početak rada (AFG)

Pomoću ovog vodiča saznajte kako integrirati Googleov IMA HTML5 SDK za posluživanje oglasa u HTML 5 web-igrama putem AdSensea. 

Pregled tehničkih postavki

AdSense za igre funkcionira pomoću Googleova Paketa za razvoj softvera za interaktivne medijske oglase (IMA HTML5 SDK). Taj vam SDK omogućuje da zatražite AdSense oglase putem JavaScripta kako biste što uže povezali sadržaj i oglašavanje.

Napomena: ti proizvodi podliježu Uvjetima i odredbama AdSensea, Programskim pravilima za AdSense i smjernicama za upotrebu određenog proizvoda. Napominjemo da nenamjerni klikovi ostvareni previše agresivnom ili pogrešnom implementacijom mogu uzrokovati provođenje raznih radnji uključujući i ukidanje računa.

Za traženje i generiranje oglasa putem IMA HTML5 SDK-a potrebno je postaviti zahtjev za oglas, učitati dobiveni oglas i prikazati ga u pravom trenutku. Testirajte svoju integraciju pomoću zadanog ID-ja izdavača ca-games-pub-4968145218643279.

Imajte na umu da prije nego dobijete dopuštenje za implementiranje oglasa u web-lokaciju, upravitelju računa morate dati na uvid primjer integracije.

Imate dvije opcije za integraciju, jednostavnu ili naprednu. 

Jednostavna integracija

Opcija jednostavne integracije najjednostavniji je način za integriranje AdSensea za igre s vašim HTML5 igrama. Ta opcija pruža brzo rješenje za implementaciju koje pruža sve značajke i formate oglasa koji su dostupni u AdSenseu za igre.

Ako ste izdavač koji želi upotrebljavati tu jednostavnu opciju za integraciju, možete iskazati interes.

Napredna integracija

Ako ste izdavač koji traži napredniju i prilagođenu integraciju, na vašu HTML5 igru trebao bi se implementirati potpuni IMA HTML5 SDK. Ta opcija pruža dodatnu fleksibilnost kao što su određene značajke dostupne putem Google Ad Managera, ali imajte na umu da donosi i dodatnu složenost.

Početak rada s naprednom integracijom

Da biste započeli, integrirajte IMA HTML5 SDK u svoju igru.

1. Postavljanje integracije IMA HTML5 SDK-a

   Slijedite smjernice na web-lokaciji Google Developera da biste integrirali IMA HTML5 SDK u svoju igru. Dostupne su upute za početak, kao i primjer koda koji možete preuzeti te potpuna referenca za API za pomoć.

2. Postavljanje spremnika oglasa (AdDisplayContainer)

   Budući da je IMA HTML5 SDK namijenjen izdavačima videozapisa i igara, objekt AdDisplayContainer može se konfigurirati na više načina.

   Prilikom konfiguriranja objekta AdDisplayContainer za upotrebu s AdSenseom za igre jednostavno proslijedite referencu na div koji će sadržavati oglas.

   Primjer:

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

3. Konfiguriranje zahtjeva za oglas (AdsRequest)

   Prilikom izrade objekta AdsRequest morate pravilno konfigurirati relevantne parametre i svojstva kako bi se oglasi vraćali i prikazivali pravilno.

   Primjer:

   // Zahtijevanje oglasa AdSensea za igre.
var adsRequest = new google.ima.AdsRequest();

// Postavljanje oglasne oznake AdSensea za igre
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';

// Nametanje prikazivanja slikovnih/tekstualnih oglasa na korisničkom sučelju oglasa koji zauzimaju cijelo mjesto
adsRequest.forceNonLinearFullSlot = true;

// Navođenje linearnih i nelinearnih veličina mjesta oglasa.
adsRequest.linearAdSlotWidth = {your_game_width};
adsRequest.linearAdSlotHeight = {your_game_height};
adsRequest.nonLinearAdSlotWidth = {your_game_width};
adsRequest.nonLinearAdSlotHeight = {your_game_height};

4. Praćenje relevantnih događaja i izrada povratnih poziva

   Važno je pratiti događaje koji se aktiviraju u IMA SDK-u kako biste znali kada zaustaviti prikazivanje oglasa i dopustiti korisniku da nastavi igrati igru.

   U nastavku možete pronaći neke događaje oglasa na temelju kojih se obično utvrđuje položaj oglasa u sadržaju igre. Na primjer, možete pratiti događaj COMPLETE da biste znali kada je reprodukcija oglasa završila i tada možete korisniku prikazati sadržaj igre. Popis svih događaja oglasa dostupan je u referenci za API.

   Naziv događaja	Opis
   AdEvent.Type.CLICK	Aktivira se kada netko klikne oglas.
   AdEvent.Type.COMPLETE	Aktivira se kada se reprodukcija oglasa završi.
   AdEvent.Type.LOADED	Aktivira se kada su dostupni podaci o oglasu.
   AdEvent.Type.SKIPPED	Aktivira se kada korisnik preskoči oglas.
   AdEvent.Type.START	Aktivira se kada se oglas počne reproducirati.
   AdEvent.Type.USER_CLOSE	Aktivira se kada korisnik zatvori oglas.
   AdErrorEvent.Type.AD_ERROR	Aktivira se kada se dogodi pogreška oglasa. Postoje mnoge vrste pogrešaka oglasa. Na primjer, neučitavanje medijskih materijala oglasa ili vraćanje praznih odgovora na zahtjeve za oglase. Popis mogućih pogrešaka dostupan je u referenci za API.