adBreak()
पर किए जाने वाले सभी कॉल को प्लेसमेंट का प्रकार तय करना होगा. यह एक स्ट्रिंग होती है, जो विज्ञापन दिखाए जाने के समय से
आपके गेम की स्थिति के बारे में बताती है. क्या आपका गेम अभी
लोड हो रहा है? क्या खिलाड़ी ने गेम खेलने पर रोक लगा दी है? या क्या वे आपके गेम के किसी ऐसे पॉइंट पर पहुंच गए हैं जहां उन्हें इनाम दिया जा सकता है?
आप जिस तरह का इस्तेमाल करते हैं वह अहम होता है. इससे सीधे तौर पर दिखाए जाने वाले विज्ञापन अनुभव पर असर पड़ सकता है (पेज पर अचानक दिखने वाले विज्ञापन बनाम इनाम वाले विज्ञापन). हालांकि, एपीआई के व्यवहार पर इसके कम असर भी पड़ सकते हैं. यह ज़रूरी है कि आप सही तरह से प्लेसमेंट टाइप बताएं, ताकि एपीआई सही तरीके से काम कर सके.
प्लेसमेंट प्रकार | ब्यौरा |
---|---|
'preroll' |
आपके गेम का UI लोड नहीं हुआ है और वह आवाज़ नहीं चला रहा है. हर गेम के लोड होने पर, आपके गेम में सिर्फ़ एक 'प्रीरोल' प्लेसमेंट हो सकता है. उदाहरण: गेम कैटलॉग में खिलाड़ी आपके गेम पर क्लिक करता है. गेम कैनवस दिखाया जाता है. इससे पहले, आपका गेम अपने यूज़र इंटरफ़ेस (यूआई) को रेंडर करता है या आवाज़ दिखाने की सुविधा चालू करता है. प्लेयर, विज्ञापन पर क्लिक कर सकता है या उसे खारिज कर सकता है. इसके बाद, गेम शुरू हो जाएगा. |
'start' |
आपका गेम लोड हो गया है, यूज़र इंटरफ़ेस (यूआई) दिख रहा है और आवाज़ चालू है, प्लेयर गेम से इंटरैक्ट कर सकता है, लेकिन गेम अभी तक शुरू नहीं हुआ है. उदाहरण: आप कुछ समय के लिए कॉन्टेंट लोड हो रहे हैं और कोटेशन लोड कर रहे हैं..." और पेज पर अचानक दिखने वाला विज्ञापन दिख रहा है. प्लेयर, विज्ञापन पर क्लिक करके या उसे खारिज करके गेम जारी रख सकता है. ध्यान दें: किसी start प्लेसमेंट के मुकाबले, preroll आपके लिए काफ़ी ज़्यादा काम करता है. preroll में, एपीआई के विज्ञापनों के शुरू होने और अपने-आप लोड होने का इंतज़ार किया जाता है. गेम रेंडर होने के दौरान, यूज़र इंटरफ़ेस (यूआई) रेंडर होने से पहले दिखाए जाने वाले पहले विज्ञापन के लिए, आपको start के बजाय preroll का इस्तेमाल करना चाहिए. जब आपका यूज़र इंटरफ़ेस (यूआई) रेंडर हो जाता है और खिलाड़ी गेम के साथ इंटरैक्ट कर पाता है, तो start बेहतर प्लेसमेंट होता है.start का इस्तेमाल गेम के रीस्टार्ट होने पर भी किया जा सकता है—हर पेज लोड होने पर एक से ज़्यादा start प्लेसमेंट हो सकते हैं. अगर start प्लेसमेंट आपके गेम में सबसे पहला प्लेसमेंट है (यानी कि आप preroll प्लेसमेंट का इस्तेमाल नहीं करते, तो आपको मैन्युअल तौर पर अनुरोध करना पड़ सकता है कि विज्ञापन पहले से लोड किए गए हैं. |
'pause' |
इसके बाद, खिलाड़ी गेम को रोक देता है. उदाहरण: खिलाड़ी गेम को रोक देता है और पेज पर अचानक दिखने वाला विज्ञापन दिखता है. विज्ञापन स्क्रीन पर तब तक बना रहता है, जब तक प्लेयर उसे खारिज न कर दे. जब वह व्यक्ति गेम लौटता है, तब भी गेम रुक जाता है. इसके बाद, खिलाड़ी गेम फिर से शुरू कर सकता है और खेलना जारी रख सकता है. |
'next' |
खिलाड़ी अगले लेवल पर जाता है. उदाहरण: खिलाड़ी ने अभी-अभी एक लेवल पूरा किया है. वह किसी बटन पर टैप करता है और अगला लेवल..." पेज पर अचानक दिखने वाला विज्ञापन दिखाया जाता है. वे विज्ञापन को देखते हैं, उसे खारिज करते हैं, और अगले लेवल पर जाते हैं. |
'browse' |
खिलाड़ी, गेमप्ले से बाहर के विकल्पों को एक्सप्लोर करता है. उदाहरण: खिलाड़ी अपने किरदार का स्टाइल बदलना चाहता है. वे बटन और कोट;विकल्प..." पर टैप करते हैं; तो पेज पर अचानक दिखने वाला विज्ञापन दिखाया जाता है. वे विज्ञापन देखते हैं, उसे खारिज करते हैं, और कैरेक्टर एडिटर पर जाते हैं. |
'reward' |
इन गेम में खिलाड़ी, पॉइंट के ज़रिए खेल सकता है. उसे इनाम दिया जा सकता है. उदाहरण: खिलाड़ी की अभी-अभी मौत हो गई है और वह खत्म हो चुका है. अगर दर्शक विज्ञापन देखते हैं, तो उन्हें बोनस के तौर पर कुछ समय का मौका मिलता है. विज्ञापन प्लेसमेंट एपीआई, प्लेयर को इनाम देने के लिए आपके कोड को कॉल करता है. वे इनाम बटन पर टैप करते हैं और पूरा वीडियो विज्ञापन देखते हैं. इसके बाद, उन्हें एक नई ज़िंदगी मिलती है और वे खेलना जारी रखते हैं. |
ध्यान दें: प्लेसमेंट टाइप का यह सेट, चालू डेवलपमेंट का एक हिस्सा है.
अगर आपके गेम में ऐसे प्लेसमेंट हैं जो इनमें से किसी भी कैटगरी में नहीं आते, तो अपने Google खाता मैनेजर को बताएं. हम समय के साथ इस कैटगरी का इस्तेमाल करेंगे.