इवेंट लॉग करें

इस गाइड में, अपने ऐप्लिकेशन में इवेंट लॉग करने का तरीका बताया गया है.

इवेंट से आपको यह इनसाइट मिलती है कि आपके ऐप्लिकेशन में क्या हो रहा है, जैसे कि उपयोगकर्ता की कार्रवाइयां, सिस्टम में होने वाले इवेंट या गड़बड़ियां.

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

शुरू करने से पहले

पक्का करें कि आपने अपना प्रोजेक्ट सेट अप कर लिया हो और आपके पास 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'
});analytics_log_event_params.js

Web

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});index.js

सुझाए गए पैरामीटर के अलावा, किसी भी इवेंट में ये पैरामीटर जोड़े जा सकते हैं:

कस्टम पैरामीटर: 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'});analytics_log_event_custom_params.js

Web

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});index.js

डैशबोर्ड में इवेंट देखना

Firebase कंसोल के डैशबोर्ड में, अपने इवेंट के बारे में एग्रीगेट किए गए आंकड़े देखे जा सकते हैं. ये डैशबोर्ड, दिन भर में समय-समय पर अपडेट होते रहते हैं. तुरंत जांच करने के लिए, पिछले सेक्शन में बताए गए तरीके से logcat आउटपुट का इस्तेमाल करें.

इस डेटा को Firebase कंसोल में, इवेंट डैशबोर्ड से ऐक्सेस किया जा सकता है. यह डैशबोर्ड, इवेंट रिपोर्ट दिखाता है. ये रिपोर्ट, आपके ऐप्लिकेशन से लॉग किए गए हर अलग तरह के इवेंट के लिए अपने-आप बन जाती हैं.