इस क्विकस्टार्ट में, अपने ऐप्लिकेशन में 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 होस्टिंग का इस्तेमाल करता है और 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" };
अगर आपने पहले से ऐसा नहीं किया है, तो 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 को भेजे गए 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');
Web
firebase.analytics().logEvent('notification_received');
अगले चरण
- हर Analytics रिपोर्ट को समझें.
- अपने इवेंट की पुष्टि करने के लिए, DebugView का इस्तेमाल करें.
- Firebase कंसोल में अपना डेटा एक्सप्लोर करें.
- इवेंट और उपयोगकर्ता प्रॉपर्टी की गाइड देखें.
- अपना डेटा BigQuery में एक्सपोर्ट करने का तरीका जानें.