Ad Placement API का इस्तेमाल करना

Ad Placement API में दो फ़ंक्शन होते हैं: adBreak() और adConfig(), जो ग्लोबल नेमस्पेस में तय किए जाते हैं. ज़्यादातर आर्ग्युमेंट ऐसे फ़ंक्शन होते हैं जिन्हें आपको उपलब्ध कराना होता है. इनकी मदद से, विज्ञापन दिखाने और उसे तैयार करने के मुख्य चरणों को मैनेज किया जा सकता है:

adBreak({
   type: '<type>',                      // The type of this placement
   name: '<name>',                      // A descriptive name for this placement
   beforeAd: () => {},                  // Prepare for the ad. Mute and pause the game flow
   afterAd: () => {},                   // Resume the game and un-mute the sound
   beforeReward: (showAdFn) => {},      // Show reward prompt (call showAdFn() if clicked)
   adDismissed: () => {},               // Player dismissed the ad before completion
   adViewed: () => {},                  // Ad was viewed and closed
   adBreakDone: (placementInfo) => {},  // Always called (if provided) even if an ad didn't show
});

adConfig({
   preloadAdBreaks: 'on|auto',      // Should ads always be preloaded
   sound: 'on|off',                 // Is sound currently enabled within the game
});

इन फ़ंक्शन का इस्तेमाल, आपके गेम में विज्ञापन दिखाने और उन्हें कॉन्फ़िगर करने के लिए किया जाता है. ऊपर दिखाए गए आर्ग्युमेंट ही मान्य आर्ग्युमेंट हैं. इन्हें इन फ़ंक्शन में पास किया जा सकता है. अलग-अलग तरह के विज्ञापनों के लिए, इन तर्कों के अलग-अलग सबसेट की ज़रूरत होती है. इसके बारे में यहां बताया गया है.

adBreak() आपके गेम में विज्ञापन दिखाने के लिए मुख्य फ़ंक्शन है. यह एक विज्ञापन प्लेसमेंट तय करता है और प्लेसमेंट कॉन्फ़िगरेशन नाम का एक ऑब्जेक्ट लेता है. इसमें विज्ञापन दिखाने के लिए ज़रूरी सभी चीज़ें शामिल होती हैं.

adBreak() फ़ंक्शन, एक ऐसा प्लेसमेंट तय करता है जहां विज्ञापन दिखाया जा सकता है. कोई विज्ञापन दिखेगा या नहीं, यह इन जैसे फ़ैक्टर पर निर्भर करता है:

• विज्ञापन प्लेसमेंट का वह टाइप जिसे आपने चुना है
  • क्या यह विज्ञापन गेम की शुरुआत में दिखाया गया है? क्या लेवल के बीच में? जब खिलाड़ी ने गेम को रोका हो?
• क्या मौजूदा प्लेयर के लिए कोई सही विज्ञापन मौजूद है
  • क्या यह विज्ञापन उनके काम का है?
  • क्या यह उनकी डेटा की निजता और सहमति से जुड़ी सेटिंग के मुताबिक है?
• हाल ही में प्लेयर ने कितने विज्ञापन देखे हैं
• इस गेम के लिए कॉन्फ़िगर की गई कंट्रोल सेटिंग—उदाहरण के लिए, विज्ञापन दिखाने की फ़्रीक्वेंसी
  • टैग में संकेतों के तौर पर या
  • AdSense में—ध्यान दें कि AdSense में उपलब्ध कंट्रोल समय के साथ बेहतर होते जाएंगे.

किस तरह का विज्ञापन दिखाया जाएगा, यह भी इन्हीं बातों पर निर्भर करता है.

ध्यान दें कि adBreak() पर कॉल करने पर, हो सकता है कि कोई विज्ञापन न दिखे. यह सिर्फ़ ऐसी जगह के बारे में बताता है जहां विज्ञापन दिखाया जा सकता है.

यह पारंपरिक एपीआई से अलग है. पारंपरिक एपीआई में, आपके कोड को हमेशा पता होता है कि कोई विज्ञापन उपलब्ध है या नहीं. साथ ही, गेम में यह तय किया जाता है कि विज्ञापन दिखाना है या नहीं. इस तरीके में, Ad Placement API यह तय करता है कि किसी विज्ञापन को किसी खास प्लेसमेंट में दिखाया जाए या नहीं. इसे कभी-कभी "इनवर्ज़न ऑफ़ कंट्रोल" भी कहा जाता है.

हम अपने गेम के एपीआई को इस मॉडल पर इसलिए माइग्रेट कर रहे हैं, क्योंकि इससे आपको अपने गेम में कम कोड लिखना पड़ता है. दूसरा, इससे नीति का पालन करने वाले प्लेसमेंट को बेहतर उपयोगकर्ता अनुभव के साथ डिलीवर करना आसान हो जाता है. इससे हमें गेम पब्लिशर को सबसे अच्छा परफ़ॉर्म करने वाले कुछ फ़ॉर्मैट डिलीवर करने में मदद मिली है. आखिर में, यह आपके गेम में विज्ञापन दिखाने की प्रोसेस को, कमाई करने से जुड़े फ़ैसलों से अलग करता है. जैसे, किस तरह के और कितने विज्ञापन दिखाने हैं.

हम चाहते हैं कि आप कमाई करने की सेटिंग में बदलाव कर सकें और उपयोगकर्ता अनुभव को कंट्रोल कर सकें. इसके लिए, आपको अपने गेम के नए वर्शन में बदलाव करके उसे रिलीज़ करने की ज़रूरत नहीं होगी. इसके लिए, आपको टैग में हिंट देने होंगे. हालांकि, आने वाले समय में हम AdSense और AdMob के फ़्रंटएंड में सीधे तौर पर कंट्रोल उपलब्ध करा पाएंगे.

मध्यवर्ती विज्ञापन

पेज पर अचानक दिखने वाला विज्ञापन, फ़ुल स्क्रीन पर दिखने वाला विज्ञापन होता है. यह आपके गेम में अलग-अलग समय पर दिख सकता है. जैसे, जब खिलाड़ी गेम शुरू करता है या जब वह कोई लेवल पूरा कर लेता है. इससे गेम रुक जाता है और पूरा दस्तावेज़ कवर हो जाता है. साथ ही, खिलाड़ी के पास विज्ञापन पर क्लिक करने का विकल्प होता है. ऐसा करने पर, विज्ञापन उनके ब्राउज़र के किसी दूसरे टैब में दिखता है. इसके अलावा, खिलाड़ी के पास विज्ञापन को खारिज करने का विकल्प भी होता है. ऐसा करने पर, वे गेम खेलना जारी रख सकते हैं.

ध्यान दें: इंटरस्टीशियल विज्ञापन, गेम का यूज़र इंटरफ़ेस लोड होने से पहले भी दिखाया जा सकता है. इस तरह के विज्ञापन को प्रीरोल विज्ञापन कहा जाता है. इसे सामान्य इंटरस्टीशियल विज्ञापनों से थोड़ा अलग तरीके से मैनेज करना होता है. प्री-रोल विज्ञापनों के बारे में ज़्यादा जानें

इंटरस्टीशियल विज्ञापन दिखाने के लिए, प्लेसमेंट कॉन्फ़िगरेशन में ये फ़ील्ड भरें:

adBreak({
   type: 'start',           // The type of this placement
   name: 'game_started',    // A descriptive name for this placement
   beforeAd: beforeAd,      // Prepare for the ad. Mute and pause the game flow
   afterAd: afterAd,        // Resume the game and un-mute the sound
   adBreakDone: breakDone,  // Always called (if provided) even if an ad didn't show
});

type आर्ग्युमेंट ज़रूरी है. हमारा सुझाव है कि आप अपने प्लेसमेंट को हमेशा नाम दें. अन्य कॉलबैक ज़रूरी नहीं हैं.

कॉल सीक्वेंस

इंटरस्टीशियल विज्ञापन के लिए कॉल सीक्वेंस की समीक्षा करें.

ब्यौरा

पेज पर अचानक दिखने वाला विज्ञापन – कॉल के क्रम की पूरी जानकारी
आपका H5 गेम	Ad Placement API
	विज्ञापनों को शुरू करना और पहले से लोड करना
गेम खेलना
विज्ञापन दिखाने का अच्छा मौका... adBreak() →
	कोई विज्ञापन उपलब्ध है और उसे दिखाने का यह सही समय है... ← beforeAd()
गेम रुक जाता है, आवाज़ बंद हो जाती है, और विज्ञापन दिखाने के लिए तैयार हो जाता है. return को एपीआई →
	Ad Placement API, अचानक दिखने वाला विज्ञापन रेंडर करता है. प्लेयर, विज्ञापन पर क्लिक कर सकता है. यह विज्ञापन एक नए टैब में दिखता है. गेम खेलना जारी रखने के लिए, उन्हें विज्ञापन खारिज करना होगा.
	← afterAd() को तब कॉल किया जाता है, जब कोई विज्ञापन दिखाया गया हो
इससे गेम अनपॉज़ हो जाता है और आवाज़ चालू हो जाती है.
	← adBreakDone()adBreakDone() को हमेशा कॉल किया जाता है. भले ही, कोई विज्ञापन न दिखाया गया हो
गेम, इस प्लेसमेंट के बारे में आंकड़ों की जानकारी लॉग करता है.

नोट

• adBreak() एक एसिंक्रोनस फ़ंक्शन है, जो तुरंत जवाब देता है.
• अगर किसी प्लेसमेंट के लिए कोई विज्ञापन नहीं है, तो किसी भी कॉलबैक को कॉल नहीं किया जाता. इसका मतलब है कि beforeAd(),afterAd() में से किसी को भी कॉल नहीं किया जाता.
• विज्ञापन दिखाए जाने के दौरान, गेम चलता न रहे, इसके लिए beforeAd() कॉलबैक का इस्तेमाल करें. इससे आवाज़ बंद हो जाएगी और गेम रुक जाएगा.
• beforeAd() सिंक्रोनस है. इसलिए, Ad Placement API तब तक विज्ञापन नहीं दिखाएगा, जब तक यह वापस नहीं आ जाता.
• गेम को रीस्टार्ट करें और afterAd() कॉल आने पर आवाज़ को अनम्यूट करें.
• अगर यह उपलब्ध है, तो adBreakDone() को हमेशा कॉल किया जाता है. भले ही, इस प्लेसमेंट में कोई विज्ञापन न दिखाया गया हो.
• कोई दूसरा विज्ञापन दिखाए जाने के दौरान adBreak() को कॉल करने पर, यह काम नहीं करेगा. साथ ही, JavaScript कंसोल पर एक चेतावनी दिखेगी.

वीडियो से पहले दिखने वाले विज्ञापन

प्रीरोल, पेज पर अचानक दिखने वाला ऐसा विज्ञापन होता है जो आपके गेम का यूज़र इंटरफ़ेस (यूआई) लोड होने से पहले दिखता है. यह वह इमेज होती है जो किसी खिलाड़ी को आपके गेम पर जाने के बाद सबसे पहले दिखती है. पेज लोड होने के दौरान, प्रीरोल विज्ञापन बहुत पहले ही दिखने लगता है. साथ ही, आपका गेम अभी तक नहीं दिखता. इसलिए, गेम को रोकने और म्यूट करने के लिए सामान्य कॉल की ज़रूरत नहीं होती. इसके बजाय, adBreakDone() कॉलबैक का इस्तेमाल करके, विज्ञापन के साथ गेम को क्रम से शुरू किया जाता है. इसका मतलब है कि यूज़र इंटरफ़ेस (यूआई) रेंडर किया जाता है और आवाज़ चलना शुरू होती है. हर पेज लोड के लिए, सिर्फ़ एक प्रीरोल ट्रिगर किया जा सकता है.

कॉल सीक्वेंस

पेज लोड होने के दौरान, प्रीरोल के लिए कॉल बहुत पहले किया जाता है. इस समय, आपके गेम का यूज़र इंटरफ़ेस (यूआई) रेंडर नहीं हुआ है. इसलिए, आपको beforeAd() और afterAd() कॉलबैक पास नहीं करने चाहिए. इसके बजाय, प्लेसमेंट के बाद अपना गेम शुरू करने के लिए adBreakDone() कॉलबैक का इस्तेमाल करें. ऐसा इसलिए, क्योंकि विज्ञापन न होने पर भी इसे कॉल किया जाता है.

गेम लॉजिक में इस कोड को पहले कॉल करने पर, प्रीरोल विज्ञापन दिखाया जाएगा. इस कोड को कॉल करने से पहले, आपका यूज़र इंटरफ़ेस (यूआई) रेंडर नहीं होना चाहिए.

// Game must not be running.
// Nothing in the game area should be clickable
adBreak({
   type: ‘preroll',
   adBreakDone: startGame,
})

प्रीरोल – कॉल के क्रम की पूरी जानकारी
आपका H5 गेम	Ad Placement API
	एपीआई शुरू होता है और विज्ञापनों की प्री-कैशिंग शुरू होती है
चल रहा है, लेकिन शुरू नहीं हुआ है और न ही कोई यूज़र इंटरफ़ेस (यूआई) दिखाया गया है
adBreak(type:'preroll',…) →
	Ad Placement API, विज्ञापनों को लोड करने और शुरू करने की प्रोसेस पूरी करता है. अगर कोई विज्ञापन मौजूद है, तो उसे दिखाया जाता है. प्लेयर, विज्ञापन पर क्लिक कर सकता है. यह विज्ञापन एक नए टैब में दिखता है. गेम शुरू करने के लिए, उन्हें इसे खारिज करना होगा.
	← adBreakDone() को हमेशा कॉल किया जाता है (भले ही कोई विज्ञापन न दिखाया गया हो)
गेम के यूज़र इंटरफ़ेस (यूआई) को स्क्रीन पर रेंडर किया जाता है. अब खिलाड़ी इससे इंटरैक्ट कर सकता है. गेम, adBreakDone() को पास किए गए placementInfo ऑब्जेक्ट का इस्तेमाल अपनी ज़रूरत के हिसाब से कर सकता है. उदाहरण के लिए, अतिरिक्त आंकड़ों को लॉग करने के लिए.

नोट

• वीडियो शुरू होने से पहले दिखने वाला विज्ञापन, हमेशा विज्ञापनों को पहले से लोड करने की कोशिश करेगा:
  • प्रीरोल के साथ adConfig(preloadAds: ‘on') को कॉल करने की ज़रूरत नहीं होती.
• विज्ञापन प्लेसमेंट के अन्य विकल्पों की तरह, प्री-रोल विज्ञापन में विज्ञापन दिख सकता है या नहीं भी दिख सकता.
• beforeAd() और afterAd() को प्रीरोल विज्ञापन में पास नहीं किया जाना चाहिए.
  • प्री-रोल विज्ञापन, गेम शुरू होने से पहले दिखाए जाते हैं. इसलिए, गेम की आवाज़ को रोकने या बंद करने की ज़रूरत नहीं होती.
  • अगर प्रीरोल के साथ beforeAd() या afterAd() पास किया जाता है, तो कॉल पूरा नहीं होगा. साथ ही, JavaScript कंसोल में गड़बड़ी लॉग की जाएगी.
• वीडियो शुरू होने से पहले दिखने वाला विज्ञापन, Ad Placement API के शुरू होने का इंतज़ार करता है. साथ ही, विज्ञापन पहले से लोड हो जाते हैं:
  • हालांकि, इसमें दो सेकंड का टाइमआउट होता है. इससे कॉल में अनिश्चित काल तक देरी नहीं होती. इससे यह पक्का होता है कि adBreakDone() को सही समय पर कॉल किया गया है और आपका गेम शुरू हो गया है.
  • adBreakDone() को हमेशा कॉल किया जाता है, भले ही कोई विज्ञापन न हो.
• हमारा सुझाव है कि गेम शुरू होने से पहले विज्ञापन दिखाने के लिए, प्रीरोल का इस्तेमाल करें.
  • इसके अलावा, onReady() adConfig() का इस्तेमाल करके, गेम के लॉजिक को एपीआई के शुरू होने और विज्ञापनों के प्रीलोड होने के साथ क्रम से लगाया जा सकता है.

इनाम वाले विज्ञापन

इनाम वाले विज्ञापन की मदद से, खिलाड़ियों को ऐप्लिकेशन में खरीदने के लिए उपलब्ध आइटम, इनाम के तौर पर दिए जा सकते हैं. हालांकि, ऐसा तब किया जाता है, जब वे कोई विज्ञापन देखते हैं. हालांकि, इंटरस्टीशियल विज्ञापन ऑप्ट-आउट होते हैं. इनमें प्लेयर को विज्ञापन दिखाया जाता है और उसके पास इसे खारिज करने का विकल्प होता है. इनाम वाले विज्ञापन, ऑप्ट-इन होते हैं. कोई खिलाड़ी यह चुनता है कि उसे इनाम पाने के लिए विज्ञापन देखना है या नहीं. साथ ही, वह यह भी चुनता है कि उसे विज्ञापन कब देखना है.

पेज पर अचानक दिखने वाले विज्ञापनों में, प्लेयर किसी भी समय विज्ञापन को खारिज कर सकता है. हालांकि, इनाम पाने के लिए उसे विज्ञापन को कम से कम कुछ समय तक देखना होगा. यह समय, दिखाए जा रहे विज्ञापन क्रिएटिव के हिसाब से अलग-अलग हो सकता है.

इनाम वाले विज्ञापन देखना खिलाड़ी के लिए ज़रूरी नहीं होता. इसलिए, इन्हें आपके गेम के फ़्लो में बेहतर तरीके से इंटिग्रेट करना ज़रूरी है. आपको ऐसे फ़ंक्शन देने होंगे जो आपके गेम में इनाम वाला विज्ञापन दिखा सकें. साथ ही, अगर कोई खिलाड़ी विज्ञापन देखता है, तो उसे इनाम दिया जा सके.

इनामों की वैल्यू आपके ऐप्लिकेशन के बाहर नहीं होनी चाहिए. साथ ही, उनकी वैल्यू पैसों में नहीं होनी चाहिए (या उन्हें आसानी से पैसों में नहीं बदला जा सकता). इसके अलावा, उन्हें सामान और सेवाओं के लिए बेचा या बदला नहीं जा सकता. साथ ही, आपको खिलाड़ियों को विज्ञापनों पर क्लिक करने के लिए बढ़ावा नहीं देना चाहिए. ज़्यादा जानकारी के लिए, कृपया इंटरस्टीशियल और इनाम वाले विज्ञापनों से जुड़ी नीति का ड्राफ़्ट देखें.

इनाम पाना खिलाड़ी के लिए ज़रूरी नहीं है. इसलिए, उन्हें अपने गेम में किसी भी जगह जोड़ा जा सकता है. साथ ही, इनका इस्तेमाल इंटरस्टीशियल विज्ञापनों के अलावा भी किया जा सकता है. इंटरस्टीशियल विज्ञापनों की तरह, ये प्लेसमेंट भी इनाम वाले विज्ञापन दिखाने के अवसर होते हैं. विज्ञापन प्लेसमेंट एपीआई, आपके कोड को सिर्फ़ तब कॉल करेगा, जब आपके गेम में किसी खास समय पर इनाम वाला विज्ञापन असल में दिखाया जाएगा.

यहां हमारा मकसद यह है कि आप अपने गेम को AdPlacement API के साथ एक बार इंटिग्रेट कर सकें. इसके बाद, समय के साथ टैग या AdSense में मौजूद कंट्रोल का इस्तेमाल करके, चालू किए गए विज्ञापनों के सटीक मिक्स को बदला जा सकता है. इसके लिए, आपको अपने गेम को फिर से कोड करने और फिर से रिलीज़ करने की ज़रूरत नहीं होगी.

इनाम वाले प्लेसमेंट का टाइप हमेशा 'reward' होता है. साथ ही, प्लेसमेंट कॉन्फ़िगरेशन के सभी फ़ील्ड इस्तेमाल किए जा सकते हैं.

adBreak({
   type: 'reward',                      // The type of this placement
   name: '<name>',                      // A descriptive name for this placement
   beforeAd: () => {},                  // Prepare for the ad. Mute and pause the game flow
   afterAd: () => {},                   // Resume the game and re-enable sound
   beforeReward: (showAdFn) => {},      // Show reward prompt (call showAdFn() if clicked)
   adDismissed: () => {},               // Player dismissed the ad before it finished.
   adViewed: () => {},                  // Player watched the ad–give them the reward.
   adBreakDone: (placementInfo) => {},  // Always called (if provided) even if an ad didn't show
});

मुख्य नए फ़ंक्शन ये हैं: beforeReward() यह ट्रिगर है, जो आपको यह सूचना देता है कि आपको इनाम का प्रॉम्प्ट रेंडर करना चाहिए. इसके अलावा, adViewed() को तब कॉल किया जाता है, जब प्लेयर ने विज्ञापन देख लिया हो, ताकि आप उसे इनाम दे सकें.

इनाम वाले प्लेसमेंट को इस तरह से तय किया जा सकता है:

adBreak({
   type: 'reward',
   name: 'new_life_reward_1',
   beforeAd: pauseGame,
   afterAd: restartGame,
   beforeReward: showRewardPrompt,
   adDismissed: adDismissed,
   adViewed: adViewed,
   adBreakDone: breakDone,
});

इनाम वाले विज्ञापन, आपके गेम में एक प्रॉम्प्ट के साथ शुरू होते हैं. इसमें खिलाड़ी को विज्ञापन देखने पर इनाम देने का ऑफ़र दिया जाता है.

इनाम वाले विज्ञापन के लिए कॉल सीक्वेंस

ब्यौरा

इनाम वाला विज्ञापन – कॉल सीक्वेंस की पूरी जानकारी
आपका H5 गेम	Ad Placement API
	विज्ञापनों को शुरू करना और पहले से कैश मेमोरी में सेव करना
गेम खेलना
adBreak(type:'reward', ... ) →
	विज्ञापन उपलब्ध है, इसलिए इनाम वाले विज्ञापन का प्लेसमेंट शुरू करें. beforeReward() को सिंक्रोनस तरीके से कॉल किया जाता है. इसका मतलब है कि adBreak() को कॉल करने के तुरंत बाद इसे कॉल किया जाता है ← beforeReward(showAdFn)
गेम, इनाम पाने के लिए प्रॉम्प्ट दिखाता है. इससे खिलाड़ी को विज्ञापन देखकर इनाम पाने का मौका मिलता है. एक से ज़्यादा तरह के इनाम दिए जा सकते हैं. उदाहरण के लिए, एक नई लाइफ़ या एक गोल्ड कॉइन. खिलाड़ी के पास इनाम के प्रॉम्प्ट पर क्लिक करने, उन्हें खारिज करने या अनदेखा करने का विकल्प होता है. अगर वे किसी प्रॉम्प्ट पर क्लिक करते हैं, तो गेम उस तरह के इनाम को सेव कर लेता है जिसके लिए उन्होंने अनुरोध किया है. इसके बाद, showAdFn()... अगर इनाम के प्रॉम्प्ट को खारिज कर दिया जाता है या अनदेखा कर दिया जाता है, तो कुछ नहीं होगा. ऐसा तब तक होगा, जब तक इनाम के प्लेसमेंट टाइप के साथ adBreak() को दूसरा कॉल नहीं किया जाता. इस समय, Ad Placement API रीसेट हो जाएगा और इस कॉल से स्थिति को साफ़ कर देगा. अगर ऐप्लिकेशन, पिछले विज्ञापन ब्रेक से showAdFn को कॉल करता है, तो इसका कोई असर नहीं पड़ता.
showAdFn() →
	← beforeAd()
गेम रुक जाता है, आवाज़ बंद हो जाती है, और विज्ञापन दिखाने के लिए तैयार हो जाता है return को एपीआई →
	एपीआई, विज्ञापन दिखाता है. इसमें खारिज करें बटन होता है. साथ ही, यह भी दिखता है कि विज्ञापन में कितना समय बाकी है.
अगर प्लेयर विज्ञापन को खारिज कर देता है, तो...
	← adDismissed()
खिलाड़ी ने विज्ञापन खारिज कर दिया और गेम ने इनाम नहीं दिया.
ELSE the player watches the ad to completion...
	← adViewed()
खिलाड़ी ने पूरा विज्ञापन देखा और गेम ने उसे इनाम दिया. (आम तौर पर, ऐसा गेम की कोई ऐसी स्थिति सेट करके किया जाता है जिसे afterAd() को कॉल करके गेम को रीस्टार्ट करने पर चुना जाता है).
विज्ञापन देखने या खारिज करने के बाद...
	← अगर कोई विज्ञापन दिखाया गया है, तो afterAd() को कॉल किया जाता है
इससे गेम अनपॉज़ हो जाता है और आवाज़ चालू हो जाती है.
	← adBreakDone()adBreakDone() को हमेशा कॉल किया जाता है. भले ही, कोई विज्ञापन न दिखाया गया हो
गेम, इस प्लेसमेंट के बारे में आंकड़ों की जानकारी लॉग करता है.

नोट

• adBreak() एक एसिंक्रोनस फ़ंक्शन है, जो तुरंत जवाब देता है.
• अगर किसी प्लेसमेंट के लिए कोई विज्ञापन नहीं है, तो किसी भी कॉलबैक को कॉल नहीं किया जाता. इसका मतलब है कि beforeAd() और beforeReward() में से किसी को भी कॉल नहीं किया जाता.
• विज्ञापन दिखाए जाने के दौरान, गेम चलता न रहे, इसके लिए beforeAd() कॉलबैक का इस्तेमाल करें. इससे आवाज़ बंद हो जाएगी और गेम रुक जाएगा.
• beforeAd() सिंक्रोनस है. इसलिए, Ad Placement API तब तक विज्ञापन नहीं दिखाएगा, जब तक यह वापस नहीं आ जाता.
• गेम को रीस्टार्ट करें और afterAd() कॉल आने पर आवाज़ को अनम्यूट करें.
• अगर यह उपलब्ध है, तो adBreakDone() को हमेशा कॉल किया जाता है. भले ही, इस प्लेसमेंट में कोई विज्ञापन न दिखाया गया हो.
• कोई दूसरा विज्ञापन दिखाए जाने के दौरान adBreak() को कॉल करने पर, यह काम नहीं करेगा. साथ ही, JavaScript कंसोल पर एक चेतावनी दिखेगी.