यह क्विकस्टार्ट आपको दिखाता है कि Google Analytics को अपने ऐप में कैसे जोड़ें और इवेंट लॉग करना कैसे शुरू करें।
Google Analytics आपके ऐप के लिए उपयोग और व्यवहार डेटा एकत्र करता है। SDK दो प्राथमिक प्रकार की जानकारी लॉग करता है:
- इवेंट: आपके ऐप में क्या हो रहा है, जैसे उपयोगकर्ता की गतिविधियां, सिस्टम इवेंट या त्रुटियां।
- उपयोगकर्ता गुण: वे विशेषताएँ जिन्हें आप अपने उपयोगकर्ता आधार के खंडों का वर्णन करने के लिए परिभाषित करते हैं, जैसे भाषा प्राथमिकता या भौगोलिक स्थान।
एनालिटिक्स स्वचालित रूप से कुछ घटनाओं और उपयोगकर्ता गुणों को लॉग करता है; उन्हें सक्षम करने के लिए आपको कोई कोड जोड़ने की आवश्यकता नहीं है।
शुरू करने से पहले
यदि आपने पहले से नहीं किया है, तो अपने एंड्रॉइड प्रोजेक्ट में फायरबेस जोड़ें और सुनिश्चित करें कि आपके फायरबेस प्रोजेक्ट में Google Analytics सक्षम है:
यदि आप एक नया फायरबेस प्रोजेक्ट बना रहे हैं, तो प्रोजेक्ट निर्माण वर्कफ़्लो के दौरान Google Analytics सक्षम करें।
यदि आप किसी मौजूदा फायरबेस प्रोजेक्ट का उपयोग कर रहे हैं जिसमें Google Analytics सक्षम नहीं है, तो अपने एकीकरण टैब पर जाएं
इसे सक्षम करने के लिए > प्रोजेक्ट सेटिंग्स ।
जब आप अपने प्रोजेक्ट में Google Analytics सक्षम करते हैं, तो आपके Firebase ऐप्स Google Analytics डेटा स्ट्रीम से लिंक हो जाते हैं।
अपने ऐप में एनालिटिक्स एसडीके जोड़ें
अपने मॉड्यूल (ऐप-स्तर) ग्रैडल फ़ाइल में (आमतौर पर
<project>/<app-module>/build.gradle.kts
या<project>/<app-module>/build.gradle
), Analytics Android के लिए निर्भरता जोड़ें पुस्तकालय। हम लाइब्रेरी वर्जनिंग को नियंत्रित करने के लिए फायरबेस एंड्रॉइड BoM का उपयोग करने की सलाह देते हैं।Kotlin+KTX
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:32.3.1")) // 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") }
फायरबेस एंड्रॉइड बीओएम का उपयोग करके, आपका ऐप हमेशा फायरबेस एंड्रॉइड लाइब्रेरी के संगत संस्करणों का उपयोग करेगा।
(वैकल्पिक) BoM का उपयोग किए बिना फायरबेस लाइब्रेरी निर्भरताएँ जोड़ें
यदि आप फायरबेस बीओएम का उपयोग नहीं करना चुनते हैं, तो आपको प्रत्येक फायरबेस लाइब्रेरी संस्करण को उसकी निर्भरता पंक्ति में निर्दिष्ट करना होगा।
ध्यान दें कि यदि आप अपने ऐप में एकाधिक फायरबेस लाइब्रेरी का उपयोग करते हैं, तो हम लाइब्रेरी संस्करणों को प्रबंधित करने के लिए BoM का उपयोग करने की दृढ़ता से अनुशंसा करते हैं, जो सुनिश्चित करता है कि सभी संस्करण संगत हैं।
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.3.1")) // 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") }
फायरबेस एंड्रॉइड बीओएम का उपयोग करके, आपका ऐप हमेशा फायरबेस एंड्रॉइड लाइब्रेरी के संगत संस्करणों का उपयोग करेगा।
(वैकल्पिक) BoM का उपयोग किए बिना फायरबेस लाइब्रेरी निर्भरताएँ जोड़ें
यदि आप फायरबेस बीओएम का उपयोग नहीं करना चुनते हैं, तो आपको प्रत्येक फायरबेस लाइब्रेरी संस्करण को उसकी निर्भरता पंक्ति में निर्दिष्ट करना होगा।
ध्यान दें कि यदि आप अपने ऐप में एकाधिक फायरबेस लाइब्रेरी का उपयोग करते हैं, तो हम लाइब्रेरी संस्करणों को प्रबंधित करने के लिए BoM का उपयोग करने की दृढ़ता से अनुशंसा करते हैं, जो सुनिश्चित करता है कि सभी संस्करण संगत हैं।
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);
आप एसडीके द्वारा ईवेंट की लॉगिंग की निगरानी करने के लिए वर्बोज़ लॉगिंग सक्षम कर सकते हैं ताकि यह सत्यापित करने में सहायता मिल सके कि ईवेंट ठीक से लॉग किए जा रहे हैं। इसमें स्वचालित और मैन्युअल रूप से लॉग किए गए इवेंट दोनों शामिल हैं।
आप 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 का उपयोग करें।
- फायरबेस कंसोल में अपना डेटा एक्सप्लोर करें।
- घटनाओं और उपयोगकर्ता संपत्तियों पर गाइड का अन्वेषण करें।
- जानें कि अपना डेटा BigQuery पर कैसे निर्यात करें।