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

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

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

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

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

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

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

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

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

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

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

• AdMob खाता बनाएं और ऐप्लिकेशन सेट अप करें.

• शुरुआती निर्देशों की गाइड को पूरा करें.

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

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

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

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

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

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

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

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

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

ध्यान दें: टेस्ट विज्ञापन का अनुरोध करें सुविधा का इस्तेमाल करने के लिए, Activity कॉन्टेक्स्ट के साथ Google Mobile Ads SDK टूल को शुरू करें.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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