इस गाइड में, विज्ञापन जांचने वाले टूल की अलग-अलग सुविधाओं को लॉन्च करने और उनका इस्तेमाल करने का तरीका बताया गया है.
ज़रूरी शर्तें
विज्ञापन जांचने वाले टूल का इस्तेमाल करने के लिए, आपको ये काम करने होंगे:
- शुरुआती निर्देशों की गाइड के मुताबिक प्रोसेस पूरी करना.
- Google Mobile Ads SDK के 9.1.0 या इसके बाद के वर्शन का इस्तेमाल करना.
- अपने डिवाइस को टेस्ट डिवाइस के तौर पर जोड़ना. विज्ञापन जांचने वाला टूल, सिर्फ़ टेस्ट डिवाइसों पर लॉन्च किया जा सकता है.
विज्ञापन जांचने वाला टूल लॉन्च करना
विज्ञापन जांचने वाले टूल को, अपने ऐप्लिकेशन में कहीं से भी इन तरीकों से लॉन्च किया जा सकता है:
- टेस्ट डिवाइस रजिस्टर करते समय, AdMob यूज़र इंटरफ़ेस (यूआई) में चुने गए जेस्चर का इस्तेमाल करना.
- दिए गए एपीआई का इस्तेमाल करके, प्रोग्राम के ज़रिए लॉन्च करना.
- डीबग मेन्यू में मौजूद लॉन्च बटन का इस्तेमाल करना.
जेस्चर का इस्तेमाल करके लॉन्च करना
किसी जेस्चर की मदद से विज्ञापन जांचने वाले टूल को लॉन्च करने के लिए, आपको अपने ऐप्लिकेशन में कोई बदलाव करने की ज़रूरत नहीं है. बस, वह जेस्चर (दो बार फ़्लिक करना या हिलाना) करें जिसे आपने AdMob में उस टेस्ट डिवाइस के लिए कॉन्फ़िगर किया है. ज़्यादा जानें
AdMob यूज़र इंटरफ़ेस (यूआई) में कोई जेस्चर सेट करने और उसके लागू होने के लिए 15 मिनट इंतज़ार करने के बाद, आपके ऐप्लिकेशन को विज्ञापन के लिए अनुरोध करना होगा. इससे Google Mobile Ads SDK को आपकी जेस्चर सेटिंग के बारे में पता चलेगा. अगर आपका तय किया गया जेस्चर काम नहीं कर रहा है, तो कोई विज्ञापन लोड करने की कोशिश करें. इसके बाद, अपने ऐप्लिकेशन को रीस्टार्ट करें और जेस्चर को फिर से टेस्ट करें.
प्रोग्राम के ज़रिए लॉन्च करना
विज्ञापन जांचने वाले टूल को प्रोग्राम के ज़रिए भी लॉन्च किया जा सकता है:
यह एपीआई, प्रोग्राम के ज़रिए या AdMob यूज़र इंटरफ़ेस (यूआई) में रजिस्टर किए गए टेस्ट डिवाइसों के लिए काम करता है.
विज्ञापन यूनिट देखना और उनसे जुड़ी समस्याओं को हल करना
लॉन्च होने के बाद, विज्ञापन जांचने वाले टूल की मुख्य स्क्रीन दिखती है. इसमें, AdMob यूज़र इंटरफ़ेस (यूआई) में मौजूद उन सभी विज्ञापन यूनिट की सूची होती है जो आपके AdMob ऐप्लिकेशन आईडी से जुड़ी हैं और जिनमें बिडिंग या मीडिएशन कॉन्फ़िगरेशन मौजूद हैं:
हमारा सुझाव है कि विज्ञापन जांचने वाले टूल का इस्तेमाल करने से पहले, Google Mobile Ads SDK शुरू करें.
किसी विज्ञापन यूनिट के लिए, मीडिएशन वॉटरफ़ॉल की जानकारी देखना
किसी विज्ञापन यूनिट पर SDK टूल के अनुरोध की जानकारी देखने के लिए, उस विज्ञापन यूनिट पर टैप करें. इसमें हाल के विज्ञापन अनुरोधों के लिए, विज्ञापन के दिखाए जाने तक मीडिएशन वॉटरफ़ॉल का ब्यौरा दिया जाता है या विज्ञापन दिखाए बिना वॉटरफ़ॉल खत्म होने की जानकारी होती है.
हर अनुरोध को, डिसक्लोज़र इंडिकेटर का इस्तेमाल करके बड़ा किया जा सकता है. इससे उस अनुरोध के लिए, मीडिएशन वॉटरफ़ॉल के नतीजे दिखते हैं. साथ ही, उस अनुरोध के लिए लागू होने वाली गड़बड़ी और इंतज़ार का समय भी दिखता है.
तीसरे पक्ष के विज्ञापन स्रोतों के लिए, गड़बड़ी के मैसेज सीधे विज्ञापन स्रोत से भेजे जाते हैं. ज़्यादा जानकारी के लिए, तीसरे पक्ष के विज्ञापन स्रोत से संपर्क करें.
किसी विज्ञापन यूनिट के लिए, बिडिंग की जानकारी देखना
अगर आपको बिडिंग के बारे में जानकारी नहीं है, तो खास जानकारी पढ़ें.
SDK टूल के लिए किए गए अनुरोध के लॉग में, बिडिंग के उन विज्ञापन स्रोसों को देखा जा सकता है जिन्हें विज्ञापन दिखाने के अनुरोध में कॉल किया गया है. बिडिंग नीलामी में, हर विज्ञापन स्रोत की जानकारी देखने के लिए, SDK टूल के लिए किए गए अनुरोध के लॉग में मौजूद किसी विज्ञापन यूनिट पर टैप करें.
बिडिंग के नतीजों को इस क्रम में लगाया जाता है, ताकि कार्रवाई करने वाले आइटम सूची में सबसे ऊपर दिखें:
सबसे ऊपर, वह विज्ञापन नेटवर्क होता है जिसने नीलामी जीती है.
इसके बाद, वे विज्ञापन नेटवर्क होते हैं जिनमें समस्याएं हैं. इन समस्याओं को हल करने के लिए, समस्या हल करने का तरीका आज़माया जा सकता है .
इसके बाद, वे विज्ञापन नेटवर्क होते हैं जिन्होंने कोई विज्ञापन नहीं दिखाया या जिन्होंने बिड नहीं लगाई. यह विज्ञापन स्रोत से जुड़ी कई तरह की समस्याओं का संकेत हो सकता है, क्योंकि हो सकता है कि सेटअप या फ़ैसले लेने की प्रोसेस की वजह से, उसने बिड न लगाई हो. सहायता के लिए, विज्ञापन स्रोत के सेटअप की गाइड देखें या सीधे विज्ञापन स्रोत से संपर्क करें समर्थन के लिए.
आखिर में, सूची में सबसे नीचे वे विज्ञापन नेटवर्क होते हैं जो बिडिंग नीलामी हार गए.
मीडिएशन वॉटरफ़ॉल, बिडिंग नीलामी जीतने वाले विज्ञापन स्रोत को उसकी eCPM वैल्यू के हिसाब से रख सकता है.
जब किसी विज्ञापन स्रोत को मीडिएशन वॉटरफ़ॉल में कॉल किया जाता है, तो वह विज्ञापन दिखा सकता है. मीडिएशन वॉटरफ़ॉल के साथ बिडिंग कैसे काम करती है, इस बारे में ज़्यादा जानने के लिए, मीडिएशन ग्रुप में बिडिंग और वॉटरफ़ॉल विज्ञापन स्रोतों के उदाहरण 2 और उदाहरण 3 देखें.
विज्ञापन यूनिट को डीबग करने का ऐडवांस तरीका
विज्ञापन यूनिट से जुड़ी समस्याओं को हल करते समय, विज्ञापन दिखाने के अनुरोध और जवाब की जानकारी देखना मददगार हो सकता है. इससे यह पता चलता है कि कहां गड़बड़ी हो रही है. साथ ही, डीबग करने में मदद पाने के लिए, यह जानकारी Google सहायता के साथ शेयर की जा सकती है. वॉटरफ़ॉल चेन में सबसे ऊपर मौजूद, मेन्यू आइकॉन पर टैप करें. इसके बाद, विज्ञापन दिखाने के अनुरोध और जवाब की जानकारी शेयर करें को चुनकर, विज्ञापन दिखाने के पूरे अनुरोध और जवाब की जानकारी एक्सपोर्ट करें. इससे आपको अपने ऐप्लिकेशन पर नेटवर्क ट्रेस चलाने की ज़रूरत नहीं पड़ती.
इसके अलावा, अनुरोध वाली स्ट्रिंग के तौर पर दिखने वाले उसी मेन्यू में, तीसरे पक्ष के बिडिंग पैरामीटर विकल्प पर टैप करके, डिकोड किए गए तीसरे पक्ष के बिडिंग पैरामीटर देखे जा सकते हैं. इससे यह जानकारी मिलती है कि तीसरे पक्ष के किन बिडिंग पैरामीटर में समस्याएं आ सकती हैं. इससे आपको अपने ऐप्लिकेशन को डीबग करने या यह पुष्टि करने में मदद मिलती है कि कोई नेटवर्क अपने सिग्नल सही तरीके से इकट्ठा कर रहा है.
उपलब्ध अडैप्टर देखना
अडैप्टर टैब पर क्लिक करके, अपने ऐप्लिकेशन में बिडिंग या मीडिएशन कॉन्फ़िगरेशन में मौजूद विज्ञापन स्रोतों से जुड़े तीसरे पक्ष के सभी अडैप्टर की सूची देखें. इसके बाद, उनके शुरू होने की स्थितियों और SDK वर्शन देखने के लिए, कार्ड बड़ा करें. तीसरे पक्ष के साथ काम करने वाले अडैप्टर के साथ-साथ, कस्टम इवेंट अडैप्टर भी देखे जा सकते हैं.
कस्टम इवेंट की मदद से, पब्लिशर उन विज्ञापन नेटवर्क का इस्तेमाल कर सकते हैं जो AdMob पर काम नहीं करते. अडैप्टर की सूची में, कस्टम इवेंट को तीसरे पक्ष के स्टैंडर्ड अडैप्टर से अलग पहचाना जा सकता है. ऐसा उनके यूनीक क्लास नेम की वजह से होता है. क्लास नेम और स्टेटस की जानकारी देने के अलावा, विज्ञापन जांचने वाला टूल, AdMob के वेब इंटरफ़ेस में उन कस्टम इवेंट को असाइन किए गए लेबल भी दिखाता है.
अगर अडैप्टर नहीं मिलता है या वह शुरू नहीं हो पाता है, तो ज़्यादा जानकारी के लिए, विज्ञापन जांचने वाले टूल का इस्तेमाल करके समस्याओं को हल करना लेख देखें.
अपनी विज्ञापन यूनिट की जांच करना
अगर आपको अपने ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) में जाकर, अपनी विज्ञापन यूनिट की जांच करनी है, तो विज्ञापन जांचने वाला टूल, विज्ञापन यूनिट की जानकारी वाली स्क्रीन से सीधे यह काम करने की सुविधा देता है. इसके अलावा, एक साथ कई विज्ञापन यूनिट की जांच की जा सकती है, टेस्ट विज्ञापन के अनुरोधों को एसिंक्रोनस तरीके से लोड और देखा जा सकता है. साथ ही, विज्ञापन के किसी एक स्रोत के टेस्ट भी किए जा सकते हैं.
विज्ञापन की जांच करना
इस सेक्शन में बताए गए, विज्ञापन जांचने वाले टूल के विज्ञापन टेस्ट, आपके विज्ञापन के बुनियादी अनुभव की पुष्टि करने और विज्ञापन के किसी एक स्रोत के टेस्ट के साथ इस्तेमाल करने पर, आपके मीडिएशन कॉन्फ़िगरेशन की पुष्टि करने के लिए एक बेहतरीन टूल है.
जब आपको अपनी विज्ञापन यूनिट की जांच करनी हो, तो विज्ञापन जांचने वाले टूल के विज्ञापन टेस्ट को ट्रिगर करने के लिए, विज्ञापन जांचने वाले टूल की स्क्रीन पर सबसे ऊपर मौजूद, टेस्ट विज्ञापन का अनुरोध करें बटन पर टैप करें. इसके बाद, टेस्ट के नतीजे, SDK टूल के लिए किए गए अनुरोध के लॉग में, विज्ञापन जांचने वाले टूल से अनुरोध किया गया हेडर के नीचे दिखते हैं.
विज्ञापन के किसी एक स्रोत को टेस्ट करना
विज्ञापन जांचने वाले टूल में एक ऐसी सुविधा है जिससे आपके ऐप्लिकेशन में विज्ञापन के अनुरोधों को सीमित किया जा सकता है. इससे सिर्फ़ बिडिंग या वॉटरफ़ॉल मीडिएशन के किसी एक विज्ञापन स्रोत से विज्ञापन दिखाए जा सकते हैं. इससे यह पुष्टि की जा सकती है कि आपने तीसरे पक्ष के अडैप्टर को सही तरीके से लागू किया है. साथ ही, यह भी पता किया जा सकता है कि विज्ञापन स्रोत, उम्मीद के मुताबिक काम कर रहा है या नहीं.
इस सुविधा को चालू करने के लिए, स्क्रीन के सबसे नीचे मौजूद विज्ञापन के किसी एक स्रोत का टेस्ट स्विच को टॉगल करें. इससे, विज्ञापन स्रोत चुनने का यह डायलॉग दिखता है:
विज्ञापन के किसी एक स्रोत को टेस्ट करने से पहले, आपको Google Mobile Ads SDK का इस्तेमाल शुरू करना होगा.
इसके बाद, टेस्ट करने के लिए विज्ञापन का कोई एक स्रोत चुना जा सकता है. विज्ञापन का कोई स्रोत चुनने के बाद, यह स्क्रीन दिखती है:
विज्ञापन के किसी एक स्रोत के टेस्ट की सेटिंग, उसी सेशन में विज्ञापन के लिए किए जाने वाले सभी अनुरोधों पर लागू होती है. हालांकि, यह उस सेशन में पहले से कैश मेमोरी में सेव किए गए उन विज्ञापनों पर लागू नहीं होती जो अब तक नहीं दिखाए गए हैं. विज्ञापन के किसी एक स्रोत का टेस्ट लागू करते समय, अपने ऐप्लिकेशन को ज़बरदस्ती रीस्टार्ट करने का सुझाव दिया जाता है. इससे कैश मेमोरी में सेव किए गए उन विज्ञापनों को अमान्य किया जा सकता है जो आपके चुने गए विज्ञापन स्रोत को अनुरोध मिलने के बजाय दिखाए जा सकते हैं.
अपने ऐप्लिकेशन को रीस्टार्ट करने के बाद, सभी विज्ञापन यूनिट प्लेसमेंट में सिर्फ़ चुने गए नेटवर्क से विज्ञापन दिखाने की कोशिश की जाती है. विज्ञापन के किसी एक स्रोत का टेस्ट चालू होने पर, विज्ञापन जांचने वाले टूल को लॉन्च करने पर, टेस्ट के लिए चालू विज्ञापन स्रोत दिखता है:
विज्ञापन के किसी एक स्रोत के टेस्ट मोड में सभी विज्ञापन अनुरोध, चुने गए विज्ञापन स्रोत से पूरे होने की कोशिश करेंगे. भले ही, अनुरोध की गई विज्ञापन यूनिट के लिए, उस विज्ञापन स्रोत को बिडिंग या मीडिएशन के लिए कॉन्फ़िगर किया गया हो या नहीं. अगर ऐसे विज्ञापन स्रोत की जांच की जा रही है जो किसी विज्ञापन यूनिट के मीडिएशन वॉटरफ़ॉल में नहीं है, तो आपको "विज्ञापन नहीं भरने" से जुड़ी गड़बड़ी का मैसेज दिखेगा.
विज्ञापन के किसी एक स्रोत के टेस्ट में, किसी विज्ञापन यूनिट पर टैप करके, इसका SDK टूल के लिए किए गए अनुरोध का लॉग देखा जा सकता है. इससे यह पता किया जा सकता है कि विज्ञापन के किसी एक स्रोत के लिए टेस्ट चालू करने के बाद वह स्रोत, विज्ञापन अनुरोधों से भर सका या नहीं. अगर विज्ञापन स्रोत, विज्ञापन लोड नहीं कर पाया, तो गड़बड़ी की जानकारी देने वाला मैसेज दिखता है.
अगर आपने किसी मीडिएशन वॉटरफ़ॉल में, चुने गए विज्ञापन स्रोत के कई इंस्टेंस जोड़े हैं, तो आपको वॉटरफ़ॉल में विज्ञापन स्रोत के लिए हर कॉल का इंस्टेंस दिखेगा. यह तब तक होगा, जब तक कि विज्ञापन नहीं दिखते या बिना विज्ञापन दिखाए ही वॉटरफ़ॉल खत्म नहीं हो जाता.
विज्ञापन के किसी एक स्रोत का टेस्ट बंद करना
टेस्ट बंद करने के लिए, स्विच को टॉगल करके बंद करें:
इसके बाद, रीस्टार्ट करने की स्क्रीन पर, पुष्टि करने वाला मैसेज दिखता है:
हमारा सुझाव है कि टेस्ट बंद करने के बाद, अपने ऐप्लिकेशन को ज़बरदस्ती रीस्टार्ट करें. इससे टेस्ट किए गए विज्ञापन स्रोत के लिए, कैश मेमोरी में सेव किए गए विज्ञापनों को अमान्य किया जा सकता है.
निजता सेटिंग को डीबग करना
ज़रूरी शर्तें: Google Mobile Ads SDK का 9.6.0 या इसके बाद का वर्शन
विज्ञापन जांचने वाले टूल का इस्तेमाल करके, विज्ञापन के अनुरोध में पास किए गए निजता के इन सिग्नल को देखा जा सकता है. ये सिग्नल, IAB Europe TCF के साथ पब्लिशर के ऐप्लिकेशन को इंटिग्रेट करने के तहत पास किए जाते हैं:
- जीडीपीआर लागू होता है (
IABTCF_gdprApplies) - अतिरिक्त सहमति वाली स्ट्रिंग (
IABTCF_AddtlConsent) - टीसी स्ट्रिंग (
IABTCF_TCString)
विज्ञापन जांचने वाले टूल में कोई विज्ञापन लोड करने या विज्ञापन की जांच करने के बाद, SDK टूल के लिए किए गए अनुरोध का लॉग में मौजूद अनुरोध पर, मेन्यू आइकॉन पर टैप करें. इसके बाद, निजता के सिग्नल विकल्प चुनें.
निजता के सिग्नल स्क्रीन पर, विज्ञापन के अनुरोध में पास किए गए निजता के सिग्नल दिखते हैं.
एसी स्ट्रिंग के बारे में ज़्यादा जानने के लिए, Google के अतिरिक्त सहमति वाली स्ट्रिंग की तकनीकी जानकारी देखें. टीसी स्ट्रिंग में, विस्तृत सहमति की जानकारी देखने के लिए, जैसे कि सीएमपी आईडी और IAB से जुड़े, सहमति देने वाले वेंडर के आइडेंटिफ़ायर की सूची, डिकोड करें पर क्लिक करके, IAB GPP एनकोडर / डिकोडर खोलें.
अगर आपको कोई गड़बड़ी दिखती है, तो समस्या हल करने के लिए, निजता से जुड़ी समस्याओं को समझना लेख में दिए गए निर्देशों का पालन करें.
डीबग करने के सभी आउटपुट कॉपी करना
विज्ञापन जांचने वाले टूल से, डीबग करने के सभी आउटपुट वाली JSON स्ट्रिंग को कॉपी किया जा सकता है. इसमें, आपके AdMob के ज़रिए विज्ञापन दिखाने वाले ऐप्लिकेशन की जानकारी, अडैप्टर के शुरू होने की स्थितियां, और सभी विज्ञापन यूनिट के टेस्ट के नतीजे शामिल होते हैं.
इसके लिए, ऐप्लिकेशन आइकॉन पर सात बार टैप करें. इसके बाद, आपको विज्ञापन जांचने वाले टूल की JSON स्ट्रिंग को क्लिपबोर्ड पर कॉपी किया गया मैसेज दिखेगा.