Core Reporting API क्या है - खास जानकारी

इस दस्तावेज़ में, 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 इस्तेमाल है? – अपने ऐप्लिकेशन को नए वर्शन का इस्तेमाल करने के लिए अपडेट करने का तरीका जानने के लिए, डेटा को दूसरी जगह भेजने से जुड़ी गाइड पढ़ें.

YouTube पर शुरुआत करना

क्या आपको अभी शुरू करना है? नमस्ते Analytics API ट्यूटोरियल पढ़ें.

एपीआई का इस्तेमाल करने वाले हर ऐप्लिकेशन को रजिस्टर करने, उपयोगकर्ता की अनुमति देने, और एपीआई के साथ काम करने के लिए, कुछ चरणों से पूरा करना होगा. इस ट्यूटोरियल में आपको हर चरण के बारे में बताया जाएगा. आखिर में, आपके पास एक ऐसा ऐप्लिकेशन होगा जिसे अपनी पसंद के मुताबिक बनाया जा सकता है.

सैद्धांतिक जानकारी

Core Reporting API की मदद से Google Analytics के ट्रैकिंग कोड से इकट्ठा किए गए आंकड़ों से मिला डेटा दिखता है. हर रिपोर्ट, डाइमेंशन और मेट्रिक के हिसाब से व्यवस्थित होती है. पसंद के मुताबिक रिपोर्ट बनाने के लिए, Core Reporting API का इस्तेमाल करके डाइमेंशन और मेट्रिक की क्वेरी की जाती है.

Core Reporting API में तीन बुनियादी सिद्धांत हैं:

  1. रिपोर्ट, उपयोगकर्ताओं और व्यू (प्रोफ़ाइल) से किस तरह जुड़ी होती हैं.
  2. रिपोर्ट की संरचना और क्वेरी बनाने का तरीका
  3. एपीआई से मिले रिस्पॉन्स के साथ काम करना

रिपोर्ट, उपयोगकर्ता और व्यू (प्रोफ़ाइल)

किसी उपयोगकर्ता की रिपोर्ट के डेटा का अनुरोध करने के लिए, आपके ऐप्लिकेशन को उपयोगकर्ता की पहचान करनी होगी. साथ ही, वह व्यू (प्रोफ़ाइल) तय करना होगा जिसके लिए डेटा को वापस लाना है. उपयोगकर्ता की पहचान, अनुमति देने वाले क्रेडेंशियल हासिल करके और उन्हें हर एपीआई अनुरोध में पास करके की जाती है. व्यू (प्रोफ़ाइल), Google Analytics के कॉन्फ़िगरेशन की हैरारकी का हिस्सा है और इसकी पहचान व्यू (प्रोफ़ाइल) आईडी से की जाती है.

व्यू (प्रोफ़ाइल) आईडी को खोजने के कई तरीके हैं.

  • आपका ऐप्लिकेशन, व्यू (प्रोफ़ाइल) आईडी पाने के लिए, मैनेजमेंट कॉन्फ़िगरेशन हैरारकी को पार करने के लिए Management API का इस्तेमाल कर सकता है.
  • Google Analytics में हर रिपोर्ट के यूआरएल में.
  • Google Analytics के मेन्यू बार में मौजूद, एडमिन पर क्लिक करें. वह खाता और प्रॉपर्टी चुनें जिससे यह व्यू जुड़ा है. व्यू कॉलम में, व्यू सेटिंग पर क्लिक करके व्यू आईडी पाएं.

डाइमेंशन और मेट्रिक के लिए क्वेरी करना

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

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

रिपोर्ट की मदद से काम करना

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

एपीआई से मिले रिस्पॉन्स के बारे में ज़्यादा जानने के लिए, Core Reporting API की रेफ़रंस गाइड पढ़ें.

वापस सबसे ऊपर जाएं

कोटा और सीमा से जुड़ी नीतियां

Google Analytics API लाखों काम मैनेज करता है. सिस्टम को ज़रूरत से ज़्यादा कार्रवाइयां न करनी पड़े, इसके लिए एक कोटा सिस्टम का इस्तेमाल करना ज़रूरी है. इससे सिस्टम के संसाधनों का बंटवारा एक समान तरीके से होगा. खास सीमाओं के लिए, सीमाएं और कोटा से जुड़ी गाइड पढ़ें.

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

अगले चरण

अब आपको एपीआई के काम करने का तरीका समझ आ गया है. इसलिए, अब हमारे पास कई ऐसे संसाधन हैं जिनकी मदद से, एपीआई का इस्तेमाल शुरू किया जा सकता है:

  • एपीआई के साथ काम करने का तरीका जानने के लिए, डेवलपर गाइड पढ़ें.
  • क्वेरी को विज़ुअल तरीके से बनाने और एपीआई के ज़रिए जवाब देखने के लिए, इंटरैक्टिव क्वेरी एक्सप्लोरर टूल का इस्तेमाल करें.
  • सामान्य क्वेरी लेख पढ़ें. इसमें Core Reporting API की आम तौर पर की जाने वाली कई क्वेरी की सूची दी गई है.
  • एपीआई के ज़रिए उपलब्ध सारे डेटा की सूची के लिए, डाइमेंशन और मेट्रिक रेफ़रंस देखें.
  • इस एपीआई के साथ इस्तेमाल की जा सकने वाली सभी उपलब्ध क्लाइंट लाइब्रेरी की सूची देखने के लिए, लाइब्रेरी और सैंपल पेज पर जाएं.

वापस सबसे ऊपर जाएं