चेतावनी}
विज्ञापन जांचने वाला टूल
एक इन-ऐप्लिकेशन ओवरले है. इसकी मदद से, अनुमति वाले डिवाइसों पर, सीधे मोबाइल ऐप्लिकेशन में टेस्ट विज्ञापन अनुरोधों का रीयल-टाइम विश्लेषण किया जा सकता है.
यह Google Mobile Ads SDK टूल के 20.2.0 और उसके बाद के वर्शन में शामिल है. इसे चालू करने के लिए, कोडिंग की ज़रूरत नहीं होती.
विज्ञापन जांचने वाले टूल का इस्तेमाल करके, ये काम किए जा सकते हैं:
अपनी विज्ञापन यूनिट की जांच करना
यह पता करना कि आपके विज्ञापन उम्मीद के मुताबिक दिखाए जा रहे हैं या नहीं
गड़बड़ियों की पहचान करके, उन्हें हल करने के बारे में जानकारी देखना
हर अनुरोध के हिसाब से, बिडिंग में हिस्सा लेने वाले हर विज्ञापन नेटवर्क की जानकारी देखना
हर अनुरोध के हिसाब से, हर विज्ञापन नेटवर्क के लिए मीडिएशन की जानकारी देखना
तीसरे पक्ष की बिडिंग या वॉटरफ़ॉल मीडिएशन विज्ञापन स्रोतों को अलग-अलग टेस्ट करना
पुष्टि करें कि आपने बिडिंग और वॉटरफ़ॉल मीडिएशन के लिए, हर विज्ञापन यूनिट को सही तरीके से कॉन्फ़िगर किया है
इस गाइड में, विज्ञापन जांचने वाले टूल में अलग-अलग सुविधाओं को लॉन्च और इस्तेमाल करने का तरीका बताया गया है.
ज़रूरी शर्तें
विज्ञापन जांचने वाले टूल का इस्तेमाल करने के लिए, आपको:
Google Mobile Ads SDK टूल के 20.2.0 या इसके बाद के वर्शन का इस्तेमाल करें.
विज्ञापन जांचने वाला टूल लॉन्च करें
विज्ञापन जांचने वाले टूल को आपके ऐप्लिकेशन में कहीं से भी इन तरीकों से लॉन्च किया जा सकता है:
डीबग मेन्यू में जाकर, लॉन्च बटन का इस्तेमाल करें.
विज्ञापन जांचने वाले टूल की सेटिंग में चुने गए हाथ के जेस्चर का इस्तेमाल करें.
प्रोग्राम के हिसाब से, दिए गए एपीआई का इस्तेमाल करके.
डीबग मेन्यू से Ad Inspector को लॉन्च करने के लिए, आपको अपने ऐप्लिकेशन में कोई बदलाव करने की ज़रूरत नहीं है. इसके लिए, बस अपने Ad Manager नेटवर्क से दिखाया गया कोई विज्ञापन ढूंढें और डीबग मेन्यू खोलने के लिए, विज्ञापन को दो उंगलियों से दबाकर रखें . इसके बाद, विज्ञापन जांचने वाला टूल खोलें चुनें.
अगर आपने अपना डिवाइस लिंक नहीं किया है , तो आपसे Ad Manager खाते में साइन इन करने के लिए कहा जा सकता है.
डीबग सेटिंग में जाकर, विज्ञापन जांचने वाले टूल की सेटिंग भी चुनी जा सकती है. साथ ही, ऐसा जेस्चर भी चुना जा सकता है जिससे आने वाले समय में, डीबग मेन्यू में जाए बिना विज्ञापन जांचने वाला टूल खोला जा सके.
प्रोग्राम के हिसाब से लॉन्च करना
विज्ञापन जांचने वाले टूल को प्रोग्राम के हिसाब से भी लॉन्च किया जा सकता है:
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.
}
यह एपीआई, प्रोग्राम के हिसाब से रजिस्टर किए गए
टेस्ट डिवाइसों के लिए काम करता है.
विज्ञापन यूनिट देखना और उनसे जुड़ी समस्या हल करना
लॉन्च होने के बाद, विज्ञापन जांचने वाले टूल की मुख्य स्क्रीन दिखती है. इसमें उन सभी विज्ञापन यूनिट की सूची होती है जिनके लिए डिवाइस ने विज्ञापन अनुरोध किए हैं. ऐसा तब होता है, जब ऐप्लिकेशन सेशन के दौरान विज्ञापन जांचने वाला टूल चालू किया गया हो. इस सूची में ऐसी विज्ञापन यूनिट भी होती हैं जिनकी बिडिंग चालू होती है. साथ ही, उन्हें
सबसे ज़्यादा बार स्वीकार किए गए अनुरोधों के साथ, क्रम से सबसे ऊपर रखा जाता है और
जिनके लिए विज्ञापन अनुरोध पूरा नहीं होता (डिम किया गया):
हमारा सुझाव है कि विज्ञापन जांचने वाले टूल का इस्तेमाल करने से पहले, Google Mobile Ads SDK टूल को शुरू करें .
किसी विज्ञापन यूनिट पर SDK टूल के अनुरोध की जानकारी देखने के लिए, उस विज्ञापन यूनिट पर टैप करें. इसमें हाल के विज्ञापन अनुरोधों के लिए, विज्ञापन के दिखाए जाने तक मीडिएशन वॉटरफ़ॉल का ब्यौरा दिया जाता है या विज्ञापन दिखाए बिना वॉटरफ़ॉल खत्म होने की जानकारी होती है.
ज़ाहिर करने के इंडिकेटर का इस्तेमाल करके, हर अनुरोध को बड़ा किया जा सकता है. इससे उस अनुरोध के लिए, मीडिएशन वॉटरफ़ॉल के नतीजे दिखेंगे. साथ ही, उस अनुरोध के लिए लागू होने वाली गड़बड़ी और इंतज़ार का समय भी दिखेगा.
तीसरे पक्ष के विज्ञापन स्रोतों के लिए, गड़बड़ी के मैसेज सीधे विज्ञापन स्रोत से भेजे जाते हैं. ज़्यादा जानकारी के लिए, अपने तीसरे पक्ष के विज्ञापन स्रोत से संपर्क करें.
किसी विज्ञापन यूनिट के लिए बिडिंग की जानकारी देखना
अगर आपको बिडिंग के बारे में जानकारी नहीं है, तो ओपन बिडिंग के बारे में जानकारी लेख पढ़ें.
SDK टूल के अनुरोध के लॉग में, बिडिंग में हिस्सा लेने वाले उन विज्ञापन स्रोतों को देखा जा सकता है जिन्हें विज्ञापन अनुरोध में कॉल किया गया है. बिडिंग नीलामी में हर विज्ञापन सोर्स की जानकारी देखने के लिए, SDK टूल के अनुरोध के लॉग में किसी विज्ञापन यूनिट पर टैप करें.
बिडिंग के नतीजों को इस क्रम में लगाया जाता है, ताकि कार्रवाई किए जा सकने वाले आइटम सूची में सबसे ऊपर दिखें:
सबसे ऊपर, नीलामी जीतने वाला विज्ञापन नेटवर्क दिखता है.
इसके बाद, ऐसे विज्ञापन नेटवर्क की जानकारी दी गई है जिनमें समस्याएं हैं. बिडिंग के बारे में अक्सर पूछे जाने वाले सवालों के आखिर में, समस्याओं को हल करने का तरीका दिया गया है.
इसके बाद, ऐसे विज्ञापन नेटवर्क हैं जिन्होंने कोई विज्ञापन नहीं दिखाया या जिन्होंने बिड नहीं लगाई. इससे, विज्ञापन स्रोत से जुड़ी कई समस्याओं का पता चल सकता है. ऐसा इसलिए, क्योंकि हो सकता है कि सेटअप या फ़ैसले की वजह से, उसने बिड न लगाई हो. ज़्यादा मदद पाने के लिए, विज्ञापन स्रोत की सेटअप गाइड या ओपन बिडिंग के बारे में अक्सर पूछे जाने वाले सवाल देखें.
आखिर में, सूची में सबसे नीचे उन विज्ञापन नेटवर्क की जानकारी होगी जो बिडिंग वाली नीलामी में हार गई हैं.
मीडिएशन वॉटरफ़ॉल, बिडिंग नीलामी में जीतने वाले विज्ञापन सोर्स को उसकी eCPM वैल्यू के हिसाब से रख सकता है.
मीडिएशन वॉटरफ़ॉल, एक ही इन्वेंट्री के लिए प्रतिस्पर्धा करने वाले कई यील्ड ग्रुप का नतीजा होता है. किसी एक यील्ड ग्रुप में, ज़्यादा से ज़्यादा 10 तीसरे पक्ष के यील्ड पार्टनर जोड़े जा सकते हैं. इनमें, बिडिंग यील्ड पार्टनर और मोबाइल ऐप्लिकेशन यील्ड पार्टनर के लिए मीडिएशन, दोनों शामिल हैं.
विज्ञापन यूनिट की बेहतर तरीके से डीबग करना
विज्ञापन यूनिट से जुड़ी समस्या हल करते समय, विज्ञापन अनुरोध और रिस्पॉन्स की जांच करने से, यह पता चल सकता है कि समस्या कहां है. इसके अलावा, डीबग करने में मदद पाने के लिए, इसे Google की सहायता टीम के साथ शेयर किया जा सकता है. वॉटरफ़ॉल चेन के सबसे ऊपर मौजूद मेन्यू आइकॉन पर टैप करें. इसके बाद, विज्ञापन अनुरोध और जवाब को एक्सपोर्ट करने के लिए, विज्ञापन अनुरोध और जवाब शेयर करें को चुनें. इससे आपको अपने ऐप्लिकेशन पर नेटवर्क ट्रेस चलाने की परेशानी से बचने में मदद मिलती है.
ध्यान दें: विज्ञापन के जवाब को सिर्फ़ तब एक्सपोर्ट किया जा सकता है, जब आपने डिबग करने के विकल्पों वाले मेन्यू की मदद से,
अपने डिवाइस को लिंक किया हो .
इसके अलावा, अनुरोध स्ट्रिंग वाले मेन्यू में जाकर, तीसरे पक्ष के बिडिंग पैरामीटर विकल्प पर टैप करके, डिकोड किए गए तीसरे पक्ष के बिडिंग पैरामीटर देखे जा सकते हैं. इससे, इस बारे में जानकारी मिलती है कि तीसरे पक्ष के बिडिंग के किन पैरामीटर में समस्याएं हो सकती हैं. इससे आपको अपने ऐप्लिकेशन को डीबग करने या यह पुष्टि करने में मदद मिलती है कि कोई नेटवर्क अपने सिग्नल इकट्ठा कर रहा है.
उपलब्ध अडैप्टर देखना
अपने ऐप्लिकेशन में बिडिंग या मीडिएशन कॉन्फ़िगरेशन में, विज्ञापन स्रोतों से जुड़े सभी तीसरे पक्ष के अडैप्टर की सूची देखने के लिए, अडैप्टर टैब पर क्लिक करें. इसके बाद, उनके शुरू होने की स्थिति और एसडीके टूल के वर्शन देखने के लिए, कार्ड को बड़ा करें.
काम करने वाले तीसरे पक्ष के अडैप्टर के साथ-साथ, कस्टम इवेंट अडैप्टर भी देखे जा सकते हैं.
कस्टम इवेंट पब्लिशर को उन विज्ञापन नेटवर्क कंपनियों को इस्तेमाल करने की सुविधा देते हैं जो Ad Manager पर काम नहीं करते. कस्टम इवेंट, अडैप्टर की सूची में मौजूद तीसरे पक्ष के स्टैंडर्ड अडैप्टर से अलग होते हैं. ऐसा, उनके यूनीक क्लास नेम की वजह से होता है. विज्ञापन जांचने वाला टूल, क्लास का नाम और स्थिति की जानकारी देने के साथ-साथ, Ad Manager के वेब इंटरफ़ेस में उन कस्टम इवेंट को असाइन किए गए लेबल भी दिखाता है.
अगर अडैप्टर नहीं मिलता है या शुरू नहीं हो पाता है, तो ज़्यादा जानकारी के लिए
मोबाइल ऐप्लिकेशन विज्ञापन डिलीवरी की जांच करें
देखें.
ध्यान दें: एपीआई के वर्शन v20.0.0 से पहले के वर्शन में, कस्टम इवेंट को पहले लागू करना.
ऐसे एपीआई जो अब काम नहीं करते उन सब-क्लास के लिए, शुरू करने की सुविधा काम नहीं करती है और
विज्ञापन जांचने वाले टूल में समस्या मिली के तौर पर दिखती है. अगर आपको विज्ञापन जांचने वाले टूल में यह चेतावनी दिखती है, तो यह देखें कि आपका कस्टम इवेंट इंटिग्रेशन काम कर रहा है या नहीं. अगर ऐसा है, तो देखें कि आपका ऐप्लिकेशन CustomEventBanner
जैसे पुराने इंटरफ़ेस का इस्तेमाल तो नहीं कर रहा है. अगर ऐसा है, तो उन्हें नई Adapter
क्लास से बदलें.
अपनी विज्ञापन यूनिट की जांच करना
अगर आपको अपने ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) में विज्ञापन यूनिट पर जाने के बिना, उसकी जांच करनी है, तो विज्ञापन जांचने वाला टूल सीधे विज्ञापन यूनिट की ज़्यादा जानकारी वाली स्क्रीन से इसकी सुविधा देता है.
इसके अलावा, एक साथ कई विज्ञापन यूनिट की जांच की जा सकती है. साथ ही, टेस्ट विज्ञापन के अनुरोधों को असिंक्रोनस तरीके से लोड और देखा जा सकता है. इसके अलावा, विज्ञापन के किसी एक स्रोत की जांच भी की जा सकती है.
अहम जानकारी: विज्ञापन जांचने वाले टूल का कोई एक टेस्ट चलाने पर, आपके अनुरोधों में कई पैरामीटर शामिल नहीं होते. ये पैरामीटर, आपके ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) में ट्रिगर होने पर शामिल होते हैं. इनमें, बच्चों के लिए विज्ञापन दिखाने के तरीके का कॉन्फ़िगरेशन, कस्टम टारगेटिंग, नेटवर्क एक्स्ट्रा, अलग-अलग साइज़ वगैरह शामिल हैं. हमारा सुझाव है कि इन अनुरोधों की संख्या सीमित होने की वजह से, आप जब भी हो सके अपने ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके जांच करें.
विज्ञापन की जांच करना
इस सेक्शन में बताई गई, विज्ञापन की जांच करने वाले टूल की मदद से की जाने वाली विज्ञापन टेस्टिंग, आपके विज्ञापन के बुनियादी अनुभव की पुष्टि करने के लिए एक बेहतरीन टूल है. साथ ही, एक विज्ञापन स्रोत की जांच करने के साथ इस्तेमाल करने पर, आपके मीडिएशन कॉन्फ़िगरेशन की पुष्टि करने के लिए भी एक बेहतरीन टूल है.
अहम जानकारी: भले ही, आपकी विज्ञापन यूनिट में कई विज्ञापन फ़ॉर्मैट काम कर सकते हैं, लेकिन विज्ञापन जांचने वाले टूल की मदद से यह नहीं चुना जा सकता कि आपको किस फ़ॉर्मैट की जांच करनी है. इसके बजाय, यह टूल डिफ़ॉल्ट रूप से उस फ़ॉर्मैट का इस्तेमाल करता है जिसका अनुरोध पिछली बार किया गया था.
जब आप अपनी विज्ञापन यूनिट को टेस्ट करने के लिए तैयार हों, तो विज्ञापन जांचने वाले टूल की स्क्रीन के सबसे ऊपर मौजूद टेस्ट विज्ञापन का अनुरोध करें बटन पर टैप करें. इससे विज्ञापन जांचने वाले टूल के विज्ञापन की जांच को ट्रिगर किया जा सकेगा. इसके बाद, टेस्ट के नतीजे SDK टूल के लिए किए गए अनुरोध के लॉग में दिखते हैं. ये नतीजे, विज्ञापन जांचने वाले टूल से अनुरोध किया गया हेडर के नीचे दिखते हैं.
अपने ऐप्लिकेशन में विज्ञापन जांचने वाले टूल को इस्तेमाल करने का तरीका जानें
विज्ञापन के किसी एक स्रोत को टेस्ट करना
विज्ञापन जांचने वाले टूल में एक सुविधा है, जिसकी मदद से आपके ऐप्लिकेशन में विज्ञापन अनुरोधों पर पाबंदी लगाई जा सकती है. इससे, सिर्फ़ एक बिडिंग या वॉटरफ़ॉल मीडिएशन विज्ञापन स्रोत से विज्ञापन दिखाए जा सकते हैं. इससे यह पुष्टि की जा सकती है कि आपने तीसरे पक्ष के अडैप्टर को सही तरीके से लागू किया है. साथ ही, यह भी पता किया जा सकता है कि विज्ञापन स्रोत, उम्मीद के मुताबिक काम कर रहा है या नहीं.
इस सुविधा को चालू करने के लिए, स्क्रीन पर सबसे नीचे मौजूद विज्ञापन के एक स्रोत का टेस्ट स्विच को टॉगल करें. इससे, विज्ञापन स्रोत चुनने के लिए यह डायलॉग दिखता है:
किसी एक विज्ञापन स्रोत को टेस्ट करने से पहले, आपको Google Mobile Ads SDK टूल को शुरू करना होगा.
इसके बाद, टेस्ट करने के लिए कोई एक विज्ञापन स्रोत चुना जा सकता है. कोई विज्ञापन स्रोत चुनने के बाद,
यह स्क्रीन दिखती है:
विज्ञापन के किसी एक स्रोत की टेस्टिंग की सेटिंग, उसी सेशन में किए जाने वाले सभी विज्ञापन अनुरोधों पर लागू होती है. हालांकि, यह उस सेशन में पहले से कैश मेमोरी में सेव किए गए उन विज्ञापनों पर लागू नहीं होता जिन्हें अब तक नहीं दिखाया गया है. हमारा सुझाव है कि किसी एक विज्ञापन स्रोत की जांच करते समय, अपने ऐप्लिकेशन को ज़बरदस्ती रीस्टार्ट करें. इससे, कैश मेमोरी में सेव किए गए उन विज्ञापनों को अमान्य किया जा सकता है जो आपके चुने गए विज्ञापन स्रोत के बजाय दिखाए जा सकते हैं.
ऐप्लिकेशन को रीस्टार्ट करने के बाद, सभी विज्ञापन यूनिट प्लेसमेंट सिर्फ़ चुने गए नेटवर्क से विज्ञापन दिखाने की कोशिश करते हैं. विज्ञापन के किसी एक स्रोत का टेस्ट चालू होने पर, विज्ञापन जांचने वाला टूल चालू करने पर, चालू टेस्ट विज्ञापन स्रोत दिखता है:
किसी एक विज्ञापन स्रोत के टेस्ट मोड में, सभी विज्ञापन अनुरोध चुने गए विज्ञापन स्रोत से पूरे होने की कोशिश करते हैं. भले ही, वह विज्ञापन स्रोत, अनुरोध की गई विज्ञापन यूनिट के लिए बिडिंग या मीडिएशन के लिए कॉन्फ़िगर किया गया हो. अगर किसी ऐसे विज्ञापन स्रोत की जांच की जा रही है जो किसी विज्ञापन यूनिट के मीडिएशन वॉटरफ़ॉल में नहीं है, तो आपको "विज्ञापन नहीं भरने" से जुड़ी गड़बड़ी का मैसेज दिखेगा.
विज्ञापन के किसी एक सोर्स के टेस्ट में, किसी विज्ञापन यूनिट पर टैप करके, उसका SDK टूल के लिए किया गया अनुरोध लॉग देखा जा सकता है.
इससे यह पता किया जा सकता है कि विज्ञापन के किसी एक स्रोत के लिए टेस्ट चालू करने के बाद वह स्रोत, विज्ञापन अनुरोधों से भर सका या नहीं. अगर विज्ञापन स्रोत किसी विज्ञापन को लोड नहीं कर पाता है, तो गड़बड़ी का मैसेज दिखता है.
अगर आपने किसी मीडिएशन वॉटरफ़ॉल में, चुने गए विज्ञापन स्रोत के कई इंस्टेंस जोड़े हैं, तो आपको वॉटरफ़ॉल में विज्ञापन स्रोत के लिए हर कॉल का इंस्टेंस दिखेगा. यह तब तक होगा, जब तक कि विज्ञापन नहीं दिखता या बिना विज्ञापन दिखाए ही वॉटरफ़ॉल खत्म नहीं हो जाता.
किसी एक विज्ञापन स्रोत की जांच को रोकना
जांच रोकने के लिए, स्विच को टॉगल करके बंद करें:
इसके बाद, रीस्टार्ट करने के लिए दिखाई गई इस स्क्रीन पर, पुष्टि करने का मैसेज दिखेगा:
हमारा सुझाव है कि टेस्ट बंद करने के बाद, अपने ऐप्लिकेशन को ज़बरदस्ती रीस्टार्ट करें. इससे, टेस्ट किए गए विज्ञापन स्रोत के लिए कैश मेमोरी में सेव किए गए सभी विज्ञापनों को अमान्य कर दिया जाएगा.
डीबगिंग के पूरे आउटपुट कॉपी करना
विज्ञापन जांचने वाले टूल की मदद से, JSON स्ट्रिंग को कॉपी किया जा सकता है. इसमें, टूल से मिलने वाले डीबगिंग आउटपुट की पूरी जानकारी शामिल होती है. जैसे, आपके Ad Manager ऐप्लिकेशन की जानकारी, अडैप्टर को शुरू करने की स्थिति, और सभी विज्ञापन यूनिट की जांच के नतीजे.
ऐसा करने के लिए, ऐप्लिकेशन आइकॉन पर सात बार टैप करें. ऐसा तब तक करें, जब तक आपको विज्ञापन जांचने वाले टूल का JSON, क्लिपबोर्ड पर कॉपी किया गया मैसेज न दिख जाए.