लॉग इवेंट

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

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

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

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

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

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

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

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

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

निम्नलिखित उदाहरण दर्शाता है कि अनुशंसित 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"
                                 }];

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

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

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

  • 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.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

उद्देश्य सी

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

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

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

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

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

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

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

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

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

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

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