Tekninen pika‑aloitusopas (AdSense peleille)

Tästä oppaasta opit, miten saat Googlen IMA HTML5 SDK:n syöttämään mainoksia HTML5-verkkopeleihin AdSensellä.

Teknisen käyttöönoton yleiskatsaus

AdSense peleille käyttää Googlen interaktiivisten mediamainosten ohjelmistokehityspakettia (IMA HTML5 SDK:ta). Tämän SDK:n avulla voit pyytää AdSense‑mainoksia JavaScript‑kielellä, mikä sitoo sisällön ja mainonnan entistä tiiviimmin yhteen.

Huom. Näihin tuotteisiin sovelletaan AdSensen käyttöehtoja, AdSense-ohjelmakäytäntöjä ja tuotekohtaisia käyttöohjeita. Muista, että liian aggressiivisten tai virheellisten käyttötapojen johdosta syntyneillä tahattomilla klikkauksilla on seurauksensa, joista vakavin on tilin sulkeminen.

Jos haluat pyytää ja renderöidä mainoksia käyttämällä IMA HTML5 SDK:ta, luo mainospyyntö, lataa asiaan liittyvä mainos ja toista se oikeaan aikaan. Testaa integrointisi käyttämällä julkaisijan oletustunnusta ca-games-pub-4968145218643279.

Huomaa, että sinun on toimitettava tilin hallinnoijalle integrointiesimerkki, ennen kuin voit ottaa mainoksia käyttöön sivustoillasi.

Voit valita joko yksinkertaisen tai tarkennetun integroinnin. 

Yksinkertainen integrointi

Yksinkertainen integrointivaihtoehto on helpoin tapa integroida AdSense peleille ‐ohjelma HTML5-peleihin. Se tarjoaa nopean käyttöönottoratkaisun, joka sisältää kaikki AdSense peleille ‐ohjelmaan saatavilla olevat ominaisuudet ja mainosmuodot.

Jos haluat käyttää tätä yksinkertaista integrointivaihtoehtoa, ilmoita kiinnostuksestasi.

Tarkennettu integrointi

Jos haluat tarkemman tai oman integroinnin, ota HTML5‑pelissä käyttöön koko IMA HTML5 SDK. Tämä vaihtoehto tarjoaa lisäjoustavuutta, kuten tietyt Google Ad Managerin kautta saatavilla olevat ominaisuudet. Muista kuitenkin, että tämä vaihtoehto on myös monimutkaisempi.

Tarkennetun integroinnin aloittaminen

Aloita integroimalla IMA HTML5 SDK peliisi.

1. Ota IMA HTML5 SDK ‑integrointi käyttöön

   Integroi IMA HTML5 SDK peliisi Googlen kehittäjäsivustolla annettujen ohjeiden mukaisesti. Ohjeet sisältävät aloitusoppaan, ladattavan koodinäytteen ja täydelliset API‑tiedot.

2. Määritä mainossäilö (AdDisplayContainer)

   Koska interaktiivisten mediamainosten HTML5‑ohjelmistokehityspaketti palvelee sekä video‑ että pelijulkaisijoita, AdDisplayContainer voidaan määrittää usealla eri tavalla.

   Kun määrität kohdetta AdDisplayContainer AdSense peleille ‑ohjelmalle, välitä referenssi siihen div‑elementtiin, johon mainos sisällytetään.

   Esimerkki:

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

3. Määritä mainospyyntö (AdsRequest)

   Kun luot AdsRequest-kohdetta, varmista olennaisten parametrien ja ominaisuuksien oikea määritys, jotta mainokset palautetaan ja renderöidään oikein.

   Esimerkki:

   // Pyydä AdSense peleille ‑mainoksia.
var adsRequest = uusi google.ima.AdsRequest();
 
// Määritä AdSense peleille ‐mainostagi
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';
 
// Pakota kuva-/tekstimainokset renderöitymään koko mainospaikan käyttöliittymässä
adsRequest.forceNonLinearFullSlot = true;
 
// Määritä lineaaristen ja ei-lineaaristen paikkojen koot.
adsRequest.linearAdSlotWidth = {your_game_width};
adsRequest.linearAdSlotHeight = {your_game_height};
adsRequest.nonLinearAdSlotWidth = {your_game_width};
adsRequest.nonLinearAdSlotHeight = {your_game_height};

4. Seuraa olennaisia tapahtumia ja luo takaisinsoittoja

   On tärkeää seurata tapahtumia, jotka käynnistyvät IMA SDK:ssa. Näin tiedät, milloin mainoksen näkyminen on keskeytettävä ja käyttäjien annettava jatkaa pelin pelaamista.

   Alla on joitain mainostapahtumia, joita käytetään usein mainosten sijoittelussa pelisisältöön. Voit esimerkiksi seurata COMPLETE-tapahtumaa, jotta saat selville, koska mainoksen toisto loppuu ja käyttäjä näkee pelisisältösi. API‑tiedoissa on luettelo kaikista mainostapahtumista.

   Tapahtuman nimi	Kuvaus
   AdEvent.Type.CLICK	Käynnistyy, kun mainosta klikataan.
   AdEvent.Type.COMPLETE	Käynnistyy, kun mainoksen toisto päättyy.
   AdEvent.Type.LOADED	Käynnistyy, kun mainosdata on käytettävissä.
   AdEvent.Type.SKIPPED	Käynnistyy, kun käyttäjä ohittaa mainoksen.
   AdEvent.Type.START	Käynnistyy, kun mainoksen toisto alkaa.
   AdEvent.Type.USER_CLOSE	Käynnistyy, kun käyttäjä sulkee mainoksen.
   AdErrorEvent.Type.AD_ERROR	Käynnistyy, kun mainoksessa tapahtuu virhe. Mainoksessa voi tapahtua useita erilaisia virheitä. Mediasisältökohteen lataaminen saattaa esimerkiksi epäonnistua tai mainospyyntöihin saatetaan antaa tyhjiä vastauksia. API‑tiedoissa on luettelo mahdollisista virheistä.