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

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


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

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

  • इवेंट: आपके ऐप्लिकेशन में क्या हो रहा है. जैसे, उपयोगकर्ता की कार्रवाइयां, सिस्टम में होने वाले इवेंट या गड़बड़ियां.

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

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

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

अगर आपने पहले से ही A/B टेस्टिंग नहीं बनाई है, तो अपने JavaScript प्रोजेक्ट में Firebase जोड़ें. साथ ही, पक्का करें कि आपके 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 प्रोजेक्ट में 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() को किए गए डायरेक्ट कॉल और Firebase को भेजे गए Google Analytics डेटा, दोनों के लिए एक ही मेज़रमेंट आईडी का इस्तेमाल करना है.

यह पक्का करने के लिए कि आपके इवेंट, 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');

अगले चरण