खास जानकारी

इस दस्तावेज़ में, Google Analytics रीयल-टाइम रिपोर्टिंग एपीआई के बारे में जानकारी दी गई है. एपीआई के बारे में ज़्यादा जानने के लिए, एपीआई का रेफ़रंस लेख पढ़ें.

शुरुआती जानकारी

रीयल टाइम रिपोर्टिंग एपीआई से आपको पुष्टि किए गए उपयोगकर्ता के लिए, रीयल-टाइम डेटा—उदाहरण के लिए, आपकी प्रॉपर्टी पर होने वाली रीयल-टाइम गतिविधि—का अनुरोध करने की सुविधा मिलती है.

रीयल टाइम रिपोर्टिंग एपीआई का इस्तेमाल इन कामों के लिए किया जा सकता है:

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

Google Analytics सुपर प्रॉक्सी

Google Analytics सुपर प्रॉक्सी का इस्तेमाल करके, Google Analytics API के साथ पुष्टि करने, कैश मेमोरी में सेव करने, और एपीआई से मिले रिस्पॉन्स को सीधे विज़ुअलाइज़ेशन और चार्ट लाइब्रेरी के साथ इस्तेमाल किए जाने वाले फ़ॉर्मैट में बदलने से जुड़े कई काम मैनेज करें.

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

Real Time Reporting API से जुड़ी बुनियादी बातें यहां दी गई हैं:

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

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

किसी व्यू (प्रोफ़ाइल) से अपने रिपोर्ट डेटा का अनुरोध करने के लिए, उपयोगकर्ताओं को आपके ऐप्लिकेशन का इस्तेमाल करने से पहले, ये काम करने होंगे:

  1. Google Analytics API चालू करें.
  2. अपने ऐप्लिकेशन के एपीआई ऐक्सेस करने के लिए, क्रेडेंशियल बनाएं.
  3. अपने आवेदन में क्रेडेंशियल डालें.

रिपोर्ट डेटा का अनुरोध करने के लिए आपके ऐप्लिकेशन का इस्तेमाल करते समय, उपयोगकर्ताओं को डेटा ऐक्सेस करने के लिए अनुमति देनी होती है.

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

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

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

एपीआई में उपलब्ध सभी डाइमेंशन और मेट्रिक [एक्सपोज़्ड] के बारे में जानने के लिए, डाइमेंशन और मेट्रिक की रेफ़रंस गाइड का इस्तेमाल करें. साथ ही, किसी एपीआई क्वेरी में डाइमेंशन और मेट्रिक की जानकारी देने का तरीका जानने के लिए, रीयल टाइम रिपोर्टिंग एपीआई रेफ़रंस गाइड पढ़ें.

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

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

कोटा नीति

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

अगले चरण

अब आपको एपीआई के काम करने का तरीका पता चल गया है, तो इसका इस्तेमाल शुरू करें: