इवेंट लॉग करें


इस गाइड में, अपने ऐप्लिकेशन में इवेंट लॉग करने का तरीका बताया गया है.

Analytics आपके लिए कुछ इवेंट अपने-आप लॉग करता है. इन्हें पाने के लिए, आपको कोई कोड जोड़ने की ज़रूरत नहीं है. अगर आपके ऐप्लिकेशन को ज़्यादा डेटा इकट्ठा करना है, तो अपने ऐप्लिकेशन में 500 अलग-अलग Analytics इवेंट टाइप लॉग किए जा सकते हैं. आपके ऐप्लिकेशन में लॉग किए जाने वाले इवेंट की कुल संख्या पर कोई सीमा नहीं है. ध्यान दें कि इवेंट के नाम केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होते हैं. अगर दो इवेंट के नाम में सिर्फ़ अक्षरों का अंतर है, तो वे दोनों अलग-अलग इवेंट के तौर पर दिखेंगे.

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

पक्का करें कि आपने अपना प्रोजेक्ट सेट अप कर लिया हो और आपके पास Analytics का इस्तेमाल शुरू करना में बताए गए तरीके से Analytics को ऐक्सेस करने की अनुमति हो.

इवेंट लॉग करना

FirebaseAnalytics इंस्टेंस बनाने के बाद, इसका इस्तेमाल लाइब्रेरी के log- तरीकों के साथ इवेंट को लॉग करने के लिए किया जा सकता है.

पहले से तय किए गए इवेंट

शुरू करने में आपकी मदद करने के लिए, Analytics SDK टूल कई सुझाए गए इवेंट तय करता है. ये इवेंट, अलग-अलग तरह के ऐप्लिकेशन में आम तौर पर इस्तेमाल किए जाते हैं. इनमें रीटेल और ई-कॉमर्स, ट्रैवल, और गेमिंग ऐप्लिकेशन शामिल हैं. इन इवेंट के बारे में और इनका इस्तेमाल कब करना है, इस बारे में ज़्यादा जानने के लिए, सुझाए गए इवेंट देखें.

सुझाए गए इवेंट टाइप के लिए लॉग करने के तरीके, एपीआई के रेफ़रंस में देखे जा सकते हैं.

यहां दिए गए उदाहरण में, select_content इवेंट को लॉग करने का तरीका बताया गया है:

await FirebaseAnalytics.instance.logSelectContent(
    contentType: "image",
    itemId: itemId,
);

इसके अलावा, logEvent() का इस्तेमाल करके भी उसी इवेंट को लॉग किया जा सकता है:

await FirebaseAnalytics.instance.logEvent(
    name: "select_content",
    parameters: {
        "content_type": "image",
        "item_id": itemId,
    },
);

यह तब काम आ सकता है, जब आपको तय किए गए (ज़रूरी) पैरामीटर के अलावा, अन्य पैरामीटर तय करने हों. किसी भी इवेंट में ये पैरामीटर जोड़े जा सकते हैं:

  • कस्टम पैरामीटर: Analytics रिपोर्ट में, कस्टम पैरामीटर का इस्तेमाल डाइमेंशन या मेट्रिक के तौर पर किया जा सकता है. संख्या के बजाय किसी दूसरे फ़ॉर्मैट में मौजूद इवेंट पैरामीटर के डेटा के लिए, कस्टम डाइमेंशन का इस्तेमाल किया जा सकता है. साथ ही, संख्या के ज़रिए बेहतर तरीके से दिखाए गए किसी भी पैरामीटर के डेटा के लिए, कस्टम मेट्रिक का इस्तेमाल किया जा सकता है. SDK टूल का इस्तेमाल करके कस्टम पैरामीटर को लॉग करने के बाद, डाइमेंशन या मेट्रिक को रजिस्टर करें. इससे यह पक्का किया जा सकेगा कि वे कस्टम पैरामीटर, Analytics रिपोर्ट में दिखें. ऐसा करने के लिए, Analytics > इवेंट > कस्टम डेफ़िनिशन मैनेज करें > कस्टम डाइमेंशन बनाएं पर जाएं.

    कस्टम पैरामीटर का इस्तेमाल, ऑडियंस की उन परिभाषाओं में किया जा सकता है जिन्हें हर रिपोर्ट पर लागू किया जा सकता है. अगर आपका ऐप्लिकेशन किसी BigQuery प्रोजेक्ट से लिंक है, तो BigQuery में एक्सपोर्ट किए गए डेटा में भी कस्टम पैरामीटर शामिल होते हैं. Google Analytics 4 BigQuery Export पर, सैंपल क्वेरी और इससे जुड़ी अन्य जानकारी पाएं.

  • value पैरामीटर: यह एक सामान्य पैरामीटर है, जो किसी इवेंट से जुड़ी मुख्य मेट्रिक इकट्ठा करने के लिए काम आता है. उदाहरण के लिए, रेवेन्यू, दूरी, समय, और पॉइंट.

  • पैरामीटर के नाम में ज़्यादा से ज़्यादा 40 वर्ण हो सकते हैं. साथ ही, इनकी शुरुआत अक्षर से होनी चाहिए. इनमें सिर्फ़ अक्षर, अंक, और अंडरस्कोर शामिल होने चाहिए. स्ट्रिंग और संख्या वाले वैल्यू टाइप इस्तेमाल किए जा सकते हैं. स्ट्रिंग पैरामीटर की वैल्यू में ज़्यादा से ज़्यादा 100 वर्ण हो सकते हैं. "firebase", "google", और "ga_" प्रीफ़िक्स रिज़र्व हैं. इनका इस्तेमाल पैरामीटर के नामों के लिए नहीं किया जाना चाहिए.

कस्टम इवेंट

अगर आपके ऐप्लिकेशन की कुछ खास ज़रूरतें हैं और इन्हें सुझाए गए इवेंट टाइप से पूरा नहीं किया जा सकता, तो इस उदाहरण में दिखाए गए तरीके से अपने कस्टम इवेंट लॉग किए जा सकते हैं:

await FirebaseAnalytics.instance.logEvent(
    name: "share_image",
    parameters: {
        "image_name": name,
        "full_text": text,
    },
);

डिफ़ॉल्ट इवेंट पैरामीटर सेट करना

setDefaultEventParameters() का इस्तेमाल करके, सभी इवेंट में पैरामीटर लॉग किए जा सकते हैं. डिफ़ॉल्ट पैरामीटर, आने वाले समय में होने वाले उन सभी इवेंट से जुड़े होते हैं जिन्हें लॉग किया जाता है.

कस्टम पैरामीटर की तरह ही, डिफ़ॉल्ट इवेंट पैरामीटर भी रजिस्टर करें, ताकि यह पक्का किया जा सके कि वे Analytics रिपोर्ट में दिख रहे हैं.

पैरामीटर की मान्य वैल्यू, स्ट्रिंग और num हैं. किसी कीवर्ड की वैल्यू को null पर सेट करने पर, उस पैरामीटर को मिटा दिया जाता है. कोई भी वैल्यू न डालने पर, सभी पैरामीटर हट जाते हैं.

// Not supported on web
await FirebaseAnalytics.instance
  .setDefaultEventParameters({
    version: '1.2.3'
  });

अगर logEvent() या log- विधि में कोई पैरामीटर तय किया गया है, तो डिफ़ॉल्ट के बजाय उस वैल्यू का इस्तेमाल किया जाता है.

किसी डिफ़ॉल्ट पैरामीटर को हटाने के लिए, setDefaultEventParameters() पैरामीटर को null पर सेट करके, उससे जुड़े तरीके को कॉल करें.

डैशबोर्ड में इवेंट देखना

Firebase कंसोल के डैशबोर्ड में, अपने इवेंट के बारे में एग्रीगेट किए गए आंकड़े देखे जा सकते हैं. ये डैशबोर्ड, दिन भर में समय-समय पर अपडेट होते रहते हैं. तुरंत जांच करने के लिए, पिछले सेक्शन में बताए गए तरीके से logcat आउटपुट का इस्तेमाल करें.

इस डेटा को Firebase कंसोल में, इवेंट डैशबोर्ड से ऐक्सेस किया जा सकता है. यह डैशबोर्ड, इवेंट रिपोर्ट दिखाता है. ये रिपोर्ट, आपके ऐप्लिकेशन से लॉग किए गए हर अलग तरह के इवेंट के लिए अपने-आप बन जाती हैं.