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

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

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

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

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

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

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

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

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

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

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

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

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

जेस्चर का उपयोग करके लॉन्च करना

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

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

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

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

Swift

GADMobileAds.sharedInstance().presentAdInspector(from: viewController) { error in
  // Error will be non-nil if there was an issue and the inspector was not displayed.
}

Objective-C

[GADMobileAds.sharedInstance presentAdInspectorFromViewController:viewController
  completionHandler:^(NSError *error) {
    // Error will be non-nil if there was an issue and the inspector was not displayed.
}];

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

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

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

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

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

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

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

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

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

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

ज़रूरी शर्तें: Google Mobile Ads SDK 8.5.0 या बेहतर

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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