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

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

Mobile Ads SDK के 20.2.0 से पहले के वर्शन में, विज्ञापन जांचने वाले टूल का इस्तेमाल करके ये काम किए जा सकते हैं:

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

मोबाइल विज्ञापन SDK के 20.2.0 और इसके बाद के वर्शन के लिए, ये काम भी किए जा सकते हैं:

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

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

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

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

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

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

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

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

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

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

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

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

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

Java

MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
  public void onAdInspectorClosed(@Nullable AdInspectorError error) {
    // Error will be non-null if ad inspector closed due to an error.
  }
});

Kotlin

MobileAds.openAdInspector(context) { error ->
  // Error will be non-null if ad inspector closed due to an error.
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

विज्ञापन यूनिट की बेहतर तरीके से डीबग करना

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

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

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

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

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

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

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

विज्ञापन की जांच

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

डीबगिंग के पूरे आउटपुट कॉपी करना

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

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