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

प्लैटफ़ॉर्म चुनें: iOS+ Android Web Flutter Unity C++


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

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

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

पक्का करें कि आपने अपना प्रोजेक्ट सेट अप कर लिया हो और Analytics ऐक्सेस किया जा सकता हो. इसके लिए, Get Started with Analytics लेख पढ़ें.

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

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

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

Google Analytics

सुझाए गए इवेंट टाइप के लिए, लागू करने से जुड़ी जानकारी यहां देखी जा सकती है:

यहां दिए गए उदाहरण में, SELECT_CONTENT इवेंट लॉग करने का तरीका बताया गया है:

Kotlin 

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 रिपोर्ट में दिख रहे हैं. ऐसा करने के लिए, Firebase कंसोल में Analytics > कस्टम डेफ़िनिशन पर जाएं.

    कस्टम पैरामीटर का इस्तेमाल, ऑडियंस की डेफ़िनिशन में किया जा सकता है. इन्हें हर रिपोर्ट पर लागू किया जा सकता है. अगर आपका ऐप्लिकेशन, BigQuery प्रोजेक्ट से लिंक है, तो कस्टम पैरामीटर, BigQuery में एक्सपोर्ट किए गए डेटा में भी शामिल होते हैं. Google Analytics 4 BigQuery Export में, सैंपल क्वेरी और अन्य जानकारी देखें .

  • VALUE पैरामीटर: VALUE एक सामान्य पैरामीटर है. यह किसी इवेंट से जुड़ी मुख्य मेट्रिक को इकट्ठा करने के लिए काम आता है. उदाहरण के लिए, रेवेन्यू, दूरी, समय, और पॉइंट.

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

Kotlin 

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 

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

firebaseAnalytics.setDefaultEventParameters(parameters)

Java 

Bundle parameters = new Bundle();
parameters.putString("level_name", "Caverns01");
parameters.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 कंसोल में, अपने इवेंट के बारे में एग्रीगेट किए गए आंकड़े देखे जा सकते हैं Analytics > इवेंट डैशबोर्ड में.

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

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

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