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

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

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

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

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

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

अगर आपने पहले से Firebase को नहीं जोड़ा है, तो अपनी JavaScript में 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. चालू करने पर, यह आईडी अपने-आप बन जाता है Analytics पर सेट करना है और कोई वेब ऐप्लिकेशन रजिस्टर करना है, तो Analytics का इस्तेमाल करना ज़रूरी है.

    • अगर आपका ऐप्लिकेशन, Firebase होस्टिंग का इस्तेमाल करता है और Firebase SDK टूल के लिए, रिज़र्व किए गए यूआरएल:

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

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

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 का इस्तेमाल करें

अगर पहले आपके ऐप्लिकेशन में Google Analytics, gtag.js स्निपेट, अगर आपको इनमें से कोई काम करना है, तो आपके ऐप्लिकेशन को अतिरिक्त सेटअप की ज़रूरत पड़ सकती है:

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

यह पक्का करने के लिए कि Firebase की सभी सेवाएं आपके इवेंट का इस्तेमाल कर सकती हैं, पूरा करें सेट अप करने के लिए, नीचे दिए गए अतिरिक्त चरण पूरे करें:

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

ऐसा न करने पर, उस आईडी पर gtag() कॉल के साथ भेजे गए इवेंट नहीं जोड़े जाएंगे Firebase के साथ किया जाता है और दूसरे देशों में टारगेटिंग के लिए उपलब्ध नहीं होगा Firebase सेवाएं.

इवेंट लॉग करना शुरू करें

शुरू करने के बाद Analytics सेवा से साइन इन करके, इसके साथ इवेंट लॉग करना शुरू करें logEvent() तरीका.

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

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

Web

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

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

Web

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

अगले चरण