इस गाइड में, अपने ऐप्लिकेशन में इवेंट लॉग करने का तरीका बताया गया है.
इवेंट से यह अहम जानकारी मिलती है कि आपके ऐप्लिकेशन में क्या हो रहा है, जैसे कि उपयोगकर्ता की कार्रवाइयां, सिस्टम इवेंट या गड़बड़ियां.
Analytics आपके लिए कुछ इवेंट अपने-आप लॉग करता है. इवेंट पाने के लिए, आपको कोई कोड जोड़ने की ज़रूरत नहीं है. अगर आपके ऐप्लिकेशन को ज़्यादा डेटा इकट्ठा करना है, तो अपने ऐप्लिकेशन में Analytics इवेंट के 500 अलग-अलग टाइप लॉग किए जा सकते हैं. आपके ऐप्लिकेशन लॉग में इवेंट की संख्या की कोई सीमा नहीं है. ध्यान रखें कि इवेंट के नाम केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होते हैं. इसलिए, अगर दो इवेंट लॉग किए जाते हैं, जिनके नाम में अंतर सिर्फ़ केस-सेंसिटिव होता है, तो दोनों अलग-अलग इवेंट बन जाते हैं.
शुरू करने से पहले
पक्का करें कि आपने अपना प्रोजेक्ट सेट अप कर लिया है और Analytics को Analytics का इस्तेमाल शुरू करें में बताए गए तरीके से ऐक्सेस कर सकते हैं.
इवेंट लॉग करें
FirebaseAnalytics
इंस्टेंस बनाने के बाद, logEvent()
वाले तरीके की मदद से इवेंट लॉग करने के लिए इसका इस्तेमाल किया जा सकता है.
शुरू करने में आपकी मदद करने के लिए, Analytics SDK कई सुझाए गए इवेंट तय करता है. ये इवेंट अलग-अलग तरह के ऐप्लिकेशन में आम होते हैं. इनमें रीटेल और ई-कॉमर्स, यात्रा, और गेमिंग ऐप्लिकेशन शामिल हैं. इन इवेंट के बारे में और इनका इस्तेमाल कब करना चाहिए, इसके बारे में ज़्यादा जानने के लिए सुझाए गए इवेंट देखें.
सुझाए गए इवेंट टाइप को लागू करने की जानकारी को इन जगहों पर देखा जा सकता है:
- सुझाए गए इवेंट:
com.google.firebase.analytics.FirebaseAnalytics.Event
क्लास का रेफ़रंस देखें. - तय किए गए पैरामीटर:
com.google.firebase.analytics.FirebaseAnalytics.Param
रेफ़रंस देखें.
यहां दिए गए उदाहरण में, SELECT_CONTENT
इवेंट को लॉग करने का तरीका बताया गया है:
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") }
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);
तय किए गए पैरामीटर के अलावा, किसी भी इवेंट में ये पैरामीटर जोड़े जा सकते हैं:
कस्टम पैरामीटर: कस्टम पैरामीटर का इस्तेमाल Analytics रिपोर्ट में डाइमेंशन या मेट्रिक के तौर पर किया जा सकता है. बिना संख्या वाले इवेंट पैरामीटर डेटा के लिए कस्टम डाइमेंशन और संख्या के तौर पर बेहतर तरीके से दिखाए जाने वाले किसी भी पैरामीटर डेटा के लिए, कस्टम मेट्रिक का इस्तेमाल किया जा सकता है. SDK टूल का इस्तेमाल करके कस्टम पैरामीटर लॉग करने के बाद, डाइमेंशन या मेट्रिक को रजिस्टर करें. इससे यह पक्का किया जा सकेगा कि वे कस्टम पैरामीटर, Analytics रिपोर्ट में दिखें. Analytics > इवेंट > कस्टम डेफ़िनिशन मैनेज करें > कस्टम डाइमेंशन बनाएं का इस्तेमाल करके ऐसा करें
कस्टम पैरामीटर ऑडियंस परिभाषाओं में इस्तेमाल किए जा सकते हैं. इन्हें हर रिपोर्ट पर लागू किया जा सकता है. अगर आपका ऐप्लिकेशन किसी BigQuery प्रोजेक्ट से लिंक है, तो कस्टम पैरामीटर BigQuery में एक्सपोर्ट किए जाने वाले डेटा में भी शामिल होते हैं. Google Analytics 4 BigQuery Export पर सैंपल क्वेरी और बहुत कुछ देखें.
VALUE
पैरामीटर:VALUE
एक सामान्य मकसद वाला पैरामीटर है, जो किसी इवेंट से जुड़ी मुख्य मेट्रिक इकट्ठा करने में मदद करता है. उदाहरण के लिए, रेवेन्यू, दूरी, समय, और पॉइंट.
अगर आपके ऐप्लिकेशन में ऐसी खास ज़रूरतें हैं जो सुझाए गए इवेंट टाइप में शामिल नहीं हैं, तो इस उदाहरण में दिखाए गए तरीके से, अपने कस्टम इवेंट को लॉग किया जा सकता है:
Kotlin+KTX
firebaseAnalytics.logEvent("share_image") { param("image_name", name) param("full_text", text) }
Java
Bundle params = new Bundle(); params.putString("image_name", name); params.putString("full_text", text); mFirebaseAnalytics.logEvent("share_image", params);
डिफ़ॉल्ट इवेंट पैरामीटर सेट करना
setDefaultEventParameters
का इस्तेमाल करके, सभी इवेंट में पैरामीटर लॉग किए जा सकते हैं.
डिफ़ॉल्ट पैरामीटर, आने वाले समय में लॉग किए जाने वाले सभी इवेंट से जुड़े होते हैं.
कस्टम पैरामीटर की तरह ही, डिफ़ॉल्ट इवेंट पैरामीटर को रजिस्टर करें, ताकि यह पक्का किया जा सके कि वे Analytics रिपोर्ट में दिखें.
Kotlin+KTX
val parameters = Bundle().apply { this.putString("level_name", "Caverns01") this.putInt("level_difficulty", 4) } firebaseAnalytics.setDefaultEventParameters(parameters)
Java
Bundle parameters = new Bundle(); params.putString("level_name", "Caverns01"); params.putInt("level_difficulty", 4); mFirebaseAnalytics.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 कंसोल के डैशबोर्ड में, अपने इवेंट के इकट्ठा किए गए आंकड़े देखे जा सकते हैं. ये डैशबोर्ड दिन भर समय-समय पर अपडेट होते रहते हैं. तुरंत जांच करने के लिए, पिछले सेक्शन में बताए गए तरीके से, Logcat आउटपुट का इस्तेमाल करें.
Firebase कंसोल में, इवेंट डैशबोर्ड से यह डेटा ऐक्सेस किया जा सकता है. यह डैशबोर्ड ऐसी इवेंट रिपोर्ट दिखाता है जो आपके ऐप्लिकेशन से लॉग किए गए हर अलग तरह के इवेंट के लिए अपने-आप बनाई जाती हैं.