शुरू करें

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

शुरू करने से पहले

AdSense खाता बनाएं

शुरू करने के लिए अपने AdSense खाते में साइन अप या साइन इन करें.

AdSense के बारे में जानें

अगर आपको AdSense कॉन्सेप्ट के बारे में नहीं पता है, तो AdSense के बारे में शुरुआती जानकारी पढ़ें और कोड करना शुरू करने से पहले AdSense यूज़र इंटरफ़ेस (यूआई) के साथ प्रयोग करें.

अपनी क्लाइंट लाइब्रेरी चुनें

क्लाइंट लाइब्रेरी और सैंपल पेज में, आपको उपलब्ध लाइब्रेरी और सैंपल की जानकारी मिलेगी. अपनी चुनी हुई भाषा के टैब पर क्लिक करें और सोर्स डाउनलोड करने के लिए लिंक पर जाएं. क्लाइंट लाइब्रेरी आपके लिए ये चीज़ें मैनेज करती है:

• पुष्टि करना
• सेवाओं की खोज
• एपीआई के लिए अनुरोध तैयार किए जा रहे हैं
• रिस्पॉन्स पार्स करना

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

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

अपना ऐप्लिकेशन रजिस्टर करें

AdSense Management API का इस्तेमाल करने के लिए, आपको अपने डेवलप किए जा रहे ऐप्लिकेशन को रजिस्टर करना होगा. इसके लिए, आपको एक प्रोजेक्ट बनाना होगा और एक Client-ID जनरेट करना होगा.

अपना ऐप्लिकेशन रजिस्टर करना

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

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

आसानी से सिखाने वाला ट्यूटोरियल

अपना पहला अनुरोध करने के लिए नीचे दिए गए चरणों का पालन करें, ध्यान रखें कि ये चरण आपकी लाइब्रेरी या भाषा के आधार पर थोड़े अलग हो सकते हैं:

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

   विज्ञापन क्लाइंट, AdSense खाते और AdSense प्रॉडक्ट के बीच के जुड़ाव को दिखाते हैं. जैसे, कॉन्टेंट विज्ञापन या Search Network में दिखने वाले विज्ञापन. किसी AdSense खाते में एक या उससे ज़्यादा विज्ञापन क्लाइंट हो सकते हैं.

   1. वेब ऐप्लिकेशन के लिए, उपयोगकर्ताओं को ऐसी साइट पर रीडायरेक्ट किया जाएगा जहां वे ऐक्सेस दे सकते हैं. अनुमति मिलने के बाद, उन्हें API कंसोल में दिए गए कॉलबैक यूआरएल पर रीडायरेक्ट कर दिया जाएगा.
   2. इंस्टॉल किए गए ऐप्लिकेशन इसी तरह काम करते हैं. क्लाइंट लाइब्रेरी, ब्राउज़र विंडो खोलने और ऑथराइज़ेशन कोड का इस्तेमाल करने की कोशिश करेगी. Android, Chrome और iOS ऐप्लिकेशन के लिए, यह तरीका प्लैटफ़ॉर्म के हिसाब से अलग-अलग है.
2. इस रिपोर्ट का अनुरोध करने के लिए, reports.generate के लिए एपीआई एक्सप्लोरर का इस्तेमाल करें:
   • date_range: YESTERDAY
   • dimensions: DATE
   • metrics: ESTIMATED_EARNINGS

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

3. अपने ऐप्लिकेशन से इसी रिपोर्ट के लिए अनुरोध करें.
4. विज्ञापन यूनिट के हिसाब से रिपोर्ट को फ़िल्टर किया जा सकता है. adunits.list का इस्तेमाल करके, विज्ञापन यूनिट की सूची फ़ेच करें. ध्यान दें कि एक विज्ञापन क्लाइंट आईडी ज़रूरी है (इसे पहले चरण से पाएं). विज्ञापन यूनिट चुनने के बाद, reports.generate के लिए फ़िल्टर पैरामीटर में, उसके आईडी का इस्तेमाल करें:

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

   • date_range: YESTERDAY
   • dimensions: DATE
   • metrics: ESTIMATED_EARNINGS
   • filter: AD_UNIT_ID==ca-pub-123456789:987654321
5. कस्टम या यूआरएल चैनलों के हिसाब से फ़िल्टर करें या कई फ़िल्टर इस्तेमाल करें.

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

आप रेफ़रंस दस्तावेज़ में दिए गए बाकी कॉल और संसाधनों को देखकर, लागू करने के लिए तैयार हैं.