| प्लेटफ़ॉर्म चुनें: | iOS+ Android Web Flutter Unity C++ |
इवेंट से आपको यह इनसाइट मिलती है कि आपके ऐप्लिकेशन में क्या हो रहा है. जैसे, उपयोगकर्ता की कार्रवाइयां, सिस्टम में होने वाले इवेंट या गड़बड़ियां.
Analytics Analytics, कुछ इवेंट को आपके लिए अपने-आप लॉग करता है. इन्हें पाने के लिए, आपको कोई कोड जोड़ने की ज़रूरत नहीं होती. अगर आपके ऐप्लिकेशन को ज़्यादा डेटा इकट्ठा करना है, तो अपने ऐप्लिकेशन में अलग-अलग तरह के ज़्यादा से ज़्यादा 500 Analytics इवेंट टाइप लॉग किए जा सकते हैं. आपके ऐप्लिकेशन से लॉग किए जाने वाले इवेंट की कुल संख्या पर कोई पाबंदी नहीं है. ध्यान दें कि इवेंट के नाम केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होते हैं. अगर दो इवेंट के नाम भले ही एक जैसे हों, लेकिन केस-सेंसिटिव होने की वजह से उन्हें अलग-अलग इवेंट के तौर पर लिया जाएगा.
शुरू करने से पहले
पक्का करें कि आपने अपना प्रोजेक्ट सेट अप कर लिया हो और Analytics का ऐक्सेस पा लिया हो. इसके लिए, Get Started with Analytics लेख पढ़ें.
इवेंट लॉग करना
FirebaseApp इंस्टेंस को कॉन्फ़िगर करने के बाद, logEvent() तरीके से
इवेंट लॉग किए जा सकते हैं.
आपकी मदद करने के लिए, Analytics SDK टूल में सुझाए गए कई इवेंट तय किए गए हैं. ये इवेंट, अलग-अलग तरह के ऐप्लिकेशन में आम तौर पर इस्तेमाल किए जाते हैं. इनमें खुदरा और ई-कॉमर्स, ट्रैवल, और गेमिंग ऐप्लिकेशन शामिल हैं. इन इवेंट के बारे में ज़्यादा जानने और यह जानने के लिए कि इनका इस्तेमाल कब करना चाहिए, सुझाए गए इवेंट लेख पढ़ें.
Google AnalyticsSwift और 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 }];
तय किए गए पैरामीटर के अलावा, किसी भी इवेंट में ये पैरामीटर जोड़े जा सकते हैं:
कस्टम पैरामीटर: कस्टम पैरामीटर का इस्तेमाल डाइमेंशन या मेट्रिक के तौर पर Analytics रिपोर्ट में किया जा सकता है. नॉन-न्यूमेरिकल इवेंट पैरामीटर डेटा के लिए, कस्टम डाइमेंशन का इस्तेमाल किया जा सकता है. वहीं, किसी भी पैरामीटर डेटा के लिए कस्टम मेट्रिक का इस्तेमाल किया जा सकता है, जिसे न्यूमेरिक तौर पर बेहतर तरीके से दिखाया जा सकता है. SDK टूल का इस्तेमाल करके, कस्टम पैरामीटर लॉग करने के बाद, डाइमेंशन या मेट्रिक रजिस्टर करें. इससे यह पक्का किया जा सकेगा कि Analytics रिपोर्ट में ये कस्टम पैरामीटर दिख रहे हैं. ऐसा करने के लिए, Firebase कंसोल में Analytics > कस्टम डेफ़िनिशन पर जाएं.
ऑडियंस डेफ़िनिशन में कस्टम पैरामीटर का इस्तेमाल किया जा सकता है. इन डेफ़िनिशन को हर रिपोर्ट पर लागू किया जा सकता है. अगर आपका ऐप्लिकेशन, BigQuery प्रोजेक्ट से लिंक है, तो कस्टम पैरामीटर, BigQuery में एक्सपोर्ट किए गए डेटा में भी शामिल होते हैं. Google Analytics 4 BigQuery Export में, सैंपल क्वेरी और अन्य जानकारी देखें .
kFIRParameterValueपैरामीटर:kFIRParameterValueएक सामान्य मकसद वाला पैरामीटर है. यह किसी इवेंट से जुड़ी अहम मेट्रिक को इकट्ठा करने के लिए काम का है. उदाहरण के लिए, रेवेन्यू, दूरी, समय, और पॉइंट.
अगर आपके ऐप्लिकेशन की ज़रूरतें, सुझाए गए किसी इवेंट टाइप से पूरी नहीं होती हैं, तो अपने कस्टम इवेंट लॉग किए जा सकते हैं. जैसे, इस उदाहरण में दिखाया गया है:
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 टूल से इवेंट लॉग करने की प्रोसेस पर नज़र रखने के लिए, वर्बोस लॉगिंग को चालू किया जा सकता है. इससे यह पुष्टि करने में मदद मिलती है कि इवेंट सही तरीके से लॉग किए जा रहे हैं. इसमें, अपने-आप और मैन्युअल तरीके से लॉग किए गए, दोनों तरह के इवेंट शामिल हैं.
वर्बोस लॉगिंग को इस तरह चालू किया जा सकता है:
- Xcode में, Product > Scheme > Edit scheme... को चुनें
- बाईं ओर मौजूद मेन्यू से, Run को चुनें.
- Arguments टैब को चुनें.
- Arguments Passed On Launch सेक्शन में,
-FIRAnalyticsVerboseLoggingEnabledजोड़ें.
अगली बार जब आपका ऐप्लिकेशन चलेगा, तो आपके इवेंट, Xcode डीबग कंसोल में दिखेंगे. इससे आपको तुरंत यह पुष्टि करने में मदद मिलेगी कि इवेंट भेजे जा रहे हैं.
डैशबोर्ड में इवेंट देखना
Firebase कंसोल में, आप अपने इवेंट के बारे में इकट्ठा किए गए आंकड़े देख सकते हैं Analytics > Events डैशबोर्ड में.
इस डैशबोर्ड के बारे में ये बातें ध्यान रखें:
डैशबोर्ड में, इवेंट की रिपोर्ट दिखती हैं. ये रिपोर्ट, आपके ऐप्लिकेशन से लॉग किए गए हर अलग-अलग तरह के इवेंट के लिए अपने-आप बनती हैं.
डैशबोर्ड, दिन भर समय-समय पर अपडेट होता रहता है. तुरंत जांच करने के लिए, Xcode डीबग कंसोल के आउटपुट का इस्तेमाल करें. इसके लिए, इस गाइड का पिछला सेक्शन देखें.