इस गाइड में, अपने ऐप्लिकेशन में इवेंट लॉग करने का तरीका बताया गया है.
इवेंट से यह अहम जानकारी मिलती है कि आपके ऐप्लिकेशन में क्या हो रहा है, जैसे कि उपयोगकर्ता कार्रवाइयां, सिस्टम इवेंट या गड़बड़ियां.
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 कंसोल में डैशबोर्ड देखें. यह डैशबोर्ड, इवेंट की रिपोर्ट दिखाता है जो इसके ज़रिए लॉग किए गए हर अलग तरह के इवेंट के लिए अपने-आप बन जाते हैं आपका ऐप्लिकेशन.