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

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

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

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

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

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

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

  1. Google Analytics for Firebase का इस्तेमाल शुरू करने के लिए गाइड में दिए गए निर्देशों का पालन करके, अपने ऐप्लिकेशन में 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")
}

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

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

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

आपके इंस्टॉल किए गए ऐप्लिकेशन और इंस्टैंट ऐप्लिकेशन, दोनों का पैकेज नाम एक ही होता है. इसलिए, हो सकता है कि आप दोनों से इकट्ठा किए गए इवेंट और डेटा में अंतर करना चाहें. 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 वैल्यू के हिसाब से फ़िल्टर किया जा सकता है. डेटा प्रोजेक्शन से, आपको अपने इंस्टैंट या इंस्टॉल किए गए ऐप्लिकेशन में, किसी खास इवेंट की संख्या का पता चलता है.

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

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 देखें.