लॉग इवेंट

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

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

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

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

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

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

आपके द्वारा FirebaseAnalytics इंस्टेंस बनाने के बाद, आप इसका उपयोग logEvent() विधि से ईवेंट लॉग करने के लिए कर सकते हैं।

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

आप निम्नलिखित स्थानों पर अनुशंसित ईवेंट प्रकारों के कार्यान्वयन विवरण पा सकते हैं:

अनुशंसित ईवेंट: 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")
}MainActivity.kt

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);MainActivity.java

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

कस्टम पैरामीटर: कस्टम पैरामीटर का उपयोग एनालिटिक्स रिपोर्ट में आयाम या मीट्रिक के रूप में किया जा सकता है। आप गैर-संख्यात्मक ईवेंट पैरामीटर डेटा के लिए कस्टम आयाम और संख्यात्मक रूप से बेहतर प्रतिनिधित्व वाले किसी भी पैरामीटर डेटा के लिए कस्टम मेट्रिक्स का उपयोग कर सकते हैं। एसडीके का उपयोग करके एक कस्टम पैरामीटर लॉग करने के बाद, यह सुनिश्चित करने के लिए आयाम या मीट्रिक पंजीकृत करें कि वे कस्टम पैरामीटर एनालिटिक्स रिपोर्ट में दिखाई दें। Analytics > इवेंट > कस्टम परिभाषाएँ प्रबंधित करें > कस्टम आयाम बनाएँ का उपयोग करके ऐसा करें
कस्टम पैरामीटर का उपयोग ऑडियंस परिभाषाओं में किया जा सकता है जिन्हें हर रिपोर्ट पर लागू किया जा सकता है। यदि आपका ऐप किसी BigQuery प्रोजेक्ट से जुड़ा हुआ है तो BigQuery पर निर्यात किए गए डेटा में कस्टम पैरामीटर भी शामिल किए जाते हैं। Google Analytics 4 BigQuery निर्यात पर नमूना क्वेरीज़ और बहुत कुछ ढूंढें।
VALUE पैरामीटर: VALUE एक सामान्य प्रयोजन पैरामीटर है जो किसी घटना से संबंधित प्रमुख मीट्रिक जमा करने के लिए उपयोगी है। उदाहरणों में राजस्व, दूरी, समय और अंक शामिल हैं।

यदि आपके एप्लिकेशन की विशिष्ट आवश्यकताएं अनुशंसित ईवेंट प्रकार में शामिल नहीं हैं, तो आप अपने स्वयं के कस्टम ईवेंट लॉग कर सकते हैं जैसा कि इस उदाहरण में दिखाया गया है:

Kotlin+KTX

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}MainActivity.kt

Java

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);MainActivity.java

डिफ़ॉल्ट ईवेंट पैरामीटर सेट करें

आप setDefaultEventParameters उपयोग करके ईवेंट में पैरामीटर लॉग कर सकते हैं। डिफ़ॉल्ट पैरामीटर लॉग किए गए सभी भविष्य की घटनाओं से जुड़े होते हैं।

कस्टम पैरामीटर की तरह, डिफ़ॉल्ट ईवेंट पैरामीटर पंजीकृत करें ताकि यह सुनिश्चित हो सके कि वे एनालिटिक्स रिपोर्ट में दिखाई दें।

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 पर सेट पैरामीटर के साथ कॉल करें।

एंड्रॉइड स्टूडियो डिबग लॉग में इवेंट देखें

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

आप एडीबी कमांड की एक श्रृंखला के साथ वर्बोज़ लॉगिंग सक्षम कर सकते हैं:

adb shell setprop log.tag.FA VERBOSE

adb shell setprop log.tag.FA-SVC VERBOSE

adb logcat -v time -s FA FA-SVC

यह कमांड आपके ईवेंट को एंड्रॉइड स्टूडियो लॉगकैट में प्रदर्शित करता है, जिससे आपको तुरंत यह सत्यापित करने में मदद मिलती है कि ईवेंट भेजे जा रहे हैं।

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

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

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