| प्लैटफ़ॉर्म चुनें: | iOS+ Android Web Flutter Unity C++ |
इवेंट से आपको यह इनसाइट मिलती है कि आपके ऐप्लिकेशन में क्या हो रहा है. जैसे, उपयोगकर्ता की कार्रवाइयां, सिस्टम में होने वाले इवेंट या गड़बड़ियां.
Analytics Analytics, कुछ इवेंट को आपके लिए अपने-आप लॉग करता है. इन्हें पाने के लिए, आपको कोई कोड जोड़ने की ज़रूरत नहीं होती. अगर आपके ऐप्लिकेशन को ज़्यादा डेटा इकट्ठा करना है, तो अपने ऐप्लिकेशन में अलग-अलग तरह के ज़्यादा से ज़्यादा 500 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 टूल से इवेंट लॉग करने की प्रोसेस को मॉनिटर करने के लिए, Verbose logging चालू किया जा सकता है. इससे यह पुष्टि करने में मदद मिलती है कि इवेंट सही तरीके से लॉग किए जा रहे हैं. इसमें, अपने-आप और मैन्युअल तरीके से लॉग किए गए इवेंट, दोनों शामिल हैं.
Verbose logging को इस तरह चालू किया जा सकता है:
- Xcode में, Product > Scheme > Edit scheme... को चुनें
- बाईं ओर मौजूद मेन्यू से, Run को चुनें.
- Arguments टैब को चुनें.
- Arguments Passed On Launch सेक्शन में,
-FIRAnalyticsVerboseLoggingEnabledजोड़ें.
अगली बार जब आप अपना ऐप्लिकेशन चलाएंगे, तो आपके इवेंट Xcode डीबग कंसोल में दिखेंगे. इससे आपको तुरंत यह पुष्टि करने में मदद मिलेगी कि इवेंट भेजे जा रहे हैं.
डैशबोर्ड में इवेंट देखना
Firebase कंसोल में, आप अपने इवेंट के बारे में इकट्ठा किए गए आंकड़े देख सकते हैं Analytics > Events डैशबोर्ड में.
इस डैशबोर्ड के बारे में ये बातें ध्यान रखें:
डैशबोर्ड में, इवेंट की रिपोर्ट दिखती हैं. ये रिपोर्ट, आपके ऐप्लिकेशन से लॉग किए गए हर अलग-अलग तरह के इवेंट के लिए अपने-आप बनती हैं.
डैशबोर्ड, दिन भर समय-समय पर अपडेट होता रहता है. तुरंत जांच करने के लिए, इस गाइड के पिछले सेक्शन में बताए गए तरीके से, Xcode डीबग कंसोल के आउटपुट का इस्तेमाल करें.