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

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

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

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

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

पक्का करें कि आपने अपना प्रोजेक्ट सेट अप कर लिया हो और आपके पास Analytics का ऐक्सेस हो. इसके बारे में Analytics का इस्तेमाल शुरू करना लेख में बताया गया है.

लॉग इवेंट

firebase.analytics() इंस्टेंस को कॉन्फ़िगर करने के बाद, logEvent() तरीके से इवेंट लॉग किए जा सकते हैं. अगर आपको Google Analytics के बारे में पहले से पता है, तो यह तरीका gtag.js में event कमांड का इस्तेमाल करने के बराबर है.

शुरू करने में आपकी मदद करने के लिए, Analytics SDK टूल में कई ऐसे इवेंट तय किए गए हैं जिन्हें इस्तेमाल करने का सुझाव दिया जाता है. ये इवेंट, अलग-अलग तरह के ऐप्लिकेशन में आम तौर पर इस्तेमाल किए जाते हैं. जैसे, खुदरा और ई-कॉमर्स, यात्रा, और गेमिंग ऐप्लिकेशन. इन इवेंट के बारे में ज़्यादा जानने के लिए और इनका इस्तेमाल कब करना चाहिए, सुझाए गए इवेंट देखें.

ध्यान दें: रिपोर्ट में ज़्यादा जानकारी पाने के लिए, सुझाए गए उन इवेंट को लॉग करें जो आपके ऐप्लिकेशन के लिए काम के हैं. साथ ही, उनके तय पैरामीटर भी लॉग करें. इससे यह भी पक्का होता है कि Google Analytics की नई सुविधाएं उपलब्ध होते ही आपको मिल जाएं.

gtag.js इवेंट रेफ़रंस में, कई इवेंट और उनके पैरामीटर को लागू करने के बारे में जानकारी दी गई है.

यहां दिए गए उदाहरण में, select_content इवेंट को लॉग करने का तरीका बताया गया है:

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453'
});
analytics_log_event_params.js

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

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

• कस्टम पैरामीटर: कस्टम पैरामीटर का इस्तेमाल Analytics रिपोर्ट में डाइमेंशन या मेट्रिक के तौर पर किया जा सकता है. कस्टम डाइमेंशन का इस्तेमाल, इवेंट पैरामीटर के ऐसे डेटा के लिए किया जा सकता है जो संख्यात्मक नहीं है. साथ ही, कस्टम मेट्रिक का इस्तेमाल, किसी भी पैरामीटर के ऐसे डेटा के लिए किया जा सकता है जिसे संख्या के तौर पर बेहतर तरीके से दिखाया जा सकता है. एसडीके का इस्तेमाल करके कस्टम पैरामीटर लॉग करने के बाद, डाइमेंशन या मेट्रिक को रजिस्टर करें. इससे यह पक्का किया जा सकेगा कि ये कस्टम पैरामीटर, Analytics रिपोर्ट में दिख रहे हैं. इसके लिए, Analytics > इवेंट > कस्टम डेफ़िनिशन मैनेज करें > कस्टम डाइमेंशन बनाएं पर जाएं

  कस्टम पैरामीटर का इस्तेमाल, ऑडियंस की उन परिभाषाओं में किया जा सकता है जिन्हें हर रिपोर्ट पर लागू किया जा सकता है. अगर आपका ऐप्लिकेशन किसी BigQuery प्रोजेक्ट से लिंक है, तो कस्टम पैरामीटर भी BigQuery में एक्सपोर्ट किए गए डेटा में शामिल होते हैं. Google Analytics 4 BigQuery Export पर, सैंपल क्वेरी और अन्य जानकारी पाएं.

• value पैरामीटर: value एक सामान्य पैरामीटर है. यह किसी इवेंट से जुड़ी मुख्य मेट्रिक को इकट्ठा करने के लिए काम आता है. उदाहरण के लिए, रेवेन्यू, दूरी, समय, और पॉइंट.

अगर आपके ऐप्लिकेशन की ज़रूरतें, सुझाए गए इवेंट टाइप से पूरी नहीं होती हैं, तो आपके पास अपने कस्टम इवेंट लॉग करने का विकल्प होता है. उदाहरण के लिए, अगर आपको कोई गेम डेवलप करना है और आपको यह ट्रैक करना है कि कोई खिलाड़ी किसी लक्ष्य को कब पूरा करता है, तो यहां दिए गए उदाहरण की तरह कोई इवेंट लॉग किया जा सकता है:

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});
analytics_log_event_custom_params.js

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

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

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

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