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


इस गाइड में, आपके ऐप्लिकेशन में इवेंट लॉग करने का तरीका बताया गया है.

इवेंट से आपको यह इनसाइट मिलती है कि आपके ऐप्लिकेशन में क्या हो रहा है. जैसे, उपयोगकर्ता की कार्रवाइयां, सिस्टम में होने वाले इवेंट या गड़बड़ियां.

Analytics आपके लिए कुछ इवेंट अपने-आप लॉग करता है. इन्हें पाने के लिए, आपको कोई कोड जोड़ने की ज़रूरत नहीं है. अगर आपके ऐप्लिकेशन को अतिरिक्त डेटा इकट्ठा करने की ज़रूरत है, तो अपने ऐप्लिकेशन में ज़्यादा से ज़्यादा 500 अलग-अलग Analytics इवेंट टाइप लॉग किए जा सकते हैं. आपके ऐप्लिकेशन के लॉग किए गए इवेंट के कुल वॉल्यूम की कोई सीमा नहीं है. ध्यान दें कि इवेंट के नाम, केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होते हैं. अगर एक ही नाम के दो इवेंट लॉग किए जाते हैं और उनमें से एक इवेंट के नाम में अलग छोटे-बड़े अक्षरों का इस्तेमाल हुआ है, तो उसे अलग इवेंट माना जाएगा.

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

पक्का करें कि आपने अपना प्रोजेक्ट सेट अप कर लिया हो और Analytics को ऐक्सेस किया जा सकता हो. इसके बारे में Analytics का इस्तेमाल शुरू करना लेख में बताया गया है.

लॉग इवेंट

FirebaseApp इंस्टेंस को कॉन्फ़िगर करने के बाद, logEvent() तरीके का इस्तेमाल करके इवेंट लॉग किए जा सकते हैं.

शुरू करने में आपकी मदद करने के लिए, Analytics एसडीके टूल में सुझाए गए कई इवेंट तय किए गए हैं. ये इवेंट, अलग-अलग तरह के ऐप्लिकेशन में सामान्य तौर पर इस्तेमाल किए जाते हैं. इनमें खुदरा और ई-कॉमर्स, यात्रा, और गेमिंग ऐप्लिकेशन शामिल हैं. इन इवेंट के बारे में ज़्यादा जानने के लिए और इनका इस्तेमाल कब करना चाहिए, सुझाए गए इवेंट देखें.

आपको Swift और Objective-C के लिए, कॉन्स्टेंट के रेफ़रंस में लागू करने से जुड़ी जानकारी मिल सकती है.

यहां दिए गए उदाहरण में, सुझाया गया kFIRSelectContent इवेंट लॉग करने का तरीका बताया गया है:

Swift

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

Objective-C

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

पहले से तय किए गए पैरामीटर के अलावा, किसी भी इवेंट में ये पैरामीटर जोड़े जा सकते हैं:

  • कस्टम पैरामीटर: कस्टम पैरामीटर का इस्तेमाल Analytics रिपोर्ट में डाइमेंशन या मेट्रिक के तौर पर किया जा सकता है. कस्टम डाइमेंशन का इस्तेमाल, इवेंट पैरामीटर के ऐसे डेटा के लिए किया जा सकता है जो संख्यात्मक नहीं है. साथ ही, कस्टम मेट्रिक का इस्तेमाल, किसी भी पैरामीटर के ऐसे डेटा के लिए किया जा सकता है जिसे संख्या के तौर पर बेहतर तरीके से दिखाया जा सकता है. एसडीके का इस्तेमाल करके कस्टम पैरामीटर लॉग करने के बाद, डाइमेंशन या मेट्रिक को रजिस्टर करें. इससे यह पक्का किया जा सकेगा कि ये कस्टम पैरामीटर, 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,
])
PatternTabBarController.swift

Objective-C

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

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

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 टूल के ज़रिए इवेंट लॉग करने की प्रोसेस को मॉनिटर किया जा सकता है. इससे यह पुष्टि करने में मदद मिलती है कि इवेंट सही तरीके से लॉग किए जा रहे हैं. इसमें अपने-आप और मैन्युअल तरीके से लॉग किए गए इवेंट, दोनों शामिल हैं.

Verbose logging को इस तरह चालू किया जा सकता है:

  1. Xcode में, Product > Scheme > Edit scheme... को चुनें
  2. बाईं ओर मौजूद मेन्यू से, Run को चुनें.
  3. Arguments टैब चुनें.
  4. Arguments Passed On Launch सेक्शन में, -FIRAnalyticsVerboseLoggingEnabled जोड़ें.

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

डैशबोर्ड में इवेंट देखना

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

इस डेटा को Firebase कंसोल में इवेंट डैशबोर्ड से ऐक्सेस किया जा सकता है. इस डैशबोर्ड में, इवेंट की रिपोर्ट दिखती हैं. ये रिपोर्ट, आपके ऐप्लिकेशन से लॉग किए गए हर अलग-अलग तरह के इवेंट के लिए अपने-आप जनरेट होती हैं.