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

प्लैटफ़ॉर्म चुनें:

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,
])
MigratedSnippets.swift

Objective-C

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

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

• कस्टम पैरामीटर: कस्टम पैरामीटर का इस्तेमाल डाइमेंशन या मेट्रिक के तौर पर 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,
])
MigratedSnippets.swift

Objective-C

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

इवेंट के डिफ़ॉल्ट पैरामीटर सेट करना

सभी इवेंट के लिए पैरामीटर लॉग किए जा सकते हैं.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 डीबग कंसोल के आउटपुट का इस्तेमाल करें.