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

इवेंट से आपको यह अहम जानकारी मिलती है कि आपके ऐप्लिकेशन में क्या हो रहा है. जैसे, उपयोगकर्ता की कार्रवाइयां, सिस्टम में होने वाले इवेंट या गड़बड़ियां.

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

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

पक्का करें कि आपने अपना प्रोजेक्ट सेट अप कर लिया हो और आपके पास 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 रिपोर्ट में डाइमेंशन या मेट्रिक के तौर पर किया जा सकता है. बिना संख्या वाले इवेंट पैरामीटर डेटा के लिए, कस्टम डाइमेंशन का इस्तेमाल किया जा सकता है. साथ ही, किसी भी ऐसे पैरामीटर डेटा के लिए कस्टम मेट्रिक का इस्तेमाल किया जा सकता है जिसे संख्याओं में बेहतर तरीके से दिखाया जा सकता है. एसडीके टूल का इस्तेमाल करके कस्टम पैरामीटर लॉग करने के बाद, डाइमेंशन या मेट्रिक को रजिस्टर करें. इससे यह पक्का किया जा सकेगा कि वे कस्टम पैरामीटर, Analytics रिपोर्ट में दिखें. इसके लिए, Firebase कंसोल में, 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();
parameters.putString("level_name", "Caverns01");
parameters.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

अगर logEvent() तरीके में कोई पैरामीटर तय किया गया है, तो डिफ़ॉल्ट वैल्यू के बजाय उस वैल्यू का इस्तेमाल किया जाता है.

किसी डिफ़ॉल्ट पैरामीटर को हटाने के लिए, पैरामीटर को null पर सेट करके, setDefaultEventParameters तरीके को कॉल करें.

Android Studio के डीबग लॉग में इवेंट देखना

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

वर्बोस लॉगिंग को 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 के Logcat में आपके इवेंट दिखते हैं. इससे आपको तुरंत यह पुष्टि करने में मदद मिलती है कि इवेंट भेजे जा रहे हैं.

डैशबोर्ड में इवेंट देखना

Firebase कंसोल में, Analytics > इवेंट डैशबोर्ड में जाकर, अपने इवेंट के बारे में एग्रीगेट किए गए आंकड़े देखे जा सकते हैं.

इस डैशबोर्ड के बारे में इन बातों का ध्यान रखें:

• डैशबोर्ड में, इवेंट की वे रिपोर्ट दिखती हैं जो आपके ऐप्लिकेशन से लॉग किए गए हर तरह के इवेंट के लिए अपने-आप बनती हैं.

• डैशबोर्ड, दिन भर समय-समय पर अपडेट होता रहता है. तुरंत जांच करने के लिए, logcat आउटपुट का इस्तेमाल करें. इसके बारे में इस गाइड के पिछले सेक्शन में बताया गया है.