अपने झटपट ऐप्लिकेशन में 'Firebase के लिए Google Analytics' जोड़ना

चेतावनी: Google Play Instant अब उपलब्ध नहीं होगा. दिसंबर 2025 से, इंस्टैंट ऐप्लिकेशन को Google Play से पब्लिश नहीं किया जा सकेगा. साथ ही, सभी Google Play services के इंस्टैंट एपीआई काम नहीं करेंगे. उपयोगकर्ताओं को अब Play के ज़रिए, किसी भी तरीके से इंस्टैंट ऐप्लिकेशन नहीं दिखाए जाएंगे.

हम यह बदलाव, डेवलपर के सुझावों के आधार पर कर रहे हैं. साथ ही, Google Play इंस्टैंट की सुविधा लॉन्च करने के बाद से, हम लगातार इस नेटवर्क को बेहतर बनाने के लिए काम कर रहे हैं.

उपयोगकर्ताओं की संख्या बढ़ाने के लिए, हम डेवलपर को अपने ऐप्लिकेशन या गेम पर उपयोगकर्ताओं को भेजने का सुझाव देते हैं. इसके लिए, डीपलिंक का इस्तेमाल करके, उपयोगकर्ताओं को ज़रूरत के हिसाब से किसी खास प्रोसेस या सुविधा पर रीडायरेक्ट करें.

हर डेवलपर के लिए, इंस्टॉल किए गए या इंस्टॉल किए बिना इस्तेमाल किए जा सकने वाले ऐप्लिकेशन की परफ़ॉर्मेंस को ट्रैक करना ज़रूरी है. कई आंकड़ों की लाइब्रेरी, Google Play Instant के साथ काम करती हैं. इनमें Fabric Answers, Localytics, और Mixpanel शामिल हैं.

अगर आपका मौजूदा आंकड़ों का समाधान सूची में शामिल नहीं है या आपको पता चलता है कि वह Google Play Instant के साथ काम नहीं करता, तो अपने टेलीमेट्री समाधान के तौर पर'Firebase के लिए Google Analytics' का इस्तेमाल करें. इस पेज पर, इंस्टैंट ऐप्लिकेशन प्रोजेक्ट में Firebase के लिए Google Analytics को सेट अप करने का तरीका बताया गया है.

इंस्टैंट ऐप्लिकेशन प्रोजेक्ट में 'Firebase के लिए Google Analytics' जोड़ना

  1. Firebase के लिए Google Analytics का इस्तेमाल शुरू करने के लिए गाइड में दिए गए निर्देशों का पालन करके, अपने ऐप्लिकेशन में Firebase SDK टूल जोड़ें.
  2. google-services प्लग इन का नया वर्शन इस्तेमाल करें.
  3. हर मॉड्यूल में google-services.json फ़ाइल डालें.

  4. हर मॉड्यूल की build.gradle फ़ाइल में यह लाइन जोड़ें:

    Groovy

    // android { ... }
// dependencies { ... }
plugins {
    id 'com.google.gms.google-services'
}

    Kotlin

    // android { ... }
// dependencies { ... }
plugins {
    id("com.google.gms.google-services")
}

इंस्टैंट ऐप्लिकेशन प्रोजेक्ट में 'Firebase के लिए Google Analytics' जोड़ने के बाद, 'Firebase के लिए Google Analytics' एपीआई का इस्तेमाल उसी तरह किया जा सकता है जिस तरह इंस्टॉल किए जा सकने वाले ऐप्लिकेशन प्रोजेक्ट में किया जाता है.

'Firebase के लिए Google Analytics' एपीआई का इस्तेमाल करने के तरीके के बारे में ज़्यादा जानने के लिए, 'Firebase के लिए Google Analytics' का इस्तेमाल शुरू करने से जुड़ा दस्तावेज़ देखें.

इंस्टॉल किए गए ऐप्लिकेशन और इंस्टैंट ऐप्लिकेशन के डेटा में अंतर करना

आपके इंस्टॉल किए गए ऐप्लिकेशन और इंस्टैंट ऐप्लिकेशन, दोनों का पैकेज नाम एक ही होता है. इसलिए, हो सकता है कि आप दोनों से इकट्ठा किए गए इवेंट और डेटा में अंतर करना चाहें. Analytics में, इंस्टैंट और इंस्टॉल किए गए ऐप्लिकेशन के बीच अंतर करने के लिए, app_type उपयोगकर्ता प्रॉपर्टी सेट करें. इसमें, इंस्टैंट ऐप्लिकेशन के लिए "इंस्टैंट" और इंस्टॉल किए गए ऐप्लिकेशन के लिए "इंस्टॉल किया गया" वैल्यू सेट करें.

नीचे दिया गया कोड स्निपेट, एक ऐसी गतिविधि दिखाता है जिसमें Analytics इंस्टेंस मिलता है और फिर उपयोगकर्ता प्रॉपर्टी सेट की जाती है. ध्यान दें कि ऐप्लिकेशन के कॉन्टेक्स्ट का पता लगाने के लिए, कोड में onCreate(android.os.Bundle) के तरीके में PackageManagerCompat.isInstantApp() का इस्तेमाल किया गया है.

Kotlin

val STATUS_INSTALLED = "installed"
val STATUS_INSTANT = "instant"
val ANALYTICS_USER_PROP = "app_type"

private lateinit var firebaseAnalytics: FirebaseAnalytics

protected fun onCreate(savedInstanceState: Bundle?) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this)

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT)
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED)
    }
}

Java

final String STATUS_INSTALLED = "installed";
final String STATUS_INSTANT = "instant";
final String ANALYTICS_USER_PROP = "app_type";

private FirebaseAnalytics firebaseAnalytics;

@Override
protected void onCreate(Bundle savedInstanceState) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this);

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT);
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED);
    }

}

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

'Firebase के लिए Google Analytics' में इवेंट को लॉग करने और देखने के तरीके के बारे में ज़्यादा जानने के लिए, इवेंट लॉग करें लेख पढ़ें.

Analytics इवेंट को समझना

Analytics की मदद से, इंस्टैंट ऐप्लिकेशन के लिए कई तरह की अहम मेट्रिक ट्रैक की जा सकती हैं. यहां दी गई टेबल में, आपके इंस्टैंट ऐप्लिकेशन के लिए काम की मेट्रिक के बारे में बताया गया है. इनमें, Analytics में उससे जुड़े इवेंट का नाम या प्रॉपर्टी भी शामिल है.

नाम Analytics वैल्यू परिभाषा
मेडिकल प्रोफ़ेशनल के पास जाने से जुड़ा डेटा session_start सेशन शुरू हो गया. इस इवेंट को अपने-आप ट्रैक किया जाता है.
फ़िज़िकल प्रॉडक्ट की खरीदारी Firebase.Event.ECOMMERCE_PURCHASE फ़िज़िकल तौर पर खरीदारी करना. आपको अपने कोड में इस इवेंट को साफ़ तौर पर ट्रैक करना होगा.
डिजीटल खरीदारियां in_app_purchase डिजिटल इन-ऐप्लिकेशन खरीदारी. इस इवेंट को अपने-आप ट्रैक किया जाता है.
ऐप्लिकेशन इस्तेमाल करने में लगा समय user_engagement ऐप्लिकेशन के फ़ोरग्राउंड में रहने का कुल समय. इस इवेंट को अपने-आप ट्रैक किया जाता है.
इंस्टैंट ऐप्लिकेशन का कॉन्टेक्स्ट app_type इंस्टैंट या इंस्टॉल किए गए कॉन्टेक्स्ट में चल रहे ऐप्लिकेशन से जनरेट होने वाले इवेंट. आपको अपने कोड में इस इवेंट को साफ़ तौर पर ट्रैक करना होगा. ऊपर इंस्टॉल किए गए ऐप्लिकेशन और इंस्टैंट ऐप्लिकेशन के डेटा के बीच अंतर देखें.
वापस आने वाले विज़िटर session_start.count और app_type दो या उससे ज़्यादा बार आने वाले उपयोगकर्ताओं की ऑडियंस. आपको app_type इवेंट को साफ़ तौर पर ट्रैक करना होगा; session_start को आपके लिए ट्रैक किया जाता है. ऊपर इंस्टॉल किए गए ऐप्लिकेशन और इंस्टैंट ऐप्लिकेशन के डेटा के बीच का अंतर देखें.

Analytics में इकट्ठा किए जा सकने वाले इवेंट के लिए कॉन्स्टेंट के बारे में ज़्यादा जानने के लिए, FirebaseAnalytics.Event देखें.