विज्ञापन जांचने वाला टूल


विज्ञापन जांचने वाला टूल ऐप्लिकेशन में मौजूद एक ओवरले है. इससे अनुमति पा चुके डिवाइसों को मोबाइल ऐप्लिकेशन में विज्ञापन दिखाने के अनुरोधों को टेस्ट करने के लिए, रीयल-टाइम में विश्लेषण करने की सुविधा मिलती है. यह Google Mobile Ads SDK के 9.1.0 और इसके बाद के वर्शन में शामिल है. इसे बिना कोडिंग के चालू किया जा सकता है.

इस गाइड में, विज्ञापन की जांच करने वाले टूल की अलग-अलग सुविधाओं को लॉन्च और इस्तेमाल करने का तरीका बताया गया है.

ज़रूरी शर्तें

विज्ञापन जांचने वाले टूल का इस्तेमाल करने के लिए, आपको ये काम करने होंगे:

  • Google Mobile Ads SDK के 9.1.0 या इसके बाद के वर्शन का इस्तेमाल करें.

विज्ञापन जांचने वाला टूल लॉन्च करना

विज्ञापन जांचने वाले टूल को अपने ऐप्लिकेशन में कहीं से भी इन तरीकों से लॉन्च किया जा सकता है:

  1. टेस्ट डिवाइस रजिस्टर करते समय, AdMob यूज़र इंटरफ़ेस (यूआई) में चुने गए जेस्चर का इस्तेमाल करें.
  2. उपलब्ध कराए गए एपीआई का इस्तेमाल करके, प्रोग्राम के हिसाब से अपने-आप होने वाली प्रोसेस के ज़रिए.
  3. डीबग मेन्यू में मौजूद लॉन्च बटन का इस्तेमाल करें.

हाथ के जेस्चर का इस्तेमाल करके लॉन्च करना

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

AdMob के यूज़र इंटरफ़ेस (यूआई) में कोई जेस्चर सेट करने के बाद, आपको 15 मिनट तक इंतज़ार करना होगा. इसके बाद, आपके ऐप्लिकेशन को Google Mobile Ads SDK के लिए विज्ञापन दिखाने का अनुरोध करना होगा, ताकि वह आपकी जेस्चर सेटिंग के बारे में जान सके. अगर आपने जो जेस्चर सेट किया है वह काम नहीं कर रहा है, तो कोई विज्ञापन लोड करके देखें. इसके बाद, ऐप्लिकेशन को फिर से चालू करें और जेस्चर को फिर से आज़माएं.

प्रोग्राम के हिसाब से लॉन्च करना

विज्ञापन जांचने वाले टूल को प्रोग्राम के हिसाब से भी लॉन्च किया जा सकता है:

यह एपीआई, उन टेस्ट डिवाइसों के लिए काम करता है जिन्हें प्रोग्राम के हिसाब से या AdMob यूज़र इंटरफ़ेस (यूआई) में रजिस्टर किया गया है.

विज्ञापन यूनिट देखना और उनसे जुड़ी समस्याओं को हल करना

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

हमारा सुझाव है कि विज्ञापन जांचने वाले टूल का इस्तेमाल करने से पहले, Google Mobile Ads SDK शुरू करें.

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

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

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

तीसरे पक्ष के विज्ञापन सोर्स के लिए, गड़बड़ी के मैसेज सीधे विज्ञापन सोर्स से भेजे जाते हैं. अगर आपको ज़्यादा जानकारी चाहिए, तो तीसरे पक्ष के विज्ञापन सोर्स से संपर्क करें.

किसी विज्ञापन यूनिट के लिए बिडिंग की जानकारी देखना

अगर आपको बिडिंग के बारे में जानकारी नहीं है, तो खास जानकारी पढ़ें.

एसडीके अनुरोध लॉग में, बिडिंग में हिस्सा लेने वाले उन विज्ञापन सोर्स को देखा जा सकता है जिन्हें विज्ञापन दिखाने के अनुरोध में कॉल किया गया है. बिडिंग नीलामी में शामिल हर विज्ञापन सोर्स की जानकारी देखने के लिए, एसडीके टूल के लिए किए गए अनुरोध के लॉग में मौजूद किसी विज्ञापन यूनिट पर टैप करें.

बिडिंग के नतीजों को इस क्रम में लगाया जाता है, ताकि कार्रवाई की जा सकने वाली चीज़ें सूची में सबसे ऊपर दिखें:

  • सबसे ऊपर, नीलामी जीतने वाले विज्ञापन नेटवर्क का नाम होता है.

  • इसके बाद, उन विज्ञापन नेटवर्क की सूची दी गई है जिनमें समस्याएं हैं. समस्याओं को हल करने के लिए, यहां दिया गया तरीका अपनाएं.

  • इसके बाद, ऐसे विज्ञापन नेटवर्क होते हैं जिन्होंने कोई विज्ञापन नहीं दिखाया या बिड नहीं लगाई. इससे विज्ञापन सोर्स से जुड़ी कई समस्याओं का पता चल सकता है. ऐसा हो सकता है कि विज्ञापन सोर्स ने अपने सेटअप या फ़ैसले की वजह से बिड न की हो. विज्ञापन सोर्स की सेटअप गाइड देखें या सहायता पाने के लिए, सीधे विज्ञापन सोर्स से संपर्क करें.

  • आखिर में, सूची में सबसे नीचे ऐसे विज्ञापन नेटवर्क होते हैं जो बिडिंग नीलामी हार गए.

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

जब किसी विज्ञापन सोर्स को मीडिएशन वॉटरफ़ॉल में कॉल किया जाता है, तब वह विज्ञापन दिखा पाता है. मीडिएशन वॉटरफ़ॉल के साथ बिडिंग के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, मीडिएशन ग्रुप में बिडिंग और वॉटरफ़ॉल विज्ञापन सोर्स के उदाहरण 2 और उदाहरण 3 देखें.

विज्ञापन यूनिट की ऐडवांस डीबगिंग

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

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

उपलब्ध अडैप्टर देखना

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

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

अगर अडैप्टर नहीं मिलता है या शुरू नहीं होता है, तो ज़्यादा जानकारी के लिए, विज्ञापन जांचने वाले टूल का इस्तेमाल करके समस्याओं को हल करना लेख पढ़ें.

अपनी विज्ञापन यूनिट की जांच करना

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

विज्ञापन की टेस्टिंग

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

जब आपको अपनी विज्ञापन यूनिट की जांच करनी हो, तब विज्ञापन जांचने वाले टूल की स्क्रीन पर सबसे ऊपर मौजूद, टेस्ट विज्ञापन का अनुरोध करें बटन पर टैप करें. इससे, विज्ञापन जांचने वाले टूल की मदद से विज्ञापन की जांच शुरू हो जाएगी. इसके बाद, टेस्ट के नतीजे SDK टूल के लिए किए गए अनुरोध के लॉग में, विज्ञापन जांचने वाले टूल से अनुरोध किया गया हेडर के नीचे दिखते हैं.

अपने ऐप्लिकेशन में विज्ञापन जांचने वाले टूल को इस्तेमाल करने का तरीका जानें

विज्ञापन के किसी एक सोर्स को टेस्ट करना

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

इस सुविधा को चालू करने के लिए, स्क्रीन पर सबसे नीचे मौजूद विज्ञापन के किसी एक सोर्स को टेस्ट करना स्विच को टॉगल करें. इससे विज्ञापन सोर्स चुनने का यह डायलॉग दिखता है:

किसी एक विज्ञापन सोर्स को टेस्ट करने से पहले, आपको Google Mobile Ads SDK का इस्तेमाल शुरू करना होगा.

इसके बाद, टेस्ट करने के लिए कोई एक विज्ञापन सोर्स चुना जा सकता है. विज्ञापन सोर्स चुनने के बाद, यह स्क्रीन दिखती है:

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

ऐप्लिकेशन को रीस्टार्ट करने के बाद, सभी विज्ञापन यूनिट प्लेसमेंट में सिर्फ़ चुने गए नेटवर्क का विज्ञापन दिखाने की कोशिश की जाती है. विज्ञापन के किसी एक सोर्स का टेस्ट चालू होने पर, विज्ञापन जांचने वाले टूल को लॉन्च करने से, चालू टेस्ट विज्ञापन सोर्स दिखता है:

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

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

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

विज्ञापन के किसी एक सोर्स को टेस्ट करने की सुविधा बंद करना

टेस्ट को रोकने के लिए, स्विच को टॉगल करके बंद करें:

इसके बाद, रीस्टार्ट करने की स्क्रीन पर पुष्टि करने वाला यह मैसेज दिखता है:

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

निजता सेटिंग डीबग करना

ज़रूरी शर्तें: Google Mobile Ads SDK का 9.6.0 या इसके बाद का वर्शन

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

  • जीडीपीआर लागू होता है (IABTCF_gdprApplies)
  • अतिरिक्त सहमति वाली स्ट्रिंग (IABTCF_AddtlConsent)
  • टीसी स्ट्रिंग (IABTCF_TCString)

विज्ञापन जांचने वाले टूल में, विज्ञापन लोड करने या विज्ञापन की जांच करने के बाद, एसडीके टूल के लिए किए गए अनुरोध का लॉग में जाकर, अनुरोध पर मौजूद मेन्यू आइकॉन पर टैप करें. इसके बाद, निजता के सिग्नल विकल्प चुनें.

निजता सिग्नल स्क्रीन पर, विज्ञापन अनुरोध में पास किए गए निजता सिग्नल दिखते हैं.

एसी स्ट्रिंग के बारे में ज़्यादा जानने के लिए, Google की अतिरिक्त सहमति वाली स्ट्रिंग की तकनीकी जानकारी देखें. टीसी स्ट्रिंग में सहमति की विस्तृत जानकारी देखने के लिए, जैसे सीएमपी आईडी और IAB से जुड़े, सहमति वाले वेंडर आइडेंटिफ़ायर की सूची, डिकोड करें पर क्लिक करें. ऐसा करने से, IAB GPP एन्कोडर / डिकोडर खुल जाएगा.

अगर आपको कोई गड़बड़ी दिखती है, तो उसे ठीक करने के लिए निजता से जुड़ी समस्याओं को समझना लेख में दिया गया तरीका अपनाएं.

डीबग करने से जुड़े सभी आउटपुट कॉपी करें

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

इसके लिए, ऐप्लिकेशन के आइकॉन पर सात बार टैप करें. इसके बाद, आपको यह मैसेज दिखेगा: विज्ञापन की जांच करने वाले टूल के JSON को क्लिपबोर्ड पर कॉपी किया गया.