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

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

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

  • इवेंट : आपके ऐप में क्या हो रहा है, जैसे उपयोगकर्ता की गतिविधियां, सिस्टम इवेंट या त्रुटियां।

  • उपयोगकर्ता गुण : वे गुण जिन्हें आप अपने उपयोगकर्ता आधार के खंडों का वर्णन करने के लिए परिभाषित करते हैं, जैसे भाषा प्राथमिकता या भौगोलिक स्थान।

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

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

यदि आपने पहले से नहीं किया है, तो अपने जावास्क्रिप्ट प्रोजेक्ट में फायरबेस जोड़ें और सुनिश्चित करें कि आपके फायरबेस प्रोजेक्ट में Google Analytics सक्षम है:

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

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

जब आप अपने प्रोजेक्ट में Google Analytics सक्षम करते हैं, तो आपके फायरबेस वेब ऐप्स ऐप + वेब प्रॉपर्टी से जुड़े Google Analytics डेटा स्ट्रीम से लिंक हो जाते हैं।

अपने ऐप में एनालिटिक्स एसडीके जोड़ें

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

  1. जांचें कि आपके कोड में आपके फायरबेस कॉन्फिग ऑब्जेक्ट में measurementId है। जब आप अपने फायरबेस प्रोजेक्ट में एनालिटिक्स सक्षम करते हैं और एक वेब ऐप पंजीकृत करते हैं तो यह आईडी स्वचालित रूप से बनाई जाती है, और एनालिटिक्स का उपयोग करना आवश्यक है।

    • यदि आपका ऐप फायरबेस होस्टिंग का उपयोग करता है और फायरबेस एसडीके के लिए आरक्षित यूआरएल का उपयोग करता है :

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

    • यदि आपका ऐप आरक्षित यूआरएल का उपयोग नहीं करता है : यदि आप मौजूदा वेब ऐप के साथ काम कर रहे हैं , तो यह सुनिश्चित करने के लिए कि 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 प्रारंभ करें:

वेब मॉड्यूलर एपीआई

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

वेब नेमस्पेस्ड एपीआई

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 चल रहा था, तो यदि आप निम्न में से कोई एक करने की योजना बनाते हैं तो आपके ऐप को अतिरिक्त सेटअप की आवश्यकता हो सकती है:

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

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

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

अन्यथा, gtag() कॉल के साथ उस आईडी पर भेजे गए इवेंट फ़ायरबेस से संबद्ध नहीं होंगे और अन्य फ़ायरबेस सेवाओं में लक्ष्यीकरण के लिए उपलब्ध नहीं होंगे।

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

एनालिटिक्स सेवा आरंभ करने के बाद, आप logEvent() विधि से ईवेंट लॉग करना शुरू कर सकते हैं।

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

निम्नलिखित उदाहरण दर्शाता है कि उपयोगकर्ता को आपके ऐप में एक अधिसूचना प्राप्त होने का संकेत देने के लिए अनुशंसित ईवेंट को कैसे लॉग किया जाए:

Web modular API

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

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

Web namespaced API

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

अगले कदम