लॉग इवेंट

यह मार्गदर्शिका आपको दिखाती है कि अपने ऐप में ईवेंट कैसे लॉग करें।

ईवेंट आपके ऐप में क्या हो रहा है, इस बारे में जानकारी प्रदान करते हैं, जैसे उपयोगकर्ता क्रियाएं, सिस्टम ईवेंट या त्रुटियां।

Analytics स्वचालित रूप से आपके लिए कुछ ईवेंट लॉग करता है; आपको उन्हें प्राप्त करने के लिए कोई कोड जोड़ने की आवश्यकता नहीं है। यदि आपके ऐप को अतिरिक्त डेटा एकत्र करने की आवश्यकता है, तो आप अपने ऐप में 500 अलग-अलग Analytics ईवेंट प्रकार तक लॉग इन कर सकते हैं। आपके ऐप द्वारा लॉग किए जाने वाले ईवेंट की कुल मात्रा की कोई सीमा नहीं है। ध्यान दें कि ईवेंट के नाम केस-संवेदी होते हैं और दो ईवेंट लॉगिंग जिनके नाम केवल मामले में भिन्न होते हैं, दो अलग-अलग ईवेंट में परिणामित होंगे।

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

सुनिश्चित करें कि आपने अपना प्रोजेक्ट सेट अप कर लिया है और Analytics के साथ प्रारंभ करें में वर्णित अनुसार Analytics तक पहुंच सकते हैं।

लॉग इवेंट

FirebaseApp इंस्टेंस को कॉन्फ़िगर करने के बाद, आप logEvent() विधि से ईवेंट लॉग करना शुरू कर सकते हैं।

आरंभ करने में आपकी सहायता के लिए, Analytics SDK ऐसे कई अनुशंसित ईवेंट निर्धारित करता है, जो खुदरा और ईकॉमर्स, यात्रा और गेमिंग ऐप्स सहित विभिन्न प्रकार के ऐप्स में सामान्य हैं। इन ईवेंट के बारे में और उनका उपयोग कब करें, इसके बारे में अधिक जानने के लिए, अनुशंसित ईवेंट देखें.

आप स्विफ्ट और ऑब्जेक्टिव-सी के लिए स्थिरांक संदर्भ में कार्यान्वयन विवरण पा सकते हैं।

निम्न उदाहरण दर्शाता है कि किसी अनुशंसित kFIRSelectContent ईवेंट को कैसे लॉग किया जाए:

तीव्र

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

उद्देश्य सी

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

निर्धारित मापदंडों के अलावा, आप किसी भी घटना में निम्नलिखित पैरामीटर जोड़ सकते हैं:

  • कस्टम पैरामीटर: कस्टम पैरामीटर का उपयोग Analytics रिपोर्ट में आयाम या मीट्रिक के रूप में किया जा सकता है. आप गैर-संख्यात्मक ईवेंट पैरामीटर डेटा के लिए कस्टम आयामों का उपयोग कर सकते हैं और संख्यात्मक रूप से बेहतर ढंग से दर्शाए गए किसी भी पैरामीटर डेटा के लिए कस्टम मीट्रिक का उपयोग कर सकते हैं। SDK का उपयोग करके एक कस्टम पैरामीटर लॉग करने के बाद, यह सुनिश्चित करने के लिए आयाम या मीट्रिक पंजीकृत करें कि वे कस्टम पैरामीटर Analytics रिपोर्ट में दिखाई दें. इसके माध्यम से करें: Analytics > ईवेंट > कस्टम परिभाषाएं प्रबंधित करें > कस्टम आयाम बनाएं

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

  • kFIRParameterValue पैरामीटर: kFIRParameterValue एक सामान्य उद्देश्य पैरामीटर है जो किसी घटना से संबंधित एक प्रमुख मीट्रिक को जमा करने के लिए उपयोगी होता है। उदाहरणों में राजस्व, दूरी, समय और अंक शामिल हैं।

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

तीव्र

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])

उद्देश्य सी

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

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

आप setDefaultEventParameters का उपयोग करके सभी ईवेंट में पैरामीटर लॉग कर सकते हैं। डिफ़ॉल्ट पैरामीटर लॉग किए जाने वाले सभी भावी ईवेंट से संबद्ध होते हैं.

कस्टम पैरामीटर की तरह, डिफ़ॉल्ट ईवेंट पैरामीटर पंजीकृत करके सुनिश्चित करें कि वे कस्टम पैरामीटर Analytics रिपोर्ट में दिखाई दें.

तीव्र

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

उद्देश्य सी

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

यदि कोई पैरामीटर logEvent() विधि में निर्दिष्ट है, तो उस मान का उपयोग डिफ़ॉल्ट के बजाय किया जाता है।

डिफ़ॉल्ट पैरामीटर को साफ़ करने के लिए, setDefaultEventParameters विधि को पैरामीटर सेट के साथ nil पर कॉल करें।

Xcode डिबग कंसोल में ईवेंट देखें

आप यह सत्यापित करने में सहायता के लिए कि ईवेंट ठीक से लॉग किए जा रहे हैं, SDK द्वारा ईवेंट की लॉगिंग की निगरानी के लिए वर्बोज़ लॉगिंग को सक्षम कर सकते हैं। इसमें स्वचालित रूप से और मैन्युअल रूप से लॉग किए गए ईवेंट दोनों शामिल हैं।

आप वर्बोज़ लॉगिंग को निम्नानुसार सक्षम कर सकते हैं:

  1. Xcode में, उत्पाद > योजना > योजना संपादित करें चुनें...
  2. बाएं मेनू से चलाएँ का चयन करें।
  3. तर्क टैब का चयन करें।
  4. लॉन्च पर पारित तर्क में, -FIRAnalyticsDebugEnabled जोड़ें।

अगली बार जब आप अपना ऐप चलाते हैं, तो आपके ईवेंट Xcode डिबग कंसोल में प्रदर्शित होंगे, जिससे आपको तुरंत यह सत्यापित करने में मदद मिलेगी कि ईवेंट भेजे जा रहे हैं।

डैशबोर्ड में ईवेंट देखें

आप Firebase कंसोल डैशबोर्ड में अपने ईवेंट के बारे में समेकित आंकड़े देख सकते हैं. ये डैशबोर्ड पूरे दिन समय-समय पर अपडेट होते रहते हैं। तत्काल परीक्षण के लिए, पिछले अनुभाग में बताए अनुसार लॉगकैट आउटपुट का उपयोग करें।

आप इस डेटा को Firebase कंसोल में ईवेंट डैशबोर्ड से एक्सेस कर सकते हैं. यह डैशबोर्ड उन ईवेंट रिपोर्ट को दिखाता है जो आपके ऐप द्वारा लॉग किए गए प्रत्येक विशिष्ट प्रकार के ईवेंट के लिए स्वचालित रूप से बनाई जाती हैं।