| प्लैटफ़ॉर्म चुनें: | iOS+ Android Web Flutter Unity C++ |
इस क्विकस्टार्ट में, अपने ऐप्लिकेशन में Google Analytics जोड़ने और इवेंट लॉग करना शुरू करने का तरीका बताया गया है.
Google Analytics आपके वेब ऐप्लिकेशन के इस्तेमाल और उपयोगकर्ता के व्यवहार से जुड़ा डेटा इकट्ठा करता है. SDK टूल, दो मुख्य तरह की जानकारी लॉग करता है:
इवेंट: आपके ऐप्लिकेशन में क्या हो रहा है. जैसे, उपयोगकर्ता की कार्रवाइयां, सिस्टम में होने वाले इवेंट या गड़बड़ियां.
उपयोगकर्ता प्रॉपर्टी: ऐसे एट्रिब्यूट जिन्हें आपने अपने उपयोगकर्ता आधार के सेगमेंट की जानकारी देने के लिए तय किया है. जैसे, भाषा से जुड़ी प्राथमिकताएं या भौगोलिक जगहें.
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 का इस्तेमाल करने के लिए, यह आईडी ज़रूरी है.AnalyticsAnalyticsअगर आपका ऐप्लिकेशन Firebase Hosting और रिज़र्व किए गए यूआरएल का इस्तेमाल करता है Firebase SDK टूल के लिए:
Firebase, आपके ऐप्लिकेशन को कॉन्फ़िगर करने की प्रोसेस को अपने-आप मैनेज करता है. सेटअप पूरा करने के लिए, अपने प्रोजेक्ट की सेटिंग में मौजूद आपके ऐप्लिकेशन कार्ड से स्क्रिप्ट जोड़ें. अगर आपने पहले से स्क्रिप्ट नहीं जोड़ी हैं, तो उन्हें अपने ऐप्लिकेशन के <body> टैग में जोड़ें.
अगर आपका ऐप्लिकेशन, रिज़र्व किए गए यूआरएल का इस्तेमाल नहीं करता है: अगर आपके पास पहले से कोई वेब ऐप्लिकेशन है, तो अपने कोड में मौजूद Firebase कॉन्फ़िगरेशन ऑब्जेक्ट को अपडेट करें, ताकि यह पक्का किया जा सके कि उसमें
measurementIdफ़ील्ड मौजूद हो. कॉन्फ़िगरेशन ऑब्जेक्ट, यहां दिए गए उदाहरण जैसा दिखना चाहिए: 1. अगर आपने पहले से ही Firebase JS SDK इंस्टॉल नहीं किया है और Firebase शुरू नहीं किया है, तो ऐसा करें. 2. Analytics JS SDK जोड़ें और Analytics शुरू करें: * { Web }// 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: " ", messagingSenderId: "SENDER_ID", appId: "APP_ID", measurementId: "G-GA_MEASUREMENT_ID" };PROJECT_ID.firebasestorage.app * { 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);
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()कॉल का इस्तेमाल जारी रखना. - सीधे
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');
अगले चरण
- Analytics की हर रिपोर्ट के बारे में जानें.
- अपने इवेंट की पुष्टि करने के लिए, DebugView का इस्तेमाल करें.
- Firebase कंसोल में अपना डेटा एक्सप्लोर करें.Firebase
- इवेंट और उपयोगकर्ता प्रॉपर्टी के बारे में गाइड पढ़ें..
- BigQuery में अपना डेटा एक्सपोर्ट करने का तरीका जानें.