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

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


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

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

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

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

लॉग इवेंट

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

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

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

adb कमांड की मदद से, Verbose logging को चालू किया जा सकता है:

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 आउटपुट का इस्तेमाल करें.