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


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

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

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

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

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

अगर आपने पहले से ही अपने 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 Hosting का इस्तेमाल करता है और Firebase SDK टूल के लिए रिज़र्व किए गए यूआरएल का इस्तेमाल करता है, तो:

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

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

      // For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field
const firebaseConfig = {
  apiKey: "API_KEY",
  authDomain: "PROJECT_ID.firebaseapp.com",
  databaseURL: "https://PROJECT_ID.firebaseio.com",
  projectId: "PROJECT_ID",
  storageBucket: "PROJECT_ID.firebasestorage.app",
  messagingSenderId: "SENDER_ID",
  appId: "APP_ID",
  measurementId: "G-GA_MEASUREMENT_ID"
};

  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');
analytics_log_event.js

Web

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

अगले चरण