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

प्लैटफ़ॉर्म चुनें: iOS+ Android Web Flutter Unity C++


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

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

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

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

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

अगर आपने पहले से ही A/B टेस्टिंग नहीं बनाई है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें. साथ ही, पक्का करें कि आपके Firebase प्रोजेक्ट में Google Analytics चालू हो: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:34.12.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 लाइब्रेरी की डिपेंडेंसी जोड़नाBoM

    अगर 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:23.2.0")
}

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

    Kotlin 

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;

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

    Kotlin 

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

    Java 

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

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

FirebaseAnalytics का इंस्टेंस बनाने के बाद, इवेंट लॉग करने के लिए logEvent() तरीके का इस्तेमाल किया जा सकता है.

कुछ इवेंट सभी ऐप्लिकेशन के लिए सुझाए जाते हैं . वहीं, कुछ इवेंट खास तरह के कारोबार या वर्टिकल के लिए सुझाए जाते हैं. सुझाए गए इवेंट को उनके तय पैरामीटर के साथ कॉन्फ़िगर करना चाहिए. ऐसा करने से, रिपोर्ट में ज़्यादा जानकारी मिलती है. साथ ही, आने वाले समय में उपलब्ध होने वाली सुविधाओं और इंटिग्रेशन का फ़ायदा भी मिलता है. इस सेक्शन में, पहले से तय इवेंट को लॉग करने का तरीका बताया गया है. इवेंट लॉग करने के बारे में ज़्यादा जानने के लिए, इवेंट लॉग करना लेख पढ़ें.

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

Kotlin 

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

अगले चरण