adConfig

הקריאה ל-adConfig() מעבירה את ההגדרה הנוכחית של המשחק ל-Ad Placement API. ה-Ad Placement API יכול לשפר את האופן שבו המודעות נטענות מראש ולסנן את המודעות כך שהן יתאימו (למשל, מודעות וידאו שנדרש להן צליל).

חתימת הפונקציה:

adConfig({
   preloadAdBreaks: 'on|auto',  // Ad preloading strategy
   sound: 'on|off'              // This game has sound
   onReady: () => {},           // Called when API has initialised and adBreak() is ready
});

פרמטרים של adConfig

שם	סוג	תיאור
sound	string	(אופציונלי) האם המשחק מושמע עכשיו. ערכים: - on (ברירת מחדל) - off השיחה הזו קובעת אם המשחק יכול להשמיע קול, ואם הצליל הופעל (כלומר, שהושתק) לפני השיחה אל adBreak(). פעולה זו עוזרת ל-Ad Placement API לבחור את סוג המודעה המתאים למשחק שלך. יש להפעיל את הפונקציה הזו ברגע שמצב הצליל של המשחק משתנה, כי ייתכן ש-Ad Placement API יצטרך לבקש קריאייטיבים חדשים, וזה יגדיר את משך הזמן המקסימלי לכך. ערך ברירת המחדל הוא צליל. לכן, רוב המשחקים יצטרכו להתקשר אל adConfig() כשיוכלו להצהיר שהם מופעלים.
preloadAdBreaks	string	(אופציונלי) אם יש לטעון מראש מודעות לפני הקריאה הראשונה ל-adBreak(). ערכים: - on - auto (ברירת מחדל) ערך ברירת המחדל של auto משאיר את ההחלטה עד ל-Ad Placement API. ניתן להגדיר את preloadAdBreaks פעם אחת בלבד עם adConfig(), וערכים נוספים שמועברים אל preloadAdBreaks אינם משפיעים. להגדרת preloadAdBreaks אחרי הקריאה הראשונה ל-adBreak() אין השפעה.
onReady	string	(אופציונלי) נקרא כשה-API הופעל וסיים טעינה מראש של מודעות (אם ביקשת טעינה מראש באמצעות preloadAdBreaks שלמעלה).