Catch up on everything we announced at this year's Firebase Summit. Learn more

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

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

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

  • घटनाक्रम: क्या इस तरह के उपयोगकर्ता क्रियाओं, प्रणाली की घटनाओं, या त्रुटियों के रूप में अपने अनुप्रयोग में हो रहा है,।
  • उपभोक्ता के गुण: आप इस तरह के वरीयता या भाषा भौगोलिक स्थिति जैसा अपने उपयोगकर्ता आधार के क्षेत्रों, वर्णन करने के लिए परिभाषित जिम्मेदार बताते हैं।

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

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

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

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

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

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

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

  1. का उपयोग करते हुए Firebase एंड्रॉयड बीओएम , अपने मॉड्यूल (एप्लिकेशन-स्तरीय) Gradle फ़ाइल (आमतौर पर इन एनालिटिक्स एंड्रॉयड पुस्तकालय के लिए निर्भरता की घोषणा app/build.gradle )।

    जावा

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:29.0.1')
    
        // Declare 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 एंड्रॉयड बीओएम , अपने अनुप्रयोग हमेशा Firebase एंड्रॉयड पुस्तकालयों के संगत संस्करणों का प्रयोग करेंगे।

    (वैकल्पिक) बीओएम का उपयोग किए बिना Firebase पुस्तकालय निर्भरता घोषित

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

    ध्यान दें कि अगर आप अपने एप्लिकेशन में एकाधिक Firebase पुस्तकालयों का उपयोग, हम अत्यधिक पुस्तकालय संस्करणों, जो सुनिश्चित करता है कि सभी संस्करणों के संगत हैं का प्रबंधन करने के बीओएम का उपयोग करें।

    dependencies {
        // Declare 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:20.0.0'
    }
    

    कोटलिन + केटीएक्स

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

    का उपयोग करके Firebase एंड्रॉयड बीओएम , अपने अनुप्रयोग हमेशा Firebase एंड्रॉयड पुस्तकालयों के संगत संस्करणों का प्रयोग करेंगे।

    (वैकल्पिक) बीओएम का उपयोग किए बिना Firebase पुस्तकालय निर्भरता घोषित

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

    ध्यान दें कि अगर आप अपने एप्लिकेशन में एकाधिक Firebase पुस्तकालयों का उपयोग, हम अत्यधिक पुस्तकालय संस्करणों, जो सुनिश्चित करता है कि सभी संस्करणों के संगत हैं का प्रबंधन करने के बीओएम का उपयोग करें।

    dependencies {
        // Declare 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:20.0.0'
    }
    

  2. घोषित com.google.firebase.analytics.FirebaseAnalytics अपनी गतिविधि के शीर्ष पर वस्तु:

    जावा

    private FirebaseAnalytics mFirebaseAnalytics;

    कोटलिन + केटीएक्स

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

    जावा

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

    कोटलिन + केटीएक्स

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

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

के बाद आप एक बनाया है FirebaseAnalytics उदाहरण के लिए, आप के साथ घटनाओं लॉग इन करने के लिए शुरू कर सकते logEvent() विधि।

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

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

जावा

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

कोटलिन + केटीएक्स

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

यह आदेश एंड्रॉइड स्टूडियो लॉगकैट में आपके ईवेंट प्रदर्शित करता है, जिससे आपको तुरंत यह सत्यापित करने में मदद मिलती है कि ईवेंट भेजे जा रहे हैं।

अगला कदम