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

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


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

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

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

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

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

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

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

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

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
                                 }];

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

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

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

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

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

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

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

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

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

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