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

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

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

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",
])
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() तरीके का इस्तेमाल करते हैं, तो डिफ़ॉल्ट के बजाय उस वैल्यू का इस्तेमाल किया जाता है.

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

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

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

आप इस तरह से वर्बोज़ लॉगिंग को सक्षम कर सकते हैं:

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

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

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

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

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