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

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


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

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

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

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

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

वर्बोस लॉगिंग को चालू करने के लिए, यह तरीका अपनाएं:

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

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

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

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

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

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

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