लॉग इवेंट

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

iOS+ Android Web Flutter Unity C++

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

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

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

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

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

• पैरामीटर के नाम 40 वर्णों तक हो सकते हैं. इनकी शुरुआत किसी अक्षर से होनी चाहिए. इनमें सिर्फ़ ऐल्फ़ा-न्यूमेरिक वर्ण और अंडरस्कोर हो सकते हैं. स्ट्रिंग और num टाइप इस्तेमाल किए जा सकते हैं. स्ट्रिंग पैरामीटर की वैल्यू 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- तरीके में कोई पैरामीटर तय किया जाता है, तो डिफ़ॉल्ट वैल्यू के बजाय उस वैल्यू का इस्तेमाल किया जाता है.

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