इस क्विकस्टार्ट में, 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 का इस्तेमाल करना में बताया गया अतिरिक्त सेटअप करना पड़ सकता है.
देखें कि आपके कोड के Firebase कॉन्फ़िगरेशन ऑब्जेक्ट में
measurementId
शामिल है या नहीं. यह आईडी अपने-आप बन जाता है, जब Firebase प्रोजेक्ट में Analytics को चालू किया जाता है और कोई वेब ऐप्लिकेशन रजिस्टर किया जाता है. साथ ही, Analytics का इस्तेमाल करने के लिए, यह ज़रूरी है.अगर आपका ऐप्लिकेशन, Firebase SDK टूल के लिए Firebase Hosting और रिज़र्व किए गए यूआरएल का इस्तेमाल करता है, तो:
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" };
अगर आपने अब तक ऐसा नहीं किया है, तो Firebase JS SDK टूल इंस्टॉल करें और Firebase को शुरू करें.
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 को भेजे गए डायरेक्ट
gtag()
कॉल और 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');
अगले चरण
- हर Analytics रिपोर्ट को समझें.
- अपने इवेंट की पुष्टि करने के लिए, DebugView का इस्तेमाल करें.
- Firebase कंसोल में अपना डेटा एक्सप्लोर करें.
- इवेंट और उपयोगकर्ता प्रॉपर्टी के बारे में गाइड देखें.
- BigQuery में अपना डेटा एक्सपोर्ट करने का तरीका जानें.