AdSense Management API में नई और सेव की गई रिपोर्ट जनरेट करने के लिए कॉल मौजूद हैं. इनमें हर दिन होने वाली कमाई या हर देश के हिसाब से, हर कस्टम चैनल पर क्लिक मिलने की दर (सीटीआर) की जटिल टेबल शामिल हो सकती हैं. इस गाइड में ऐसे एज केस की सूची दी गई है जिन्हें एपीआई के साथ बेहतर इंटिग्रेशन के लिए, सही तरीके से हैंडल किया जाना चाहिए.
रिपोर्ट का स्ट्रक्चर
रिपोर्ट के नतीजे, ReportResult ऑब्जेक्ट के तौर पर दिखाए जाते हैं. पूरी जानकारी के लिए
रिपोर्ट
रिस्पॉन्स रेफ़रंस देखें.
समय के हिसाब से डाइमेंशन इस्तेमाल करना: DATE, WEEK, और MONTH
रिपोर्ट खाली हो सकती हैं या उनमें अंतर हो सकता है
अगर अनुरोध में बताई गई समयावधि के दौरान कोई गतिविधि नहीं हुई, तो कोई भी विज्ञापन अनुरोध जनरेट नहीं होगा. साथ ही, रिपोर्ट सेवा उन समयावधि के लिए लाइनें नहीं दिखाएगी. यह तब अहम होता है, जब आप एक ग्राफ़ बना रहे हों.
ज़्यादा जानकारी के लिए, तारीखें भरने से जुड़ी गाइड देखें.
एक ही रिपोर्ट में MONTH और WEEK डाइमेंशन का अनुरोध करना
इस रिपोर्ट के नेगेटिव या अनचाहे नतीजे हो सकते हैं. अगर कोई हफ़्ता दो अलग-अलग महीनों का है, तो वह उसी हफ़्ते के लिए दो पंक्तियां दिखाएगा, हर महीने के लिए एक.
उदाहरण
| डाइमेंशन | मेट्रिक | शुरू होने की तारीख | खत्म होने की तारीख |
|---|---|---|---|
WEEKMONTH |
CLICKS | 2014-04-28 | 2014-05-03 |
वापसी:
MONTH | WEEK* | CLICKS |
|---|---|---|
| 2014-04 | 2014-04-27 | 50 |
| 2014-05 | 2014-04-27 | 43 |
* हफ़्ते का पहला दिन
समस्या का हल
MONTH को रिपोर्ट से हटाएं.
WEEK | CLICKS |
|---|---|
| 2014-04-27 | 93 |
डाइमेंशन वैल्यू को इकट्ठा करना
प्लैटफ़ॉर्म (डेस्कटॉप, महंगे मोबाइल डिवाइस वगैरह) जैसे डाइमेंशन का अनुरोध करते समय, सिर्फ़ गतिविधि वाले प्लैटफ़ॉर्म दिखाए जाएंगे. अगर किसी दिए गए दिन, हफ़्ते या महीने में महंगे मोबाइल डिवाइस से कोई विज़िट नहीं होती है, तो उसमें उस कैटगरी की कोई जानकारी नहीं होगी.
उदाहरण
| डाइमेंशन | मेट्रिक | शुरू होने की तारीख | खत्म होने की तारीख |
|---|---|---|---|
PLATFORM_TYPE_NAMEMONTH |
AD_REQUESTS |
2014-02-01 | 2014-03-31 |
वापसी:
| MONTH | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | डेस्कटॉप | 100 |
| 2014-03 | उन्नत मोबाइल उपकरण | 5 |
| 2014-04 | डेस्कटॉप | 75 |
समस्या का हल
रिपोर्ट के नतीजों को प्रोसेस करते समय, नतीजों में न दिखने वाली किसी भी डाइमेंशन वैल्यू की वैल्यू को शून्य मान लें:
| MONTH | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | डेस्कटॉप | 100 |
| 2014-03 | उन्नत मोबाइल उपकरण | 5 |
| 2014-04 | डेस्कटॉप | 75 |
| 2014-04 | महंगे मोबाइल डिवाइस | 0 |
एक से ज़्यादा चलने वाली रिपोर्ट को एक साथ जोड़ना
कभी-कभी एक रिपोर्ट का साइज़ बहुत बड़ा होता है और उसे एक ही समय में जनरेट करना पड़ता है. अगर आपका ऐप्लिकेशन ऐसा करता है, तो इन बातों का ध्यान रखें:
- अगर
WEEKयाMONTHडाइमेंशन का इस्तेमाल किया जा रहा है और एक हफ़्ते या महीने के बीच में रिपोर्ट को अलग-अलग किया जा रहा है, तो हर रिपोर्ट में अलग-अलग डेटा के साथ डुप्लीकेट एंट्री होंगी. - पक्का करें कि सभी रिपोर्ट में एक ही मेट्रिक और डाइमेंशन हों, क्योंकि हो सकता है कि अलग-अलग डाइमेंशन का इस्तेमाल करके डेटा को जोड़ा न जा सके.
खास खाते
आपके कुछ उपयोगकर्ताओं के पास ऐसे एट्रिब्यूट वाले AdSense खाते हो सकते हैं जिनके बारे में आपको उम्मीद नहीं है या जिनके बारे में आपको जानकारी नहीं है. इन बातों का ध्यान रखें:
- हज़ारों डोमेन या साइटों वाले पब्लिशर
- हज़ारों विज्ञापन यूनिट या कस्टम चैनल वाले पब्लिशर
- ऐसे पब्लिशर जो कई विज्ञापन क्लाइंट की रिपोर्ट तैयार करना चाहते हैं (जैसे, AdSense for Search, AdSense for Video वगैरह)
एक से ज़्यादा खाते
उपयोगकर्ताओं के पास एक से ज़्यादा AdSense खातों का ऐक्सेस हो सकता है. इसी वजह से, एपीआई को किए जाने वाले हर कॉल के लिए
एक खाता आईडी बताना ज़रूरी है. accounts.list को किए गए कॉल से, खातों की सूची फ़ेच की जाती है और उपयोगकर्ता को खाता चुनने वाला डायलॉग दिखाया जाना चाहिए. अगर फ़ेच किए गए खातों की संख्या एक हो, तो उसे बायपास किया जा सकता है.
टाइम ज़ोन में बदलाव
AdSense पब्लिशर किसी भी समय अपना टाइमज़ोन बदल सकते हैं. इस वजह से, रिपोर्ट में उतार-चढ़ाव दिख सकते हैं. ज़्यादा जानकारी के लिए, स्थानीय टाइम ज़ोन रिपोर्टिंग से जुड़ी गाइड पढ़ें.