लॉग इवेंट

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