इस गाइड में, अपने ऐप्लिकेशन में इवेंट लॉग करने का तरीका बताया गया है.
इवेंट से आपको यह इनसाइट मिलती है कि आपके ऐप्लिकेशन में क्या हो रहा है, जैसे कि उपयोगकर्ता की कार्रवाइयां, सिस्टम में होने वाले इवेंट या गड़बड़ियां.
Analytics आपके लिए कुछ इवेंट अपने-आप लॉग करता है. इन्हें पाने के लिए, आपको कोई कोड जोड़ने की ज़रूरत नहीं है. अगर आपके ऐप्लिकेशन को ज़्यादा डेटा इकट्ठा करना है, तो उसमें Analytics इवेंट के 500 तरह के टाइप लॉग किए जा सकते हैं. आपके ऐप्लिकेशन लॉग में, इवेंट की संख्या की कोई सीमा तय नहीं है. ध्यान दें कि इवेंट के नाम केस-सेंसिटिव होते हैं. अगर दो इवेंट के नाम में सिर्फ़ अक्षरों का अंतर है, तो वे दोनों अलग-अलग इवेंट के तौर पर दिखेंगे.
शुरू करने से पहले
पक्का करें कि आपने अपना प्रोजेक्ट सेट अप कर लिया हो और आपके पास Analytics का इस्तेमाल शुरू करना लेख में बताए गए तरीके से Analytics को ऐक्सेस करने की अनुमति हो.
इवेंट लॉग करना
firebase.analytics()
इंस्टेंस को कॉन्फ़िगर करने के बाद, logEvent()
तरीके से इवेंट लॉग किए जा सकते हैं. अगर आपको Google Analytics के बारे में पहले से पता है, तो यह तरीका gtag.js में event
निर्देश का इस्तेमाल करने के बराबर है.
शुरू करने में आपकी मदद करने के लिए, Analytics SDK कई तरह के सुझाए गए इवेंट की जानकारी देता है, जो अलग-अलग तरह के ऐप्लिकेशन में आम हैं. इनमें रीटेल और ई-कॉमर्स, यात्रा, और गेमिंग ऐप्लिकेशन शामिल हैं. इन इवेंट के बारे में और इनका इस्तेमाल कब करना चाहिए, इसके बारे में ज़्यादा जानने के लिए सुझाए गए इवेंट देखें.
ध्यान दें: रिपोर्ट में ज़्यादा से ज़्यादा जानकारी पाने के लिए, सुझाए गए ऐसे इवेंट लॉग करें जो आपके ऐप्लिकेशन के लिए काम के हों. साथ ही, उनके तय पैरामीटर भी लॉग करें. इससे यह भी पक्का होता है कि Google Analytics की नई सुविधाएं उपलब्ध होने पर, आपको उनका फ़ायदा मिल सके.
gtag.js इवेंट रेफ़रंस में, कई इवेंट और उनके पैरामीटर को लागू करने के बारे में जानकारी मिल सकती है.
यहां दिए गए उदाहरण में, select_content
इवेंट को लॉग करने का तरीका बताया गया है:
Web
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'select_content', { content_type: 'image', content_id: 'P12453' });
Web
analytics.logEvent('select_content', { content_type: 'image', content_id: 'P12453', items: [{ name: 'Kittens' }] });
सुझाए गए पैरामीटर के अलावा, किसी भी इवेंट में ये पैरामीटर जोड़े जा सकते हैं:
कस्टम पैरामीटर: Analytics रिपोर्ट में, कस्टम पैरामीटर का इस्तेमाल डाइमेंशन या मेट्रिक के तौर पर किया जा सकता है. बिना संख्या वाले इवेंट पैरामीटर डेटा के लिए कस्टम डाइमेंशन और संख्या के तौर पर बेहतर तरीके से दिखाए जाने वाले किसी भी पैरामीटर डेटा के लिए, कस्टम मेट्रिक का इस्तेमाल किया जा सकता है. SDK टूल का इस्तेमाल करके कस्टम पैरामीटर को लॉग करने के बाद, डाइमेंशन या मेट्रिक को रजिस्टर करें, ताकि यह पक्का किया जा सके कि वे कस्टम पैरामीटर Analytics रिपोर्ट में दिखें. ऐसा करने के लिए: Analytics > इवेंट > कस्टम डेफ़िनिशन मैनेज करें > कस्टम डाइमेंशन बनाएं
कस्टम पैरामीटर का इस्तेमाल, ऑडियंस की उन परिभाषाओं में किया जा सकता है जिन्हें हर रिपोर्ट पर लागू किया जा सकता है. अगर आपका ऐप्लिकेशन किसी BigQuery प्रोजेक्ट से लिंक है, तो BigQuery में एक्सपोर्ट किए गए डेटा में भी कस्टम पैरामीटर शामिल होते हैं. Google Analytics 4 BigQuery Export पर, सैंपल क्वेरी और इससे जुड़ी अन्य जानकारी पाएं.
value
पैरामीटर:value
एक सामान्य पैरामीटर है. यह किसी इवेंट से जुड़ी मुख्य मेट्रिक को इकट्ठा करने के लिए काम आता है. उदाहरण के लिए, रेवेन्यू, दूरी, समय, और पॉइंट.
अगर आपके ऐप्लिकेशन की कुछ खास ज़रूरतें हैं और इन्हें सुझाए गए इवेंट टाइप से पूरा नहीं किया जा सकता, तो अपने हिसाब से कस्टम इवेंट लॉग किए जा सकते हैं. उदाहरण के लिए, अगर कोई गेम डेवलप किया जा रहा है और आपको यह ट्रैक करना है कि कोई खिलाड़ी कब कोई खास लक्ष्य पूरा करता है, तो इस तरह के इवेंट को लॉग किया जा सकता है:
Web
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});
Web
analytics.logEvent('goal_completion', { name: 'lever_puzzle'});
डैशबोर्ड में इवेंट देखना
Firebase कंसोल के डैशबोर्ड में, अपने इवेंट के बारे में एग्रीगेट किए गए आंकड़े देखे जा सकते हैं. ये डैशबोर्ड, दिन भर में समय-समय पर अपडेट होते रहते हैं. तुरंत जांच करने के लिए, पिछले सेक्शन में बताए गए तरीके से logcat आउटपुट का इस्तेमाल करें.
इस डेटा को Firebase कंसोल में, इवेंट डैशबोर्ड से ऐक्सेस किया जा सकता है. यह डैशबोर्ड, इवेंट रिपोर्ट दिखाता है. ये रिपोर्ट, आपके ऐप्लिकेशन से लॉग किए गए हर अलग तरह के इवेंट के लिए अपने-आप बन जाती हैं.