इस दस्तावेज़ में, Google Analytics के रीयल टाइम रिपोर्टिंग एपीआई के बारे में जानकारी दी गई है. एपीआई की ज़्यादा जानकारी के लिए, एपीआई का रेफ़रंस पढ़ें.
शुरुआती जानकारी
रीयल टाइम रिपोर्टिंग एपीआई की मदद से, पुष्टि किए गए उपयोगकर्ता के लिए रीयल-टाइम डेटा का अनुरोध किया जा सकता है. जैसे, आपकी प्रॉपर्टी पर रीयल-टाइम गतिविधि.
रीयल-टाइम रिपोर्टिंग एपीआई का इस्तेमाल इन कामों के लिए किया जा सकता है:
- किसी पेज के सक्रिय दर्शकों को दिखाएं. इससे ऐसा लगता है कि उपयोगकर्ता किसी तय इन्वेंट्री वाले आइटम को तुरंत देख रहे हैं.
- सबसे लोकप्रिय कॉन्टेंट दिखाएं, जैसे कि सबसे लोकप्रिय 10 पेज.
- रीयल-टाइम डैशबोर्ड बनाएं और दिखाएं.
Google Analytics सुपर प्रॉक्सी
Google Analytics सुपर प्रॉक्सी का इस्तेमाल करके, Google Analytics API के साथ काम करने से जुड़े कई काम मैनेज करें. इससे, आपको एपीआई की जांच के नतीजों की पुष्टि करने, उन्हें कैश मेमोरी में सेव करने, और एपीआई से मिले रिस्पॉन्स को सीधे विज़ुअलाइज़ेशन और चार्ट लाइब्रेरी के साथ इस्तेमाल किए जाने वाले फ़ॉर्मैट में बदलने से जुड़े काम करने में मदद मिलेगी.
कॉन्सेप्ट के बारे में खास जानकारी
Real Time Reporting API से जुड़ी बुनियादी बातें यहां दी गई हैं:
- रिपोर्ट, उपयोगकर्ताओं और व्यू (प्रोफ़ाइल) से किस तरह जुड़ी हुई हैं.
- रिपोर्ट की संरचना और क्वेरी बनाने का तरीका.
- एपीआई से मिले रिस्पॉन्स के साथ काम करना.
रिपोर्ट, उपयोगकर्ता और दृश्य (प्रोफ़ाइल)
किसी व्यू (प्रोफ़ाइल से) से अपने रिपोर्ट डेटा का अनुरोध करने के लिए, उपयोगकर्ता आपके ऐप्लिकेशन का इस्तेमाल कर सकें, इसके लिए आपको:
- Google Analytics API चालू करें.
- अपने ऐप्लिकेशन के लिए क्रेडेंशियल बनाएं, ताकि एपीआई ऐक्सेस किया जा सके.
- अपने आवेदन में क्रेडेंशियल डालें.
रिपोर्ट डेटा का अनुरोध करने के लिए आपके ऐप्लिकेशन का इस्तेमाल करते समय, उपयोगकर्ताओं को अपनी ओर से डेटा ऐक्सेस करने की अनुमति देनी होती है.
व्यू (प्रोफ़ाइल) की पहचान, व्यू (प्रोफ़ाइल) आईडी से की जाती है. दूसरी इकाइयों के साथ-साथ, व्यू (प्रोफ़ाइल) भी Google Analytics खातों, उपयोगकर्ताओं, प्रॉपर्टी, और व्यू की हैरारकी का हिस्सा होते हैं. आपका ऐप्लिकेशन, इस हैरारकी को पार करने और व्यू (प्रोफ़ाइल) पाने के लिए, Management API का इस्तेमाल कर सकता है.
डाइमेंशन और मेट्रिक के लिए क्वेरी करना
Google Analytics की रिपोर्ट के डेटा के लिए, एपीआई से क्वेरी की जाती है. डेटा में डाइमेंशन और मेट्रिक शामिल होती हैं. मेट्रिक, उपयोगकर्ता गतिविधि के अलग-अलग मेज़रमेंट को कहते हैं. जैसे, अभी प्रॉपर्टी पर सक्रिय उपयोगकर्ताओं की संख्या. डाइमेंशन, मेट्रिक को कुछ सामान्य शर्तों के हिसाब से बांटते हैं. जैसे, ट्रैफ़िक सोर्स, भौगोलिक जगह, पेज की जानकारी वगैरह.
एपीआई में उपलब्ध सभी डाइमेंशन और मेट्रिक [एक्सपोज़्ड थ्रू] के बारे में जानने के लिए, डाइमेंशन और मेट्रिक रेफ़रंस गाइड का इस्तेमाल करें. साथ ही, किसी एपीआई क्वेरी में डाइमेंशन और मेट्रिक की जानकारी देने का तरीका जानने के लिए, रीयल-टाइम रिपोर्टिंग एपीआई के बारे में बताने वाली गाइड पढ़ें.
रिपोर्ट की मदद से काम करना
एपीआई से मिले डेटा को एक टेबल के तौर पर देखा जा सकता है. इसमें हेडर और पंक्तियों की सूची होती है. हर एपीआई के रिस्पॉन्स में एक हेडर होता है. इससे, हर कॉलम के नाम और डेटा टाइप की जानकारी मिलती है. इस जवाब में पंक्तियों की एक सूची भी होती है. इसमें हर पंक्ति, उन सेल की सूची होती है जिनमें डेटा हेडर के क्रम में होता है. एपीआई से मिले रिस्पॉन्स के बारे में ज़्यादा जानकारी के लिए, रीयल-टाइम रिपोर्टिंग एपीआई के रेफ़रंस गाइड पढ़ें.
कोटा नीति
Real Time Reporting API, डेटा क्वेरी से जुड़ी लाखों कार्रवाइयों को मैनेज करता है. हम कोटा सिस्टम का इस्तेमाल करते हैं, ताकि सिस्टम को ज़रूरत से ज़्यादा कार्रवाइयां न करनी पड़े. साथ ही, यह पक्का किया जा सके कि सिस्टम के संसाधनों को बराबर-बराबर बांटा जाए. ज़्यादा जानकारी के लिए, सीमा और कोटा से जुड़ी गाइड पढ़ें.
अगले चरण
अब जब आपने एपीआई के काम करने का तरीका समझ लिया है, तो शुरू करने के लिए यह तरीका अपनाएं:
- एपीआई के साथ काम करने का तरीका जानने के लिए, डेवलपर गाइड पढ़ें.
- एपीआई के ज़रिए उपलब्ध सभी डेटा की सूची के लिए, डाइमेंशन और मेट्रिक रेफ़रंस गाइड देखें.
- एपीआई के साथ इस्तेमाल की जा सकने वाली सभी क्लाइंट लाइब्रेरी की सूची देखने के लिए, लाइब्रेरी और सैंपल पेज पर जाएं.