इस दस्तावेज़ में, Google Analytics Core Reporting API के वर्शन 3.0 की खास जानकारी दी गई है. एपीआई की ज़्यादा जानकारी के लिए, रेफ़रंस गाइड देखें.
शुरुआती जानकारी
Google Analytics Core Reporting API की मदद से, Google Analytics में मौजूद रिपोर्ट के ज़्यादातर डेटा को ऐक्सेस किया जा सकता है. Core Reporting API की मदद से ये काम किए जा सकते हैं:
- Google Analytics का डेटा दिखाने के लिए, कस्टम डैशबोर्ड बनाएं.
- रिपोर्टिंग के मुश्किल टास्क को ऑटोमेट करके समय बचाएं.
- अपने Google Analytics डेटा को अन्य कारोबारी ऐप्लिकेशन के साथ इंटिग्रेट करें.
वर्शन चुनना
हमने हाल ही में Core Reporting API का नया वर्शन लॉन्च किया है.
- क्या आपको नया ऐप्लिकेशन बनाना है? – हम आपको सबसे नया वर्शन 3.0 इस्तेमाल करने का सुझाव देते हैं.
- क्या आपके पास लेगसी वर्शन 2.3 इस्तेमाल है? – नए वर्शन का इस्तेमाल करने के लिए, अपने ऐप्लिकेशन को अपडेट करने का तरीका जानने के लिए, डेटा को दूसरी जगह भेजने से जुड़ी गाइड पढ़ें.
शुरू करें
क्या आपको अभी शुरू करना है? Hello Analytics API का ट्यूटोरियल पढ़ें.
एपीआई का इस्तेमाल करने वाले हर ऐप्लिकेशन को रजिस्टर करने, उपयोगकर्ता को अनुमति देने, और एपीआई के साथ काम करने के लिए, कुछ चरणों से गुज़रना होगा. इस ट्यूटोरियल में आपको हर चरण के बारे में बताया जाएगा और आखिर में आपके पास एक ऐसा ऐप्लिकेशन होगा जिसे आप अपनी पसंद के मुताबिक बना सकते हैं.
कॉन्सेप्ट के बारे में खास जानकारी
Core Reporting API की मदद से की जाने वाली रिपोर्ट का डेटा, Google Analytics ट्रैकिंग कोड से इकट्ठा किए गए डेटा से मिलता है. हर रिपोर्ट, डाइमेंशन और मेट्रिक के हिसाब से व्यवस्थित होती है. पसंद के मुताबिक रिपोर्ट बनाने के लिए, डाइमेंशन और मेट्रिक की क्वेरी करने के लिए Core Reporting API का इस्तेमाल किया जाता है.
Core Reporting API के तीन बुनियादी सिद्धांत हैं:
- रिपोर्ट, उपयोगकर्ताओं और व्यू (प्रोफ़ाइल) से किस तरह जुड़ी हुई हैं.
- रिपोर्ट की संरचना और क्वेरी बनाने का तरीका
- एपीआई से मिले रिस्पॉन्स के साथ काम करना
रिपोर्ट, उपयोगकर्ता और दृश्य (प्रोफ़ाइल)
किसी उपयोगकर्ता की रिपोर्ट के डेटा का अनुरोध करने के लिए, आपके ऐप्लिकेशन को उपयोगकर्ता की पहचान करनी होगी. साथ ही, वह व्यू (प्रोफ़ाइल) तय करना होगा जिसके लिए डेटा को वापस लाया जा सके. एक उपयोगकर्ता की पहचान, अनुमति देने वाले क्रेडेंशियल हासिल करके और उन्हें हर एपीआई अनुरोध में पास करके की जाती है. व्यू (प्रोफ़ाइल), Google Analytics कॉन्फ़िगरेशन की हैरारकी का हिस्सा है और इसकी पहचान व्यू (प्रोफ़ाइल) आईडी से की जाती है.
व्यू (प्रोफ़ाइल) आईडी ढूंढने के कई तरीके हैं.
- आपका ऐप्लिकेशन, व्यू (प्रोफ़ाइल) आईडी पाने के लिए, मैनेजमेंट कॉन्फ़िगरेशन की हैरारकी को ट्रैवर्स करने के लिए Management API का इस्तेमाल कर सकता है.
- Google Analytics में हर रिपोर्ट के यूआरएल में.
स्क्रीन शॉट
- Google Analytics के मेन्यू बार में, एडमिन पर क्लिक करें. वह खाता और प्रॉपर्टी चुनें जिससे
व्यू जुड़ा है. व्यू कॉलम में, व्यू सेटिंग पर क्लिक करके
व्यू आईडी पाएं.
स्क्रीन शॉट
डाइमेंशन और मेट्रिक के लिए क्वेरी करना
Google Analytics की रिपोर्ट के डेटा के लिए, एपीआई से क्वेरी की जाती है. डेटा में डाइमेंशन और मेट्रिक शामिल होती हैं. मेट्रिक, आपकी प्रॉपर्टी पर उपयोगकर्ता गतिविधि के अलग-अलग मेज़रमेंट को कहते हैं, जैसे कि सेशन और पेज व्यू. डाइमेंशन, मेट्रिक को देश या ब्राउज़र जैसी कुछ सामान्य शर्तों के हिसाब से बांटते हैं. क्वेरी बनाते समय, यह तय किया जाता है कि आपको अपनी रिपोर्ट के डेटा में कौनसे डाइमेंशन और मेट्रिक शामिल करनी हैं.
एपीआई की मदद से दिखाए गए सभी डाइमेंशन और मेट्रिक के बारे में जानने के लिए, इंटरैक्टिव डाइमेंशन और मेट्रिक रेफ़रंस गाइड का इस्तेमाल करें. एपीआई क्वेरी में डाइमेंशन और मेट्रिक की जानकारी देने का तरीका जानने के लिए, कोर रिपोर्टिंग एपीआई के रेफ़रंस गाइड भी पढ़ें.
रिपोर्ट की मदद से काम करना
एपीआई के ज़रिए दिखाए गए डेटा को एक टेबल माना जा सकता है. इसमें हेडर और पंक्तियों की एक सूची होती है. हर एपीआई के रिस्पॉन्स में एक हेडर होता है. इससे, हर कॉलम के नाम और डेटा टाइप की जानकारी मिलती है. जवाब में पंक्तियों की एक सूची भी होती है, जहां हर पंक्ति उन सेल की सूची होती है जिनमें डेटा उसी क्रम में होता है जैसे हेडर का होता है. हर सेल में डेटा का टाइप तय करने के लिए, हेडर में दी गई जानकारी का इस्तेमाल किया जाता है.
एपीआई से मिले रिस्पॉन्स के बारे में ज़्यादा जानने के लिए, कोर रिपोर्टिंग एपीआई के रेफ़रंस गाइड पढ़ें.
कोटा और रोकने की नीतियां
Google Analytics API लाखों काम मैनेज करता है. सिस्टम को ज़रूरत से ज़्यादा कार्रवाइयां न करने के लिए, कोटा सिस्टम का इस्तेमाल करना ज़रूरी है. इससे यह भी पक्का किया जाता है कि सिस्टम के संसाधनों को समान तरीके से बांटा जाए. खास सीमाओं के बारे में जानने के लिए, सीमाएं और कोटा गाइड पढ़ें.
कोर रिपोर्टिंग एपीआई कॉलम (जैसे, डाइमेंशन और मेट्रिक) में किए गए बदलावों को कैसे मैनेज किया जाता है, इस बारे में ज़्यादा जानने के लिए डेटा रोकने की नीति पढ़ें. यह जानने के लिए कि Metadata API का इस्तेमाल, काम न करने वाले कॉलम की जांच करने के लिए कैसे किया जा सकता है. इसके लिए, Metadata API Dev गाइड देखें.
अगले चरण
अब आपको एपीआई के काम करने का तरीका समझ आ गया है. इसलिए, अब हमारे पास कुछ संसाधन हैं, जिनकी मदद से एपीआई के इस्तेमाल का तरीका बदला जा सकता है:
- एपीआई के साथ काम करने का तरीका जानने के लिए, डेवलपर गाइड पढ़ें.
- विज़ुअल तौर पर क्वेरी बनाने और एपीआई की मदद से रिस्पॉन्स देखने के लिए, इंटरैक्टिव क्वेरी एक्सप्लोरर टूल का इस्तेमाल करें.
- सामान्य क्वेरी का लेख पढ़ें. इसमें, Core Reporting API की कई सबसे आम क्वेरी की सूची दी गई है.
- एपीआई के ज़रिए उपलब्ध पूरे डेटा की सूची के लिए, डाइमेंशन और मेट्रिक रेफ़रंस देखें.
- इस एपीआई के साथ इस्तेमाल की जा सकने वाली सभी क्लाइंट लाइब्रेरी की सूची देखने के लिए, लाइब्रेरी और सैंपल पेज पर जाएं.