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


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

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

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

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

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

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

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

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

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 रिपोर्ट में, कस्टम पैरामीटर का इस्तेमाल डाइमेंशन या मेट्रिक के तौर पर किया जा सकता है. संख्याओं के बजाय किसी दूसरे फ़ॉर्मैट में मौजूद इवेंट पैरामीटर के डेटा के लिए, कस्टम डाइमेंशन का इस्तेमाल किया जा सकता है. साथ ही, संख्याओं के ज़रिए बेहतर तरीके से दिखाए गए किसी भी पैरामीटर के डेटा के लिए, कस्टम मेट्रिक का इस्तेमाल किया जा सकता है. 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,
])
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() वाले तरीके में कोई पैरामीटर दिया गया है, तो डिफ़ॉल्ट वैल्यू के बजाय उस वैल्यू का इस्तेमाल किया जाता है.

किसी डिफ़ॉल्ट पैरामीटर को हटाने के लिए, nil पर सेट किए गए पैरामीटर के साथ, setDefaultEventParameters तरीका कॉल करें.

Xcode डीबग कंसोल में इवेंट देखना

SDK टूल से इवेंट को लॉग करने की प्रक्रिया को मॉनिटर करने के लिए, ज़्यादा जानकारी वाली लॉगिंग की सुविधा चालू की जा सकती है. इससे यह पुष्टि करने में मदद मिलती है कि इवेंट सही तरीके से लॉग हो रहे हैं या नहीं. इसमें अपने-आप और मैन्युअल तरीके से लॉग किए गए इवेंट, दोनों शामिल हैं.

ज़्यादा जानकारी वाली लॉगिंग को इस तरह चालू किया जा सकता है:

  1. Xcode में, प्रॉडक्ट > स्कीम > स्कीम में बदलाव करें... चुनें
  2. बाईं ओर मौजूद मेन्यू से, चालू करें को चुनें.
  3. आर्ग्युमेंट टैब चुनें.
  4. लॉन्च के दौरान इस्तेमाल किए गए आर्ग्युमेंट सेक्शन में, -FIRAnalyticsVerboseLoggingEnabled जोड़ें.

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

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

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

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