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


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

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

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

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

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"
};

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

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

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

अगले चरण