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