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

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

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

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

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

वेब कंटेनर इंस्टॉल करने से पहले

अगर आपने पहले से Firebase प्रोजेक्ट नहीं जोड़ा है, तो अपने 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 होस्टिंग का इस्तेमाल करता है और 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 का इस्तेमाल करें

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

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

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

Web

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

अगले चरण