इस गाइड में, अपने ऐप्लिकेशन में इवेंट लॉग करने का तरीका बताया गया है.
इवेंट से यह अहम जानकारी मिलती है कि आपके ऐप्लिकेशन में क्या हो रहा है, जैसे कि उपयोगकर्ता की कार्रवाइयां, सिस्टम इवेंट या गड़बड़ियां.
Analytics आपके लिए कुछ इवेंट अपने-आप लॉग करता है. इवेंट पाने के लिए, आपको कोई कोड जोड़ने की ज़रूरत नहीं है. अगर आपके ऐप्लिकेशन को ज़्यादा डेटा इकट्ठा करना है, तो अपने ऐप्लिकेशन में Analytics इवेंट के 500 अलग-अलग टाइप लॉग किए जा सकते हैं. आपके ऐप्लिकेशन लॉग में इवेंट की संख्या की कोई सीमा नहीं है. ध्यान रखें कि इवेंट के नाम केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होते हैं. इसलिए, अगर दो इवेंट लॉग किए जाते हैं, जिनके नाम में अंतर सिर्फ़ केस-सेंसिटिव होता है, तो दोनों अलग-अलग इवेंट बन जाते हैं.
शुरू करने से पहले
पक्का करें कि आपने अपना प्रोजेक्ट सेट अप कर लिया है और Analytics को Analytics का इस्तेमाल शुरू करें में बताए गए तरीके से ऐक्सेस कर सकते हैं.
इवेंट लॉग करें
FirebaseApp
इंस्टेंस कॉन्फ़िगर करने के बाद, logEvent()
तरीके से इवेंट लॉग किए जा सकते हैं.
शुरू करने में आपकी मदद करने के लिए, Analytics SDK कई सुझाए गए इवेंट तय करता है. ये इवेंट अलग-अलग तरह के ऐप्लिकेशन में आम होते हैं. इनमें रीटेल और ई-कॉमर्स, यात्रा, और गेमिंग ऐप्लिकेशन शामिल हैं. इन इवेंट के बारे में और इनका इस्तेमाल कब करना चाहिए, इसके बारे में ज़्यादा जानने के लिए सुझाए गए इवेंट देखें.
Swift और Objective-C के लिए कॉन्सटेंट रेफ़रंस में, लागू करने की जानकारी देखी जा सकती है.
यहां दिए गए उदाहरण में, सुझाए गए
kFIRSelectContent
इवेंट को लॉग करने का तरीका बताया गया है:
Swift
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [ AnalyticsParameterItemID: "id-\(title!)", AnalyticsParameterItemName: title!, AnalyticsParameterContentType: "cont", ])
Objective-C
[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
एक सामान्य मकसद वाला पैरामीटर है. इसकी मदद से, किसी इवेंट से जुड़ी मुख्य मेट्रिक इकट्ठा की जा सकती है. उदाहरण के लिए, रेवेन्यू, दूरी, समय, और पॉइंट.
अगर आपके ऐप्लिकेशन में ऐसी खास ज़रूरतें हैं जो सुझाए गए इवेंट टाइप में शामिल नहीं हैं, तो इस उदाहरण में दिखाए गए तरीके से, अपने कस्टम इवेंट को लॉग किया जा सकता है:
Swift
Analytics.logEvent("share_image", parameters: [ "name": name as NSObject, "full_text": text as NSObject, ])
Objective-C
[FIRAnalytics logEventWithName:@"share_image" parameters:@{ @"name": name, @"full_text": text }];
डिफ़ॉल्ट इवेंट पैरामीटर सेट करना
setDefaultEventParameters
का इस्तेमाल करके, सभी इवेंट में पैरामीटर लॉग किए जा सकते हैं.
डिफ़ॉल्ट पैरामीटर, आने वाले समय में लॉग किए जाने वाले सभी इवेंट से जुड़े होते हैं.
कस्टम पैरामीटर की तरह ही, डिफ़ॉल्ट इवेंट पैरामीटर रजिस्टर करें, ताकि यह पक्का किया जा सके कि Analytics रिपोर्ट में वे कस्टम पैरामीटर दिखें.
Swift
Analytics.setDefaultEventParameters([
"level_name": "Caverns01",
"level_difficulty": 4
])
Objective-C
[FIRAnalytics setDefaultEventParameters:
@{
@"level_name": "Caverns01",
@"level_difficulty": @(4)
}];
अगर logEvent()
तरीके में कोई पैरामीटर बताया गया है, तो डिफ़ॉल्ट वैल्यू के बजाय उस वैल्यू का इस्तेमाल किया जाता है.
किसी डिफ़ॉल्ट पैरामीटर को हटाने के लिए, setDefaultEventParameters
तरीके को कॉल करें, जिसमें पैरामीटर को nil
पर सेट किया गया हो.
Xcode डीबग कंसोल में इवेंट देखें
SDK टूल से इवेंट की लॉगिंग पर नज़र रखने के लिए वर्बोज़ लॉगिंग को चालू किया जा सकता है. इससे यह पुष्टि करने में मदद मिलती है कि इवेंट सही तरीके से लॉग किए जा रहे हैं. इसमें अपने-आप और मैन्युअल, दोनों इवेंट शामिल हैं.
आप इस तरह से वर्बोज़ लॉगिंग को सक्षम कर सकते हैं:
- Xcode में, प्रॉडक्ट > स्कीम > स्कीम में बदलाव करें... चुनें
- बाईं ओर दिए गए मेन्यू में जाकर, Run चुनें.
- आर्ग्युमेंट टैब चुनें.
- लॉन्च किए जाने पर पास किए गए आर्ग्युमेंट सेक्शन में,
-FIRAnalyticsVerboseLoggingEnabled
जोड़ें.
अगली बार ऐप्लिकेशन चलाने पर, आपके इवेंट Xcode डीबग कंसोल में दिखेंगे. इससे आपको तुरंत यह पुष्टि करने में मदद मिलेगी कि इवेंट भेजे जा रहे हैं.
डैशबोर्ड में इवेंट देखना
Firebase कंसोल के डैशबोर्ड में, अपने इवेंट के इकट्ठा किए गए आंकड़े देखे जा सकते हैं. ये डैशबोर्ड दिन भर समय-समय पर अपडेट होते रहते हैं. तुरंत जांच करने के लिए, पिछले सेक्शन में बताए गए तरीके से, Logcat आउटपुट का इस्तेमाल करें.
Firebase कंसोल में, इवेंट डैशबोर्ड से यह डेटा ऐक्सेस किया जा सकता है. यह डैशबोर्ड ऐसी इवेंट रिपोर्ट दिखाता है जो आपके ऐप्लिकेशन से लॉग किए गए हर अलग तरह के इवेंट के लिए अपने-आप बनाई जाती हैं.