इस गाइड में, अपने ऐप्लिकेशन में इवेंट लॉग करने का तरीका बताया गया है.
इवेंट से आपको यह इनसाइट मिलती है कि आपके ऐप्लिकेशन में क्या हो रहा है, जैसे कि उपयोगकर्ता की कार्रवाइयां, सिस्टम में होने वाले इवेंट या गड़बड़ियां.
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()
तरीके में कोई पैरामीटर बताया गया है, तो डिफ़ॉल्ट वैल्यू के बजाय उस वैल्यू का इस्तेमाल किया जाता है.
किसी डिफ़ॉल्ट पैरामीटर को हटाने के लिए, nil
पर सेट किए गए पैरामीटर के साथ, setDefaultEventParameters
तरीका कॉल करें.
Xcode डीबग कंसोल में इवेंट देखना
SDK टूल से इवेंट को लॉग करने की प्रक्रिया को मॉनिटर करने के लिए, ज़्यादा जानकारी वाली लॉगिंग की सुविधा चालू की जा सकती है. इससे यह पुष्टि करने में मदद मिलती है कि इवेंट सही तरीके से लॉग हो रहे हैं या नहीं. इसमें अपने-आप और मैन्युअल, दोनों इवेंट शामिल हैं.
ज़्यादा जानकारी वाली लॉगिंग को इस तरह चालू किया जा सकता है:
- Xcode में, प्रॉडक्ट > स्कीम > स्कीम में बदलाव करें... चुनें
- बाईं ओर मौजूद मेन्यू से, चालू करें को चुनें.
- आर्ग्युमेंट टैब चुनें.
- लॉन्च के समय इस्तेमाल किए गए आर्ग्युमेंट सेक्शन में,
-FIRAnalyticsVerboseLoggingEnabled
जोड़ें.
अगली बार ऐप्लिकेशन चलाने पर, आपके इवेंट Xcode डीबग कंसोल में दिखेंगे. इससे आपको तुरंत यह पुष्टि करने में मदद मिलेगी कि इवेंट भेजे जा रहे हैं.
डैशबोर्ड में इवेंट देखना
Firebase कंसोल के डैशबोर्ड में, अपने इवेंट के बारे में एग्रीगेट किए गए आंकड़े देखे जा सकते हैं. ये डैशबोर्ड, दिन भर में समय-समय पर अपडेट होते रहते हैं. तुरंत जांच करने के लिए, पिछले सेक्शन में बताए गए तरीके से logcat आउटपुट का इस्तेमाल करें.
इस डेटा को Firebase कंसोल में, इवेंट डैशबोर्ड से ऐक्सेस किया जा सकता है. यह डैशबोर्ड, इवेंट रिपोर्ट दिखाता है. ये रिपोर्ट, आपके ऐप्लिकेशन से लॉग किए गए हर अलग तरह के इवेंट के लिए अपने-आप बन जाती हैं.