लॉग इवेंट

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

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

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

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

सुनिश्चित करें कि आपने अपना प्रोजेक्ट सेट अप कर लिया है और एनालिटिक्स के साथ आरंभ करें में वर्णित अनुसार एनालिटिक्स तक पहुंच सकते हैं।

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

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

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

नोट: रिपोर्ट में अधिकतम विवरण प्राप्त करने के लिए, अनुशंसित ईवेंट लॉग करें जो आपके ऐप और उनके निर्धारित मापदंडों के लिए उपयुक्त हों। इससे यह भी सुनिश्चित होता है कि नवीनतम 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' }]
});

निर्धारित मापदंडों के अतिरिक्त, आप किसी भी ईवेंट में निम्नलिखित पैरामीटर जोड़ सकते हैं:

  • कस्टम पैरामीटर: कस्टम पैरामीटर का उपयोग एनालिटिक्स रिपोर्ट में आयाम या मीट्रिक के रूप में किया जा सकता है। आप गैर-संख्यात्मक ईवेंट पैरामीटर डेटा के लिए कस्टम आयाम और संख्यात्मक रूप से बेहतर प्रतिनिधित्व वाले किसी भी पैरामीटर डेटा के लिए कस्टम मेट्रिक्स का उपयोग कर सकते हैं। एक बार जब आप एसडीके का उपयोग करके एक कस्टम पैरामीटर लॉग कर लेते हैं, तो यह सुनिश्चित करने के लिए आयाम या मीट्रिक पंजीकृत करें कि वे कस्टम पैरामीटर एनालिटिक्स रिपोर्ट में दिखाई दें। ऐसा इसके माध्यम से करें: एनालिटिक्स > इवेंट > कस्टम परिभाषाएँ प्रबंधित करें > कस्टम आयाम बनाएँ

    कस्टम पैरामीटर का उपयोग ऑडियंस परिभाषाओं में किया जा सकता है जिन्हें हर रिपोर्ट पर लागू किया जा सकता है। यदि आपका ऐप किसी BigQuery प्रोजेक्ट से जुड़ा हुआ है तो BigQuery पर निर्यात किए गए डेटा में कस्टम पैरामीटर भी शामिल किए जाते हैं। Google Analytics 4 BigQuery निर्यात पर नमूना क्वेरीज़ और बहुत कुछ ढूंढें।

  • 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'});

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

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

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