Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. 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. फायरबेस एनालिटिक्स को इनिशियलाइज़ करें:

वेब v8

const analytics = firebase.analytics();

वेब v9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();

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

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

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

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

  • url में [?id=GA_MEASUREMENT_ID](https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID) निकालें। आपका gtag स्निपेट इससे मिलता-जुलता होना चाहिए

    <script async src="https://www.googletagmanager.com/gtag/js"></script>
    
  • लाइन निकालें gtag('config', ' GA_MEASUREMENT_ID '); जहां GA_MEASUREMENT_ID आपके Firebase कॉन्फ़िग स्निपेट में measurementId GA_MEASUREMENT_ID के समान है। यदि आपके पास पृष्ठ पर अन्य Analytics प्रॉपर्टी के लिए अन्य आईडी हैं, तो आपको उनकी कॉन्फ़िगरेशन लाइन निकालने की आवश्यकता नहीं है।

  • gtag() साथ कोई भी ईवेंट भेजने से पहले सुनिश्चित करें कि आप firebase.analytics() कॉल करें।

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

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

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

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

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

वेब v8

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

वेब v9

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

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

अगला कदम