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

प्लैटफ़ॉर्म चुनें: iOS+ Android Web Flutter Unity C++


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

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

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

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

अगर आपको कैंपेन एट्रिब्यूशन डेटा इकट्ठा करना है, तो अपने प्रोजेक्ट में AdSupport फ़्रेमवर्क जोड़ना न भूलें.

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

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

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

Google Analytics

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

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

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])

Objective-C

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

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

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

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])

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

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

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

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

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

Firebase कंसोल में, आप अपने इवेंट के बारे में इकट्ठा किए गए आंकड़े देख सकते हैं Analytics > Events डैशबोर्ड में.

इस डैशबोर्ड के बारे में ये बातें ध्यान रखें:

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

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