यह क्विकस्टार्ट आपको दिखाता है कि Google Analytics को अपने ऐप में कैसे जोड़ा जाए और ईवेंट लॉगिंग कैसे शुरू करें।
Google Analytics आपके ऐप के लिए उपयोग और व्यवहार डेटा एकत्र करता है। SDK दो प्राथमिक प्रकार की जानकारी लॉग करता है:
- घटनाएँ: आपके ऐप में क्या हो रहा है, जैसे कि उपयोगकर्ता क्रियाएँ, सिस्टम घटनाएँ या त्रुटियाँ।
- उपयोगकर्ता गुण: वे विशेषताएँ जिन्हें आप अपने उपयोगकर्ता आधार के खंडों का वर्णन करने के लिए परिभाषित करते हैं, जैसे कि भाषा वरीयता या भौगोलिक स्थान।
Analytics स्वचालित रूप से कुछ ईवेंट और उपयोगकर्ता प्रॉपर्टी लॉग करता है; उन्हें सक्षम करने के लिए आपको कोई कोड जोड़ने की आवश्यकता नहीं है।
शुरू करने से पहले
यदि आपने पहले से नहीं किया है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें और सुनिश्चित करें कि आपके Firebase प्रोजेक्ट में Google Analytics सक्षम है:
यदि आप एक नया फायरबेस प्रोजेक्ट बना रहे हैं, तो प्रोजेक्ट निर्माण कार्यप्रवाह के दौरान Google Analytics को सक्षम करें।
यदि आप किसी ऐसे मौजूदा Firebase प्रोजेक्ट का उपयोग कर रहे हैं जिसमें Google Analytics सक्षम नहीं है, तो उसे सक्षम करने के लिए अपनी एकीकरण टैब पर जाएं.
> प्रोजेक्ट सेटिंग के
जब आप अपने प्रोजेक्ट में Google Analytics को सक्षम करते हैं, तो आपके Firebase ऐप्स Google Analytics डेटा स्ट्रीम से लिंक हो जाते हैं।
अपने ऐप में एनालिटिक्स एसडीके जोड़ें
अपने मॉड्यूल (ऐप-लेवल) ग्रैडल फ़ाइल (आमतौर पर
<project>/<app-module>/build.gradle
) में, एनालिटिक्स एंड्रॉइड लाइब्रेरी के लिए निर्भरता जोड़ें। हम लाइब्रेरी वर्ज़निंग को नियंत्रित करने के लिए Firebase Android BoM का उपयोग करने की सलाह देते हैं।Kotlin+KTX
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:32.1.0') // Add the dependency for the Analytics library // When using the BoM, you don't specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-analytics-ktx' }
Firebase Android BoM का उपयोग करके, आपका ऐप हमेशा Firebase Android पुस्तकालयों के संगत संस्करणों का उपयोग करेगा।
(वैकल्पिक) BoM का उपयोग किए बिना Firebase लाइब्रेरी निर्भरताएँ जोड़ें
यदि आप Firebase BoM का उपयोग नहीं करना चुनते हैं, तो आपको प्रत्येक Firebase लाइब्रेरी संस्करण को उसकी निर्भरता रेखा में निर्दिष्ट करना होगा।
ध्यान दें कि यदि आप अपने ऐप में एकाधिक फायरबेस लाइब्रेरी का उपयोग करते हैं, तो हम लाइब्रेरी संस्करणों को प्रबंधित करने के लिए बीओएम का उपयोग करने की दृढ़ता से अनुशंसा करते हैं, जो सुनिश्चित करता है कि सभी संस्करण संगत हैं।
dependencies { // Add the dependency for the Analytics library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-analytics-ktx:21.3.0' }
Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:32.1.0') // Add the dependency for the Analytics library // When using the BoM, you don't specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-analytics' }
Firebase Android BoM का उपयोग करके, आपका ऐप हमेशा Firebase Android पुस्तकालयों के संगत संस्करणों का उपयोग करेगा।
(वैकल्पिक) BoM का उपयोग किए बिना Firebase लाइब्रेरी निर्भरताएँ जोड़ें
यदि आप Firebase BoM का उपयोग नहीं करना चुनते हैं, तो आपको प्रत्येक Firebase लाइब्रेरी संस्करण को उसकी निर्भरता रेखा में निर्दिष्ट करना होगा।
ध्यान दें कि यदि आप अपने ऐप में एकाधिक फायरबेस लाइब्रेरी का उपयोग करते हैं, तो हम लाइब्रेरी संस्करणों को प्रबंधित करने के लिए बीओएम का उपयोग करने की दृढ़ता से अनुशंसा करते हैं, जो सुनिश्चित करता है कि सभी संस्करण संगत हैं।
dependencies { // Add the dependency for the Analytics library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-analytics:21.3.0' }
अपनी गतिविधि के शीर्ष पर
com.google.firebase.analytics.FirebaseAnalytics
ऑब्जेक्ट की घोषणा करें:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
इसे
onCreate()
मेथड में इनिशियलाइज़ करें:Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
ईवेंट लॉगिंग प्रारंभ करें
आपके द्वारा FirebaseAnalytics
उदाहरण बनाने के बाद, आप logEvent()
विधि से ईवेंट लॉग करना शुरू कर सकते हैं।
सभी ऐप्स के लिए कुछ खास इवेंट की सिफारिश की जाती है; दूसरों को विशिष्ट व्यवसाय प्रकारों या कार्यक्षेत्रों के लिए अनुशंसित किया जाता है। आपको अपनी रिपोर्ट में अधिकतम उपलब्ध विवरण सुनिश्चित करने और भविष्य की सुविधाओं और एकीकरणों के उपलब्ध होने पर लाभ उठाने के लिए, उनके निर्धारित मापदंडों के साथ सुझाए गए ईवेंट भेजने चाहिए। यह अनुभाग एक पूर्व-निर्धारित ईवेंट लॉगिंग प्रदर्शित करता है, लॉगिंग इवेंट्स के बारे में अधिक जानकारी के लिए, लॉग इवेंट्स देखें।
जब कोई उपयोगकर्ता आपके ऐप में किसी विशिष्ट तत्व पर क्लिक करता है तो निम्न कोड एक 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") }
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);
आप यह सत्यापित करने में सहायता के लिए कि ईवेंट ठीक से लॉग हो रहे हैं, 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
यह आदेश एंड्रॉइड स्टूडियो लॉगकैट में आपकी घटनाओं को प्रदर्शित करता है, आपको तुरंत यह सत्यापित करने में सहायता करता है कि ईवेंट भेजे जा रहे हैं।
अगले कदम
- अपने ईवेंट सत्यापित करने के लिए DebugView का उपयोग करें।
- Firebase कंसोल में अपना डेटा एक्सप्लोर करें।
- इवेंट और उपयोगकर्ता प्रॉपर्टी पर गाइड एक्सप्लोर करें.
- अपना डेटा BigQuery में निर्यात करने का तरीका जानें.