获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

Google विश्लेषिकी के साथ आरंभ करें

यह क्विकस्टार्ट आपको दिखाता है कि Google Analytics को अपने ऐप में कैसे जोड़ा जाए और ईवेंट लॉग करना शुरू करें।

Google Analytics आपके ऐप के लिए उपयोग और व्यवहार डेटा एकत्र करता है। SDK दो प्राथमिक प्रकार की जानकारी लॉग करता है:

  • इवेंट: आपके ऐप में क्या हो रहा है, जैसे उपयोगकर्ता की कार्रवाइयां, सिस्टम इवेंट या त्रुटियां।
  • उपयोगकर्ता गुण: वे विशेषताएँ जिन्हें आप अपने उपयोगकर्ता आधार के खंडों का वर्णन करने के लिए परिभाषित करते हैं, जैसे भाषा वरीयता या भौगोलिक स्थान।

Analytics कुछ ईवेंट और उपयोगकर्ता प्रॉपर्टी को स्वचालित रूप से लॉग करता है; आपको उन्हें सक्षम करने के लिए कोई कोड जोड़ने की आवश्यकता नहीं है।

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

यदि आपने पहले से ऐसा नहीं किया है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें और सुनिश्चित करें कि आपके Firebase प्रोजेक्ट में Google Analytics सक्षम है:

  • यदि आप एक नया Firebase प्रोजेक्ट बना रहे हैं, तो प्रोजेक्ट निर्माण कार्यप्रवाह के दौरान Google Analytics को सक्षम करें।

  • यदि आप किसी मौजूदा फायरबेस प्रोजेक्ट का उपयोग कर रहे हैं जिसमें Google Analytics सक्षम नहीं है, तो इसे सक्षम करने के लिए अपनी > प्रोजेक्ट सेटिंग के एकीकरण टैब पर जाएं।

जब आप अपने प्रोजेक्ट में Google Analytics को सक्षम करते हैं, तो आपके Firebase ऐप्स Google Analytics डेटा स्ट्रीम से लिंक हो जाते हैं।

अपने ऐप्लिकेशन में Analytics SDK जोड़ें

  1. अपने मॉड्यूल (ऐप्लिकेशन-स्तर) ग्रेड फ़ाइल (आमतौर पर <project>/<app-module>/build.gradle ) में, Analytics Android लाइब्रेरी के लिए निर्भरता जोड़ें। हम लाइब्रेरी वर्जनिंग को नियंत्रित करने के लिए फायरबेस एंड्रॉइड बीओएम का उपयोग करने की सलाह देते हैं।

    Java

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:31.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'
    }
    

    फायरबेस एंड्रॉइड बीओएम का उपयोग करके, आपका ऐप हमेशा फायरबेस एंड्रॉइड लाइब्रेरी के संगत संस्करणों का उपयोग करेगा।

    (वैकल्पिक) BoM . का उपयोग किए बिना Firebase लाइब्रेरी निर्भरताएं जोड़ें

    यदि आप फायरबेस बीओएम का उपयोग नहीं करना चुनते हैं, तो आपको प्रत्येक फायरबेस लाइब्रेरी संस्करण को उसकी निर्भरता रेखा में निर्दिष्ट करना होगा।

    ध्यान दें कि यदि आप अपने ऐप में कई फायरबेस लाइब्रेरी का उपयोग करते हैं, तो हम लाइब्रेरी संस्करणों को प्रबंधित करने के लिए 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.2.0'
    }
    

    Kotlin+KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:31.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'
    }
    

    फायरबेस एंड्रॉइड बीओएम का उपयोग करके, आपका ऐप हमेशा फायरबेस एंड्रॉइड लाइब्रेरी के संगत संस्करणों का उपयोग करेगा।

    (वैकल्पिक) BoM . का उपयोग किए बिना Firebase लाइब्रेरी निर्भरताएं जोड़ें

    यदि आप फायरबेस बीओएम का उपयोग नहीं करना चुनते हैं, तो आपको प्रत्येक फायरबेस लाइब्रेरी संस्करण को उसकी निर्भरता रेखा में निर्दिष्ट करना होगा।

    ध्यान दें कि यदि आप अपने ऐप में कई फायरबेस लाइब्रेरी का उपयोग करते हैं, तो हम लाइब्रेरी संस्करणों को प्रबंधित करने के लिए 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.2.0'
    }
    

  2. अपनी गतिविधि के शीर्ष पर com.google.firebase.analytics.FirebaseAnalytics ऑब्जेक्ट घोषित करें:

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. इसे onCreate() विधि में प्रारंभ करें:

    Java

    // Obtain the FirebaseAnalytics instance.
    mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);

    Kotlin+KTX

    // Obtain the FirebaseAnalytics instance.
    firebaseAnalytics = Firebase.analytics

ईवेंट लॉग करना प्रारंभ करें

FirebaseAnalytics इंस्टेंस बनाने के बाद, आप logEvent() विधि से ईवेंट लॉग करना शुरू कर सकते हैं।

सभी ऐप्स के लिए कुछ ईवेंट की अनुशंसा की जाती है ; अन्य विशिष्ट व्यावसायिक प्रकारों या कार्यक्षेत्रों के लिए अनुशंसित हैं। आपको अपनी रिपोर्ट में अधिकतम उपलब्ध विवरण सुनिश्चित करने और भविष्य की सुविधाओं और एकीकरण से लाभ उठाने के लिए उनके निर्धारित मापदंडों के साथ सुझाए गए कार्यक्रम भेजने चाहिए। यह खंड एक पूर्व-निर्धारित घटना लॉगिंग को प्रदर्शित करता है, लॉगिंग इवेंट के बारे में अधिक जानकारी के लिए, लॉग इवेंट देखें।

जब कोई उपयोगकर्ता आपके ऐप में किसी विशिष्ट तत्व पर क्लिक करता है तो निम्न कोड एक SELECT_CONTENT ईवेंट लॉग करता है।

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);

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")
}

आप यह सत्यापित करने में सहायता के लिए कि ईवेंट ठीक से लॉग किए जा रहे हैं, 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 लॉगकैट में प्रदर्शित करता है, जिससे आपको तुरंत यह सत्यापित करने में मदद मिलती है कि ईवेंट भेजे जा रहे हैं।

अगले कदम