विज्ञापन का कॉन्फ़िगरेशन

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 स्ट्रिंग (ज़रूरी नहीं) क्या गेम में अभी आवाज़ आ रही है. वैल्यू:
- on (डिफ़ॉल्ट)
- off
इस कॉल से यह पता चलता है कि आपके गेम में आवाज़ की सुविधा है या नहीं. साथ ही, यह भी पता चलता है कि adBreak() को कॉल करने से पहले आवाज़ चालू थी या नहीं (यानी कि म्यूट नहीं थी). इससे Ad Placement API को आपके गेम के लिए सही तरह का विज्ञापन चुनने में मदद मिलती है.
आपके गेम की आवाज़ की स्थिति में बदलाव होने पर, इस फ़ंक्शन को तुरंत कॉल करें. ऐसा इसलिए, क्योंकि Ad Placement API को नए क्रिएटिव का अनुरोध करना पड़ सकता है. इससे उसे ऐसा करने के लिए ज़्यादा समय मिल जाता है.

डिफ़ॉल्ट वैल्यू, आवाज़ चालू है. इसलिए, ज़्यादातर गेम को यह एलान करने के लिए adConfig() को कॉल करना होगा कि उनमें आवाज़ की सुविधा चालू है.
preloadAdBreaks स्ट्रिंग (ज़रूरी नहीं) क्या विज्ञापनों को हमेशा adBreak() पर पहले कॉल से पहले प्रीलोड किया जाना चाहिए. वैल्यू:
- on
- auto (डिफ़ॉल्ट)

auto की डिफ़ॉल्ट वैल्यू, फ़ैसला लेने का अधिकार Ad Placement API को देती है. preloadAdBreaks को adConfig() के साथ सिर्फ़ एक बार सेट किया जा सकता है. इसके बाद, preloadAdBreaks को पास की गई वैल्यू का कोई असर नहीं होता.
adBreak() को पहली बार कॉल करने के बाद, preloadAdBreaks को सेट करने का कोई असर नहीं होता.
onReady स्ट्रिंग (ज़रूरी नहीं) इस फ़ंक्शन को तब कॉल किया जाता है, जब एपीआई शुरू हो जाता है और विज्ञापनों को पहले से लोड करने की प्रोसेस पूरी हो जाती है. ऐसा तब होता है, जब आपने ऊपर दिए गए preloadAdBreaks का इस्तेमाल करके, विज्ञापनों को पहले से लोड करने का अनुरोध किया हो.