Google Analytics का इस्तेमाल शुरू करना

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

Google Analytics, आपके ऐप्लिकेशन के इस्तेमाल और व्यवहार से जुड़ा डेटा इकट्ठा करता है. SDK टूल, मुख्य तौर पर दो तरह की जानकारी लॉग करता है:

  • इवेंट: आपके ऐप्लिकेशन में क्या हो रहा है, जैसे कि उपयोगकर्ता की कार्रवाइयां, सिस्टम इवेंट या गड़बड़ियां.
  • उपयोगकर्ता प्रॉपर्टी: ऐसे एट्रिब्यूट जिन्हें आपके उपयोगकर्ता आधार के सेगमेंट के बारे में बताने के लिए तय किया जाता है. जैसे, भाषा की प्राथमिकता या भौगोलिक जगह.

Analytics कुछ इवेंट और उपयोगकर्ता प्रॉपर्टी को अपने-आप लॉग करता है. आपको इन्हें चालू करने के लिए कोई कोड जोड़ने की ज़रूरत नहीं है.

वेब कंटेनर इंस्टॉल करने से पहले

अगर आपने पहले से Firebase नहीं जोड़ा है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें और पक्का करें कि आपके Firebase प्रोजेक्ट में Google Analytics चालू है:

  • अगर कोई नया Firebase प्रोजेक्ट बनाया जा रहा है, तो प्रोजेक्ट बनाने के वर्कफ़्लो के दौरान Google Analytics चालू करें.

  • अगर किसी ऐसे मौजूदा Firebase प्रोजेक्ट का इस्तेमाल किया जा रहा है जिसमें Google Analytics चालू नहीं है, तो इसे चालू करने के लिए > प्रोजेक्ट सेटिंग के इंटिग्रेशन टैब पर जाएं.

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

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

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

    dependencies {
        // Import the BoM for the Firebase platform
        implementation(platform("com.google.firebase:firebase-bom:33.1.2"))
    
        // 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 लाइब्रेरी के हर वर्शन की जानकारी देनी होगी.

    ध्यान दें कि अगर आप अपने ऐप्लिकेशन में कई 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:22.0.2")
    }
    
    क्या आपको Kotlin से जुड़े लाइब्रेरी मॉड्यूल की तलाश है? अक्टूबर 2023 (Firebase BoM 32.5.0) से, Kotlin और Java डेवलपर, दोनों मुख्य लाइब्रेरी मॉड्यूल पर निर्भर कर सकते हैं. ज़्यादा जानकारी के लिए, इस इनिशिएटिव के बारे में अक्सर पूछे जाने वाले सवाल देखें.

  2. अपनी गतिविधि में सबसे ऊपर, com.google.firebase.analytics.FirebaseAnalytics ऑब्जेक्ट के बारे में बताएं:

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
  3. इसे 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

यह निर्देश आपके इवेंट को Android Studio के लॉगकैट में दिखाता है, जिससे आपको तुरंत यह पुष्टि करने में मदद मिलती है कि इवेंट भेजे जा रहे हैं.

अगले चरण