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

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

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

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

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

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

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

  • मोबाइल विज्ञापन Flutter प्लग इन वर्शन 1.3.0 या बाद के वर्शन का इस्तेमाल करें.

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

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

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

डीबग मेन्यू का इस्तेमाल करके लॉन्च करना

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

अगर आपने डिवाइस को लिंक नहीं किया है, तो आपसे Ad Manager खाते में साइन इन करने के लिए कहा जा सकता है.

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

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

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

MobileAds.instance.openAdInspector(
  (AdInspectorError? error) {
    // Error will be non-null if ad inspector closed due to an error.
  });

यह एपीआई, प्रोग्राम के हिसाब से रजिस्टर किए गए प्रोग्राम के हिसाब से.

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

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

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

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

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

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

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

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

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

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

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

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

  • आगे, समस्याओं वाली विज्ञापन नेटवर्क कंपनियों के बारे में बताया गया है. यहां दिए गए निर्देशों का पालन करें: bidding अक्सर पूछे जाने वाले सवालों के आखिर में समस्याओं को हल करने का तरीका.

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

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

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

मीडिएशन वॉटरफ़ॉल, एक ही इन्वेंट्री के लिए प्रतिस्पर्धा करने वाले कई यील्ड ग्रुप का नतीजा होता है. एक यील्ड ग्रुप में ज़्यादा से ज़्यादा 10 तीसरे पक्ष के यील्ड पार्टनर जोड़े जा सकते हैं. इसमें ओपन बिडिंग ईल्ड पार्टनर और मोबाइल ऐप्लिकेशन ईल्ड पार्टनर के लिए मीडिएशन, दोनों शामिल हैं.

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

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

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

Android
iOS

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

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

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

Android
iOS

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

किसी एक विज्ञापन स्रोत की जांच को रोकना

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

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

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

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

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

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