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

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

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

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

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

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

अगर आपने पहले से Firebase को नहीं जोड़ा है, तो अपने Android में 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 बीओएम लाइब्रेरी के वर्शन को कंट्रोल करने के लिए. 

    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
    MainActivity.kt

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

  3. इसे onCreate() तरीके में शुरू करें:

    Kotlin+KTX 

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

    Java 

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

इवेंट लॉग करना शुरू करें

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")
}
MainActivity.kt

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);
MainActivity.java

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

अगले चरण