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

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


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

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

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

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

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

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

अगर आपने पहले से ही Firebase को अपने JavaScript प्रोजेक्ट में नहीं जोड़ा है, तो उसे जोड़ें. साथ ही, पक्का करें कि आपके 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 का इस्तेमाल करने के लिए, यह आईडी ज़रूरी है.AnalyticsAnalytics

gtag.js टैगिंग के साथ Firebase का इस्तेमाल करना

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

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

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

अगले चरण