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


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

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

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

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

पक्का करें कि आपने अपना प्रोजेक्ट सेट अप कर लिया हो और आपके पास Analytics को ऐक्सेस करने का ऐक्सेस हो. इस बारे में ज़्यादा जानने के लिए, Analytics का इस्तेमाल शुरू करना लेख पढ़ें.

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

FirebaseAnalytics इंस्टेंस बनाने के बाद, इसका इस्तेमाल logEvent() तरीके से इवेंट को लॉग करने के लिए किया जा सकता है.

शुरू करने में आपकी मदद करने के लिए, Analytics SDK टूल कई सुझाए गए इवेंट तय करता है. ये इवेंट, अलग-अलग तरह के ऐप्लिकेशन में आम तौर पर इस्तेमाल किए जाते हैं. इनमें खुदरा और ई-कॉमर्स, यात्रा, और गेमिंग ऐप्लिकेशन शामिल हैं. इन इवेंट के बारे में और इनका इस्तेमाल कब करना है, इस बारे में ज़्यादा जानने के लिए सुझाए गए इवेंट देखें.

सुझाए गए इवेंट टाइप को लागू करने के बारे में जानकारी यहां देखी जा सकती है:

यहां दिए गए उदाहरण में, किसी 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 रिपोर्ट में, कस्टम पैरामीटर का इस्तेमाल डाइमेंशन या मेट्रिक के तौर पर किया जा सकता है. संख्याओं के बजाय किसी दूसरे फ़ॉर्मैट में मौजूद इवेंट पैरामीटर के डेटा के लिए, कस्टम डाइमेंशन का इस्तेमाल किया जा सकता है. साथ ही, संख्याओं के ज़रिए बेहतर तरीके से दिखाए गए किसी भी पैरामीटर के डेटा के लिए, कस्टम मेट्रिक का इस्तेमाल किया जा सकता है. 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)
}
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 का इस्तेमाल करके, सभी इवेंट में पैरामीटर लॉग किए जा सकते हैं. डिफ़ॉल्ट पैरामीटर, आने वाले समय में होने वाले उन सभी इवेंट से जुड़े होते हैं जिन्हें लॉग किया जाता है.

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