מדריך טכני למתחילים (AFG)

המדריך מסביר איך לשלב עם Google IMA HTML5 SDK כדי להציג מודעות במשחקי HTML 5 באינטרנט עם AdSense. 

סקירה כללית של הגדרה טכנית

פלטפורמת AdSense למשחקים פועלת באמצעות ערכת פיתוח התוכנה של מודעות מדיה אינטראקטיבית (IMA HTML5 SDK). ערכת SDK זו מאפשרת לך להשתמש ב-JavaScript כדי לבקש מודעות AdSense במטרה ליצור שילוב הדוק יותר בין תוכן לפרסום.

הערה:המוצרים האלה כפופים לתנאים ולהגבלות של AdSense, מדיניות התוכנית של AdSense ולהנחיות השימוש הספציפיות למוצר. חשוב לזכור שאם נזהה קליקים לא מכוונים שמקורם בהטמעות אגרסיביות מדי או שגויות, שמורה לנו הזכות להגיב על כך בכל דרך עד (וכולל) סגירת החשבון.

כדי לבקש ולעבד מודעות באמצעות IMA HTML5 SDK, יש להגדיר בקשה למודעה, לטעון את המודעה המתקבלת ולהציג אותה בזמן הנכון. בודקים את השילוב באמצעות מזהה בעל האתר שמוגדר כברירת המחדל ca-games-pub-4968145218643279.

חשוב לדעת שצריך לספק למנהל החשבון דוגמה של השילוב לפני קבלת האישור לפרוס מודעות באתרים שלכם.

יש שתי אפשרויות של שילוב, פשוט או מתקדם. 

שילוב פשוט

אפשרות השילוב הפשוט היא הדרך הקלה ביותר לשילוב AdSense למשחקים במשחקי HTML5. אפשרות זו מספקת פתרון ליישום מהיר, שמספק את כל התכונות והפורמטים של מודעות הזמינים ב-'AdSense למשחקים'.

יצרני תוכן שמעוניינים להשתמש באפשרות השילוב הפשוט יכולים להירשם כאן.

שילוב מתקדם

יצרני תוכן שמעוניינים באפשרות שילוב מתקדמת יותר ומותאמת אישית צריכים לבצע הטמעה מלאה של IMA HTML5 SDK במשחק שפיתחו בפורמט HTML5. אפשרות זו מספקת יותר גמישות. למשל, כשמשתמשים באפשרות זו, תכונות מסוימות זמינות דרך Google Ad Manager. עם זאת, חשוב לזכור שהשימוש באפשרות הזו מורכב יותר.

תחילת העבודה עם שילוב מתקדם

כדי להתחיל, יש לשלב את IMA HTML5 SDK במשחק.

1. הגדרת השילוב של IMA HTML5 SDK

   יש לפעול לפי ההנחיות שמפורטות באתר Google Developers לשילוב של IMA HTML5 SDK במשחק. ההנחיות כוללות שלבים לתחילת העבודה, קוד לדוגמה להורדה, ורשימה מלאה של הפניות API לעזרה בתהליך.

2. הגדרה של מאגר מודעות (AdDisplayContainer)

   IMA HTML5 SDK משמש גם יצרנים של תוכני וידאו וגם מפתחי משחקים, ולכן ניתן להגדיר את האובייקט AdDisplayContainer בכמה דרכים.

   כשמגדירים את האובייקט AdDisplayContainer לשימוש עם AdSense למשחקים, כל מה שצריך לעשות הוא להעביר את ההפניה לתג div שיכיל את המודעה.

   דוגמה:

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

3. הגדרה של בקשה למודעה (AdsRequest)

   כשיוצרים אובייקט AdsRequest יש להקפיד להגדיר את הפרמטרים והמאפיינים הרלוונטיים כראוי כדי שההחזרה והעיבוד של המודעות יתבצעו כהלכה.

   דוגמה:

   // בקשה למודעות של AdSense למשחקים.
var adsRequest = new google.ima.AdsRequest();
 
// מגדירים את תג המודעה של AdSense למשחקים
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
 
// אילוץ עיבוד של מודעות תמונה/טקסט באמצעות ממשק משתמש במשבצת מלאה
adsRequest.forceNonלינאריFullSlot = true;
 
// מציינים את המשבצות הלינאריות והלא-לינאריות.
adsRequest.linearAdSlotWidth = {your_game_width};
adsRequest.linearAdSlotHeight = {your_game_height};
adsRequest.nonLinearAdSlotWidth = {your_game_width};
adsRequest.nonLinearAdSlotHeight = {your_game_height};

4. זיהוי אירועים רלוונטיים ויצירת קודים להתקשרות חזרה

   חשוב לזהות אירועים שמופעלים ב-IMA SDK כדי לדעת מתי להפסיק להציג את המודעה ולאפשר למשתמשים להמשיך במשחק.

   בהמשך ריכזנו כמה אירועי מודעות שבהרבה מקרים משתמשים בהם כדי לקבוע את המיקום של מודעות בתוכן המשחק. לדוגמה, אפשר להגדיר את המערכת לזיהוי של האירוע COMPLETE כדי להבין מתי מסתיימת הצגת המודעה ולאחר מכן להציג למשתמש את תוכן המשחק. ניתן למצוא רשימה מלאה של אירועי מודעות בהפניות API.

   שם האירוע	תיאור
   AdEvent.Type.Click	מופעל כשהמשתמש לוחץ על המודעה.
   AdEvent.Type.COMPLETE	מופעל כשההצגה של מודעה מסתיימת.
   AdEvent.סוג.LOADED	מופעל כשנתוני המודעה זמינים.
   AdEvent.Type.SKIPPED	מופעל כשהמשתמש מדלג על המודעה.
   AdEvent.Type.START	מופעל כשהצגת המודעה מתחילה.
   AdEvent.Type.USER_CLOSE	מופעל כשהמשתמש סוגר את המודעה.
   AdErrorEvent.סוג.AD_ERROR	מופעל כשמתרחש אירוע שגיאה במודעה. קיימים סוגים רבים של שגיאות שעשויות להתרחש במודעה. בין היתר, כשל בטעינת נכסי מדיה של המודעה או החזרה של תגובות ריקות לבקשות למודעות. רשימה של שגיאות אפשריות זמינה בהפניות API.