आरंभ करें

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

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

AdSense खाता बनाएं

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   1. वेब ऐप्लिकेशन के लिए, उपयोगकर्ताओं को ऐसी साइट पर रीडायरेक्ट किया जाएगा जहां वे ऐक्सेस देने का विकल्प चुन सकते हैं. अनुमति मिलने के बाद, उन्हें Google API (एपीआई) कंसोल में बताए गए कॉलबैक यूआरएल पर रीडायरेक्ट कर दिया जाएगा.
   2. इंस्टॉल किए गए ऐप्लिकेशन इसी तरह काम करते हैं. क्लाइंट लाइब्रेरी, ब्राउज़र विंडो खोलने और ऑथराइज़ेशन कोड का इस्तेमाल करने की कोशिश करेगी. Android, Chrome, और iOS ऐप्लिकेशन के लिए, यह तरीका प्लैटफ़ॉर्म के हिसाब से है.
2. इस रिपोर्ट का अनुरोध करने के लिए, reports.generate के लिए Google API एक्सप्लोरर का इस्तेमाल करें:
   • 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. कस्टम या यूआरएल चैनलों के हिसाब से फ़िल्टर करने की कोशिश करें या कई फ़िल्टर एक साथ मिलाएं.

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

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