Ghid de pornire rapidă cu noțiuni tehnice (AdSense pentru jocuri)

Acest ghid vă arată cum să integrați kitul SDK IMA HTML5 Google pentru a difuza anunțuri în jocuri web HTML5 prin AdSense.

Prezentare generală a configurării tehnice

AdSense pentru jocuri funcționează folosind Kitul de dezvoltare software pentru anunțurile media interactive (setul SDK HTML5 IMA) de la Google. Acest set SDK vă dă posibilitatea să solicitați anunțuri AdSense prin JavaScript, pentru a combina mai bine conținutul site-ului și publicitatea.

Notă: aceste produse se supun Termenilor și condițiilor AdSense, politicilor de produs AdSense și regulilor de utilizare specifice fiecărui produs. Rețineți: clicurile necorespunzătoare care sunt generate de implementări prea agresive sau incorecte vor determina măsuri care pot merge inclusiv până la desființarea contului.

Pentru a solicita și a reda anunțuri prin setul SDK HTML5 IMA, configurați o solicitare de anunț, încărcați anunțul rezultat și redați-l la momentul potrivit. Testați integrarea folosind codul de editor prestabilit: ca-games-pub-4968145218643279.

Rețineți că trebuie să îi comunicați managerului de cont un exemplu al integrării SDK înainte de a avea permisiunea de a afișa anunțuri pe propriul site.

Există două opțiuni de integrare: simplă sau avansată.

Integrarea simplă

Opțiunea de integrare simplă este cel mai ușor mod de a integra AdSense pentru jocuri cu jocurile HTML5. Această opțiune este o soluție de implementare rapidă, care oferă toate funcțiile și formatele de anunțuri disponibile în AdSense pentru jocuri.

Dacă doriți să folosiți opțiunea de integrare simplă, exprimați-vă interesul.

Integrarea avansată

Dacă doriți o integrare personalizată, mai avansată, setul complet SDK HTML5 IMA trebuie implementat cu jocul dvs. HTML5. Această opțiune vă oferă un plus de flexibilitate, cum ar fi anumite funcții disponibile prin Google Ad Manager, dar trebuie să aveți în vedere faptul că aduce și un plus de complexitate.

Noțiuni introductive despre integrarea avansată

Pentru a începe, integrați setul SDK HTML5 IMA cu jocul dvs.

1. Configurarea integrării setului SDK HTML5 IMA

   Urmați indicațiile de pe site-ul Google Developers pentru a realiza integrarea setului SDK HTML5 IMA cu jocul dvs. Veți găsi pașii necesari pentru a începe, împreună cu un exemplu de cod care poate fi descărcat și o referință API completă care să vă ajute.

2. Configurarea containerului de anunțuri (AdDisplayContainer)

   Întrucât setul SDK HTML5 IMA deservește atât editorii video, cât și pe cei de jocuri, obiectul AdDisplayContainer poate fi configurat în mai multe moduri.

   Când configurați obiectul AdDisplayContainer pentru utilizarea cu AdSense pentru jocuri, doar transmiteți referința către elementul div care va conține anunțul.

   Exemplu

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

3. Configurarea solicitării de anunț (AdsRequest)

   Când creați obiectul AdsRequest, trebuie să vă asigurați că s-au configurat corect parametrii și proprietățile relevante, astfel încât anunțurile să fie afișate corespunzător.

   Exemplu:

   // Solicitați anunțuri AdSense pentru jocuri.
var adsRequest = new google.ima.AdsRequest();
 
// Configurați eticheta publicitară AdSense pentru jocuri
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';
 
// Forțați afișarea anunțurilor tip imagine sau text cu IU pentru dimensiuni maxime
adsRequest.forceNonLinearFullSlot = true;
 
// Specificați dimensiunile spațiilor liniare și neliniare.
adsRequest.linearAdSlotWidth = {your_game_width};
adsRequest.linearAdSlotHeight = {your_game_height};
adsRequest.nonLinearAdSlotWidth = {your_game_width};
adsRequest.nonLinearAdSlotHeight = {your_game_height};

4. Detectarea evenimentelor relevante și crearea reapelărilor

   Este important să detectați evenimentele declanșate în setul SDK IMA, ca să știți când să opriți afișarea anunțului și să lăsați utilizatorii să joace în continuare.

   Mai jos, găsiți câteva dintre evenimentele utilizate frecvent pentru a determina poziționarea anunțurilor în conținutul jocului. De exemplu, puteți detecta evenimentul COMPLETE pentru a ști când se încheie difuzarea anunțului, după care puteți afișa conținutul jocului pentru utilizator. Consultați lista completă a evenimentelor publicitare în referința API.

   Numele evenimentului	Descriere
   AdEvent.Type.CLICK	Declanșat când se dă clic pe anunț.
   AdEvent.Type.COMPLETE	Declanșat când se încheie difuzarea anunțului.
   AdEvent.Type.LOADED	Declanșat când sunt disponibile datele anunțului.
   AdEvent.Type.SKIPPED	Declanșat când utilizatorul ignoră anunțul.
   AdEvent.Type.START	Declanșat când începe difuzarea anunțului.
   AdEvent.Type.USER_CLOSE	Declanșat când utilizatorul închide anunțul.
   AdErrorEvent.Type.AD_ERROR	Declanșat când apare o eroare legată de anunț. Există mai multe tipuri de astfel de erori. De exemplu, dacă nu se pot încărca elementele media din anunț sau dacă se returnează răspunsuri goale la solicitările de anunțuri. Consultați lista erorilor posibile în referința API.