Check out what’s new from Firebase at Google I/O 2022. Learn more

Google विश्लेषिकी के साथ आरंभ करें

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

वेब संस्करण 9

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

वेब संस्करण 8

import firebase from "firebase/app";
import "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
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() कॉल का उपयोग जारी रखने की योजना बनाएं।
  • प्रत्यक्ष gtag() कॉल और Firebase को भेजे गए Google Analytics डेटा दोनों के बीच एक ही माप आईडी का उपयोग करना चाहते हैं।

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

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

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

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

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

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

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

Web version 9

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

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

Web version 8

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

अगले कदम