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

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

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

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'
});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 कंसोल में, इवेंट डैशबोर्ड से यह डेटा ऐक्सेस किया जा सकता है. यह डैशबोर्ड ऐसी इवेंट रिपोर्ट दिखाता है जो आपके ऐप्लिकेशन से लॉग किए गए हर अलग तरह के इवेंट के लिए अपने-आप बनाई जाती हैं.