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

प्लैटफ़ॉर्म चुनें: iOS+ Android Web Flutter Unity C++


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

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

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

    • अगर आपका ऐप्लिकेशन, रिज़र्व किए गए यूआरएल का इस्तेमाल नहीं करता है: अगर आपके पास पहले से कोई वेब ऐप्लिकेशन है, तो अपने कोड में मौजूद Firebase कॉन्फ़िगरेशन ऑब्जेक्ट को अपडेट करें, ताकि यह पक्का किया जा सके कि उसमें measurementId फ़ील्ड मौजूद है. कॉन्फ़िगरेशन ऑब्जेक्ट, यहां दिए गए उदाहरण जैसा दिखना चाहिए:

      // For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field
const firebaseConfig = {
  apiKey: "API_KEY",
  authDomain: "PROJECT_ID.firebaseapp.com",
  databaseURL: "https://PROJECT_ID.firebaseio.com",
  projectId: "PROJECT_ID",
  storageBucket: "PROJECT_ID.firebasestorage.app",
  messagingSenderId: "SENDER_ID",
  appId: "APP_ID",
  measurementId: "G-GA_MEASUREMENT_ID"
};
      1. अगर आपने पहले से ही Firebase JS SDK इंस्टॉल नहीं किया है, तो उसे इंस्टॉल करें और Firebase शुरू करें. 2. 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 का इस्तेमाल करना

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

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

यह पक्का करने के लिए कि आपके इवेंट, Firebase की सभी सेवाओं के लिए उपलब्ध हों, सेटअप के ये अतिरिक्त चरण पूरे करें:

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

ऐसा न करने पर, 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');

अगले चरण