Catch up on highlights from Firebase at Google I/O 2023. Learn more

लॉग इवेंट

यह मार्गदर्शिका आपको दिखाती है कि अपने ऐप में ईवेंट कैसे लॉग करें।

ईवेंट इस बात की जानकारी प्रदान करते हैं कि आपके ऐप में क्या हो रहा है, जैसे कि उपयोगकर्ता क्रियाएँ, सिस्टम ईवेंट या त्रुटियाँ।

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

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

सुनिश्चित करें कि आपने अपना प्रोजेक्ट सेट अप कर लिया है और आप Analytics तक पहुंच सकते हैं, जैसा कि Analytics के साथ प्रारंभ करें में बताया गया है.

घटनाओं को लॉग करें

आपके द्वारा firebase.analytics() इंस्टेंस को कॉन्फ़िगर करने के बाद, आप logEvent() मेथड से ईवेंट लॉग करना शुरू कर सकते हैं। यदि आप पहले से ही Google Analytics से परिचित हैं, तो यह विधि gtag.js में event कमांड का उपयोग करने के समान है।

आरंभ करने में आपकी सहायता करने के लिए, Analytics SDK कई अनुशंसित ईवेंट परिभाषित करता है, जो खुदरा और ई-कॉमर्स, यात्रा और गेमिंग ऐप्स सहित विभिन्न प्रकार के ऐप्स में आम हैं। इन घटनाओं के बारे में और जानने के लिए और उनका उपयोग कब करना है, अनुशंसित घटनाएं देखें।

नोट: रिपोर्ट में अधिकतम विवरण प्राप्त करने के लिए, अनुशंसित ईवेंट लॉग करें जो आपके ऐप और उनके निर्धारित पैरामीटर के लिए मायने रखते हैं। यह यह भी सुनिश्चित करता है कि आप नवीनतम Google Analytics सुविधाओं के उपलब्ध होते ही उनसे लाभान्वित हों।

आप gtag.js इवेंट संदर्भ में कई इवेंट के कार्यान्वयन विवरण और उनके पैरामीटर देख सकते हैं.

निम्न उदाहरण प्रदर्शित करता है कि किसी select_content ईवेंट को कैसे लॉग करना है:

Web modular API

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

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

Web namespaced API

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 modular API

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

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

Web namespaced API

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

डैशबोर्ड में ईवेंट देखें

आप फायरबेस कंसोल डैशबोर्ड में अपने ईवेंट के बारे में एकत्रित आंकड़े देख सकते हैं। ये डैशबोर्ड पूरे दिन समय-समय पर अपडेट होते रहते हैं। तत्काल परीक्षण के लिए, पिछले अनुभाग में वर्णित लॉगकैट आउटपुट का उपयोग करें।

आप इस डेटा को फायरबेस कंसोल में इवेंट डैशबोर्ड से एक्सेस कर सकते हैं। यह डैशबोर्ड इवेंट रिपोर्ट दिखाता है जो आपके ऐप द्वारा लॉग किए गए प्रत्येक विशिष्ट प्रकार के इवेंट के लिए स्वचालित रूप से बनाई जाती हैं।