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


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

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

  • इवेंट: आपके ऐप्लिकेशन में क्या हो रहा है, जैसे कि उपयोगकर्ता की कार्रवाइयां, सिस्टम में होने वाले इवेंट या गड़बड़ियां.

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

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

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

अगर आपने पहले से Firebase प्रोजेक्ट नहीं जोड़ा है, तो अपने JavaScript प्रोजेक्ट में Firebase जोड़ें और पक्का करें कि आपके Firebase प्रोजेक्ट में Google Analytics चालू है:

  • अगर कोई नया Firebase प्रोजेक्ट बनाया जा रहा है, तो प्रोजेक्ट बनाने के वर्कफ़्लो के दौरान Google Analytics चालू करें.

  • अगर आपके पास कोई मौजूदा Firebase प्रोजेक्ट है, जिसमें Google Analytics चालू नहीं है, तो इसे चालू करने के लिए, > प्रोजेक्ट सेटिंग के इंटिग्रेशन टैब पर जाएं.

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

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

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

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

    • अगर आपका ऐप्लिकेशन, Firebase SDK टूल के लिए Firebase Hosting और रिज़र्व किए गए यूआरएल का इस्तेमाल करता है, तो:

      Firebase, आपके ऐप्लिकेशन को कॉन्फ़िगर करने की प्रोसेस को अपने-आप मैनेज करता है. सेटअप पूरा करने के लिए, अगर आपने अब तक ऐसा नहीं किया है, तो आपके ऐप्लिकेशन कार्ड में मौजूद स्क्रिप्ट को, प्रोजेक्ट सेटिंग में जाकर अपने ऐप्लिकेशन के <body> टैग में जोड़ें.

    • अगर आपका ऐप्लिकेशन, रिज़र्व किए गए यूआरएल का इस्तेमाल नहीं करता है, तो: अगर किसी मौजूदा वेब ऐप्लिकेशन पर काम किया जा रहा है, तो अपने कोड में Firebase कॉन्फ़िगरेशन ऑब्जेक्ट को अपडेट करें. इससे यह पक्का किया जा सकेगा कि measurementId फ़ील्ड मौजूद है. कॉन्फ़िगरेशन ऑब्जेक्ट, नीचे दिए गए उदाहरण की तरह दिखना चाहिए:

      // For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field
      const firebaseConfig = {
        apiKey: "AIzaSyCGQ0tYppWFJkuSxBhOpkH0xVDmX245Vdc",
        authDomain: "project-id.firebaseapp.com",
        databaseURL: "https://project-id.firebaseio.com",
        projectId: "project-id",
        storageBucket: "project-id.appspot.com",
        messagingSenderId: "637908496727",
        appId: "2:637908496727:web:a4284b4c99e329d5",
        measurementId: "G-9VP01NDSXJ"
      };
      
  2. अगर आपने अब तक ऐसा नहीं किया है, तो Firebase JS SDK टूल इंस्टॉल करें और Firebase को शुरू करें.

  3. Analytics JS SDK जोड़ें और Analytics शुरू करें:

Web

import { initializeApp } from "firebase/app";
import { getAnalytics } from "firebase/analytics";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize Firebase
const app = initializeApp(firebaseConfig);


// Initialize Analytics and get a reference to the service
const analytics = getAnalytics(app);

Web

import firebase from "firebase/compat/app";
import "firebase/compat/analytics";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize Firebase
firebase.initializeApp(firebaseConfig);


// Initialize Analytics and get a reference to the service
const analytics = firebase.analytics();

मौजूदा gtag.js टैगिंग के साथ Firebase का इस्तेमाल करना

अगर आपने पहले अपने ऐप्लिकेशन में gtag.js स्निपेट का इस्तेमाल करके Google Analytics को चालू किया था, तो इनमें से कोई एक काम करने के लिए, हो सकता है कि आपके ऐप्लिकेशन को अतिरिक्त सेटअप की ज़रूरत पड़े:

  • पेज पर Firebase से Google Analytics कॉल जोड़ें. साथ ही, उसी पेज पर gtag() कॉल का इस्तेमाल जारी रखने का भी प्लान बनाएं.
  • आपको Firebase को भेजे गए डायरेक्ट gtag() कॉल और Google Analytics डेटा, दोनों के लिए एक ही मेज़रमेंट आईडी का इस्तेमाल करना है.

यह पक्का करने के लिए कि आपके इवेंट सभी Firebase सेवाओं के इस्तेमाल के लिए उपलब्ध हैं, सेटअप के लिए नीचे दिए गए दूसरे चरणों को पूरा करें:

  • लाइन gtag('config', 'GA_MEASUREMENT_ID'); हटाएं, जहां GA_MEASUREMENT_ID आपके Firebase वेब ऐप्लिकेशन का measurementId है. अगर आपके पेज पर अन्य Analytics प्रॉपर्टी के लिए अन्य आईडी हैं, तो आपको उनकी कॉन्फ़िगरेशन लाइन हटाने की ज़रूरत नहीं है.
  • gtag() के साथ कोई इवेंट भेजने से पहले, firebase.analytics() को कॉल करना न भूलें.

ऐसा न करने पर, gtag() कॉल के साथ उस आईडी पर भेजे गए इवेंट, Firebase से नहीं जुड़ेंगे. साथ ही, वे Firebase की अन्य सेवाओं में टारगेटिंग के लिए उपलब्ध नहीं होंगे.

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

Analytics सेवा को शुरू करने के बाद, logEvent() तरीके से इवेंट को लॉग करना शुरू किया जा सकता है.

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

यहां दिए गए उदाहरण में, सुझाए गए इवेंट को लॉग करने का तरीका बताया गया है. इससे यह पता चलता है कि उपयोगकर्ता को आपके ऐप्लिकेशन में सूचना मिली है:

Web

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');

Web

firebase.analytics().logEvent('notification_received');

अगले चरण