Catch up on highlights from Firebase at Google I/O 2023. Learn more

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • यदि आपका ऐप आरक्षित URL का उपयोग नहीं करता है : यदि आप किसी मौजूदा वेब ऐप के साथ काम कर रहे हैं , तो अपने कोड में 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. एनालिटिक्स जेएस एसडीके जोड़ें और एनालिटिक्स को इनिशियलाइज़ करें:

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

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

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

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

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

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

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

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

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

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

Web modular API

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

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');
analytics_log_event.js

Web namespaced API

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

अगले कदम