लॉग इवेंट

प्लैटफ़ॉर्म चुनें:

iOS+ Android वेब Flutter Unity C++

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

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

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

अगर आपको Apple प्लैटफ़ॉर्म के ऐप्लिकेशन के लिए, कैंपेन एट्रिब्यूशन का डेटा इकट्ठा करना है, तो अपने प्रोजेक्ट में AdSupport फ़्रेमवर्क जोड़ना न भूलें.

लॉग इवेंट

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 रिपोर्ट में डाइमेंशन या मेट्रिक के तौर पर किया जा सकता है. बिना संख्या वाले इवेंट पैरामीटर डेटा के लिए, कस्टम डाइमेंशन का इस्तेमाल किया जा सकता है. साथ ही, किसी भी ऐसे पैरामीटर डेटा के लिए कस्टम मेट्रिक का इस्तेमाल किया जा सकता है जिसे संख्याओं में बेहतर तरीके से दिखाया जा सकता है. एसडीके टूल का इस्तेमाल करके कस्टम पैरामीटर लॉग करने के बाद, डाइमेंशन या मेट्रिक को रजिस्टर करें. इससे यह पक्का किया जा सकेगा कि वे कस्टम पैरामीटर, 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 रिपोर्ट में दिख रहे हैं.

मान्य पैरामीटर वैल्यू, स्ट्रिंग और संख्या होती हैं. किसी कुंजी की वैल्यू को null पर सेट करने से, वह पैरामीटर हट जाता है. शून्य वैल्यू पास करने पर, सभी पैरामीटर मिट जाते हैं.

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

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

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