यह मार्गदर्शिका आपको दिखाती है कि अपने ऐप में ईवेंट कैसे लॉग करें।
ईवेंट आपके ऐप में क्या हो रहा है, इस बारे में जानकारी प्रदान करते हैं, जैसे उपयोगकर्ता क्रियाएं, सिस्टम ईवेंट या त्रुटियां।
Analytics स्वचालित रूप से आपके लिए कुछ ईवेंट लॉग करता है; आपको उन्हें प्राप्त करने के लिए कोई कोड जोड़ने की आवश्यकता नहीं है। यदि आपके ऐप को अतिरिक्त डेटा एकत्र करने की आवश्यकता है, तो आप अपने ऐप में 500 अलग-अलग Analytics ईवेंट प्रकार तक लॉग इन कर सकते हैं। आपके ऐप द्वारा लॉग किए जाने वाले ईवेंट की कुल मात्रा की कोई सीमा नहीं है। ध्यान दें कि ईवेंट के नाम केस-संवेदी होते हैं और दो ईवेंट लॉगिंग जिनके नाम केवल मामले में भिन्न होते हैं, दो अलग-अलग ईवेंट में परिणामित होंगे।
शुरू करने से पहले
सुनिश्चित करें कि आपने अपना प्रोजेक्ट सेट अप कर लिया है और Analytics के साथ प्रारंभ करें में वर्णित अनुसार Analytics तक पहुंच सकते हैं।
लॉग इवेंट
आपके द्वारा FirebaseAnalytics
इंस्टेंस बनाने के बाद, आप इसका उपयोग logEvent()
विधि से ईवेंट लॉग करने के लिए कर सकते हैं।
आरंभ करने में आपकी सहायता के लिए, Analytics SDK ऐसे कई अनुशंसित ईवेंट निर्धारित करता है, जो खुदरा और ईकॉमर्स, यात्रा और गेमिंग ऐप्स सहित विभिन्न प्रकार के ऐप्स में सामान्य हैं। इन ईवेंट के बारे में और उनका उपयोग कब करें, इसके बारे में अधिक जानने के लिए, अनुशंसित ईवेंट देखें.
आप निम्न स्थानों में अनुशंसित ईवेंट प्रकारों के कार्यान्वयन विवरण प्राप्त कर सकते हैं:
- अनुशंसित ईवेंट:
com.google.firebase.analytics.FirebaseAnalytics.Event
वर्ग संदर्भ देखें। - निर्धारित पैरामीटर:
com.google.firebase.analytics.FirebaseAnalytics.Param
संदर्भ देखें।
निम्न उदाहरण दर्शाता है कि SELECT_CONTENT
ईवेंट को कैसे लॉग किया जाए:
Java
Bundle bundle = new Bundle(); bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id); bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name); bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image"); mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
Kotlin+KTX
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) { param(FirebaseAnalytics.Param.ITEM_ID, id) param(FirebaseAnalytics.Param.ITEM_NAME, name) param(FirebaseAnalytics.Param.CONTENT_TYPE, "image") }
निर्धारित मापदंडों के अलावा, आप किसी भी घटना में निम्नलिखित पैरामीटर जोड़ सकते हैं:
कस्टम पैरामीटर: कस्टम पैरामीटर का उपयोग Analytics रिपोर्ट में आयाम या मीट्रिक के रूप में किया जा सकता है. आप गैर-संख्यात्मक ईवेंट पैरामीटर डेटा के लिए कस्टम आयामों का उपयोग कर सकते हैं और संख्यात्मक रूप से बेहतर ढंग से दर्शाए गए किसी भी पैरामीटर डेटा के लिए कस्टम मीट्रिक का उपयोग कर सकते हैं। SDK का उपयोग करके एक कस्टम पैरामीटर लॉग करने के बाद, यह सुनिश्चित करने के लिए आयाम या मीट्रिक पंजीकृत करें कि वे कस्टम पैरामीटर Analytics रिपोर्ट में दिखाई दें. इसके माध्यम से करें: Analytics > ईवेंट > कस्टम परिभाषाएं प्रबंधित करें > कस्टम आयाम बनाएं
कस्टम पैरामीटर का उपयोग ऑडियंस परिभाषाओं में किया जा सकता है जिन्हें प्रत्येक रिपोर्ट पर लागू किया जा सकता है। अगर आपका ऐप्लिकेशन किसी BigQuery प्रोजेक्ट से लिंक है, तो BigQuery को निर्यात किए गए डेटा में कस्टम पैरामीटर भी शामिल किए जाते हैं. Google Analytics 4 BigQuery Export पर नमूना क्वेरी और बहुत कुछ खोजें।
VALUE
पैरामीटर:VALUE
एक सामान्य प्रयोजन पैरामीटर है जो किसी ईवेंट से संबंधित एक प्रमुख मीट्रिक को संचित करने के लिए उपयोगी होता है। उदाहरणों में राजस्व, दूरी, समय और अंक शामिल हैं।
यदि आपके आवेदन की विशिष्ट आवश्यकताएं हैं जो अनुशंसित ईवेंट प्रकार द्वारा कवर नहीं की गई हैं, तो आप अपने स्वयं के कस्टम ईवेंट लॉग कर सकते हैं जैसा कि इस उदाहरण में दिखाया गया है:
Java
Bundle params = new Bundle(); params.putString("image_name", name); params.putString("full_text", text); mFirebaseAnalytics.logEvent("share_image", params);
Kotlin+KTX
firebaseAnalytics.logEvent("share_image") { param("image_name", name) param("full_text", text) }
डिफ़ॉल्ट ईवेंट पैरामीटर सेट करें
आप setDefaultEventParameters
का उपयोग करके सभी ईवेंट में पैरामीटर लॉग कर सकते हैं। डिफ़ॉल्ट पैरामीटर लॉग किए जाने वाले सभी भावी ईवेंट से संबद्ध होते हैं.
कस्टम पैरामीटर की तरह, डिफ़ॉल्ट ईवेंट पैरामीटर पंजीकृत करके सुनिश्चित करें कि वे Analytics रिपोर्ट में दिखाई दें.
Java
Bundle parameters = new Bundle(); params.putString("level_name", "Caverns01"); params.putInt("level_difficulty", 4); mFirebaseAnalytics.setDefaultEventParameters(parameters);
Kotlin+KTX
val parameters = Bundle().apply { this.putString("level_name", "Caverns01") this.putInt("level_difficulty", 4) } firebaseAnalytics.setDefaultEventParameters(parameters)
यदि कोई पैरामीटर logEvent()
विधि में निर्दिष्ट है, तो उस मान का उपयोग डिफ़ॉल्ट के बजाय किया जाता है।
डिफ़ॉल्ट पैरामीटर को साफ़ करने के लिए, setDefaultEventParameters
विधि को पैरामीटर सेट के साथ null
पर कॉल करें।
Android Studio डिबग लॉग में ईवेंट देखें
आप यह सत्यापित करने में सहायता के लिए कि ईवेंट ठीक से लॉग किए जा रहे हैं, SDK द्वारा ईवेंट की लॉगिंग की निगरानी के लिए वर्बोज़ लॉगिंग को सक्षम कर सकते हैं। इसमें स्वचालित रूप से और मैन्युअल रूप से लॉग किए गए ईवेंट दोनों शामिल हैं।
आप adb कमांड की एक श्रृंखला के साथ वर्बोज़ लॉगिंग को सक्षम कर सकते हैं:
adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC
यह आदेश आपके ईवेंट को Android Studio लॉगकैट में प्रदर्शित करता है, जिससे आपको तुरंत यह सत्यापित करने में मदद मिलती है कि ईवेंट भेजे जा रहे हैं।
डैशबोर्ड में ईवेंट देखें
आप Firebase कंसोल डैशबोर्ड में अपने ईवेंट के बारे में समेकित आंकड़े देख सकते हैं. ये डैशबोर्ड पूरे दिन समय-समय पर अपडेट होते रहते हैं। तत्काल परीक्षण के लिए, पिछले अनुभाग में बताए अनुसार लॉगकैट आउटपुट का उपयोग करें।
आप इस डेटा को Firebase कंसोल में ईवेंट डैशबोर्ड से एक्सेस कर सकते हैं. यह डैशबोर्ड उन ईवेंट रिपोर्ट को दिखाता है जो आपके ऐप द्वारा लॉग किए गए प्रत्येक विशिष्ट प्रकार के ईवेंट के लिए स्वचालित रूप से बनाई जाती हैं।