यह मार्गदर्शिका आपको दिखाती है कि अपने ऐप में ईवेंट कैसे लॉग करें।
ईवेंट इस बात की जानकारी प्रदान करते हैं कि आपके ऐप में क्या हो रहा है, जैसे कि उपयोगकर्ता क्रियाएँ, सिस्टम ईवेंट या त्रुटियाँ।
Analytics स्वचालित रूप से आपके लिए कुछ ईवेंट लॉग करता है; उन्हें प्राप्त करने के लिए आपको कोई कोड जोड़ने की आवश्यकता नहीं है। यदि आपके ऐप को अतिरिक्त डेटा एकत्र करने की आवश्यकता है, तो आप अपने ऐप में 500 अलग-अलग प्रकार के एनालिटिक्स ईवेंट लॉग अप कर सकते हैं। आपके ऐप द्वारा लॉग किए जाने वाले ईवेंट की कुल मात्रा की कोई सीमा नहीं है। ध्यान दें कि ईवेंट के नाम केस-संवेदी होते हैं और यह कि दो इवेंट जिनके नाम केवल मामले में भिन्न होते हैं, को लॉग करने से दो अलग-अलग ईवेंट होंगे।
शुरू करने से पहले
सुनिश्चित करें कि आपने अपना प्रोजेक्ट सेट अप कर लिया है और आप 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 द्वारा ईवेंट लॉगिंग की निगरानी करने के लिए वर्बोज़ लॉगिंग सक्षम कर सकते हैं। इसमें स्वचालित रूप से और मैन्युअल रूप से लॉग किए गए ईवेंट दोनों शामिल हैं।
आप वर्बोज़ लॉगिंग को निम्नानुसार सक्षम कर सकते हैं:
- Xcode में, उत्पाद > योजना > संपादित योजना चुनें...
- बाएं मेनू से चलाएँ चुनें।
- तर्क टैब का चयन करें।
- लॉन्च सेक्शन में दिए गए तर्कों में
-FIRAnalyticsVerboseLoggingEnabled
जोड़ें।
अगली बार जब आप अपना ऐप चलाते हैं, तो आपके ईवेंट Xcode डीबग कंसोल में प्रदर्शित होंगे, जिससे आपको तुरंत यह सत्यापित करने में मदद मिलेगी कि ईवेंट भेजे जा रहे हैं।
डैशबोर्ड में ईवेंट देखें
आप फायरबेस कंसोल डैशबोर्ड में अपने ईवेंट के बारे में एकत्रित आंकड़े देख सकते हैं। ये डैशबोर्ड पूरे दिन समय-समय पर अपडेट होते रहते हैं। तत्काल परीक्षण के लिए, पिछले अनुभाग में वर्णित लॉगकैट आउटपुट का उपयोग करें।
आप इस डेटा को फायरबेस कंसोल में इवेंट डैशबोर्ड से एक्सेस कर सकते हैं। यह डैशबोर्ड इवेंट रिपोर्ट दिखाता है जो आपके ऐप द्वारा लॉग किए गए प्रत्येक विशिष्ट प्रकार के इवेंट के लिए स्वचालित रूप से बनाई जाती हैं।