लॉग इवेंट

आईओएस + एंड्रॉयड वेब स्पंदन

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

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

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

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

सुनिश्चित करें कि आपने अपना प्रोजेक्ट सेट अप कर लिया है और आप Analytics तक पहुंच सकते हैं, जैसा कि Analytics के साथ प्रारंभ करें में बताया गया है.

घटनाओं को लॉग करें

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

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

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

• अनुशंसित घटनाएँ: com.google.firebase.analytics.FirebaseAnalytics.Event वर्ग संदर्भ देखें।
• निर्धारित पैरामीटर: com.google.firebase.analytics.FirebaseAnalytics.Param संदर्भ देखें।

निम्न उदाहरण दर्शाता है कि SELECT_CONTENT ईवेंट कैसे लॉग करें:

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

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 रिपोर्ट में आयाम या मीट्रिक के रूप में किया जा सकता है। आप गैर-संख्यात्मक ईवेंट पैरामीटर डेटा के लिए कस्टम आयामों का उपयोग कर सकते हैं और किसी भी पैरामीटर डेटा के लिए कस्टम मीट्रिक को संख्यात्मक रूप से बेहतर तरीके से प्रदर्शित कर सकते हैं। SDK का उपयोग करके कस्टम पैरामीटर लॉग करने के बाद, यह सुनिश्चित करने के लिए आयाम या मीट्रिक पंजीकृत करें कि वे कस्टम पैरामीटर Analytics रिपोर्ट में दिखाई दें. इसे इसके माध्यम से करें: Analytics > ईवेंट > कस्टम परिभाषाएं प्रबंधित करें > कस्टम आयाम बनाएं

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

• VALUE पैरामीटर: VALUE एक सामान्य उद्देश्य वाला पैरामीटर है, जो किसी ईवेंट से संबंधित प्रमुख मीट्रिक को संचित करने के लिए उपयोगी होता है. उदाहरणों में राजस्व, दूरी, समय और अंक शामिल हैं।

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

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

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

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

आप setDefaultEventParameters का उपयोग करके सभी ईवेंट में पैरामीटर लॉग कर सकते हैं। डिफ़ॉल्ट पैरामीटर लॉग किए गए सभी भावी ईवेंट से संबद्ध होते हैं.

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

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

यदि logEvent() विधि में पैरामीटर निर्दिष्ट किया गया है, तो वह मान डिफ़ॉल्ट के बजाय उपयोग किया जाता है।

डिफ़ॉल्ट पैरामीटर को साफ़ करने के लिए, setDefaultEventParameters विधि को पैरामीटर सेट के साथ null पर कॉल करें।

Android स्टूडियो डीबग लॉग में ईवेंट देखें

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

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

adb shell setprop log.tag.FA VERBOSE

adb shell setprop log.tag.FA-SVC VERBOSE

adb logcat -v time -s FA FA-SVC

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

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

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

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