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

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


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

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

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

Google Analytics का इस्तेमाल करने से पहले, आपको ये काम करने होंगे:

  • अपने Unity प्रोजेक्ट को रजिस्टर करें और उसे Firebase का इस्तेमाल करने के लिए कॉन्फ़िगर करें.

    • अगर आपका Unity प्रोजेक्ट पहले से ही Firebase का इस्तेमाल करता है, तो इसका मतलब है कि वह Firebase के लिए पहले से ही रजिस्टर और कॉन्फ़िगर किया गया है.

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

  • अपने Unity प्रोजेक्ट में, Firebase Unity SDK (खास तौर पर, FirebaseAnalytics.unitypackage) जोड़ें.

ध्यान दें कि अपने Unity प्रोजेक्ट में Firebase जोड़ने के लिए, आपको Firebase कंसोल और अपने खुले हुए Unity प्रोजेक्ट, दोनों में टास्क करने होंगे. उदाहरण के लिए, कंसोल से Firebase की कॉन्फ़िगरेशन फ़ाइलें डाउनलोड करें और फिर उन्हें अपने Unity प्रोजेक्ट में ले जाएं.

लॉग इवेंट

Firebase.Analytics.FirebaseAnalytics मॉड्यूल को शुरू करने के बाद, LogEvent() तरीके का इस्तेमाल करके इवेंट लॉग किए जा सकते हैं.

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

सुझाए गए इवेंट लागू करने के बारे में जानकारी, इन जगहों पर देखी जा सकती है:

  • सुझाए गए इवेंट: Event कॉन्सटेंट की सूची देखें.
  • तय किए गए पैरामीटर: Parameters कॉन्सटेंट की सूची देखें.

यहां दिए गए उदाहरण में, सुझाए गए SELECT_CONTENT इवेंट को लॉग करने का तरीका बताया गया है:

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

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

  • कस्टम पैरामीटर: कस्टम पैरामीटर, सीधे तौर पर आपकी Analytics रिपोर्ट में नहीं दिखाए जाते. हालांकि, इनका इस्तेमाल ऑडियंस की परिभाषाओं में फ़िल्टर के तौर पर किया जा सकता है. इन परिभाषाओं को हर रिपोर्ट पर लागू किया जा सकता है. अगर आपका ऐप्लिकेशन किसी BigQuery प्रोजेक्ट से लिंक है, तो BigQuery में एक्सपोर्ट किए गए डेटा में कस्टम पैरामीटर भी शामिल होते हैं.

  • VALUE पैरामीटर: VALUE एक सामान्य पैरामीटर है. यह किसी Analytics इवेंट से जुड़ी मुख्य मेट्रिक को इकट्ठा करने के लिए काम का है. उदाहरण के लिए, रेवेन्यू, दूरी, समय, और पॉइंट.

अगर आपके ऐप्लिकेशन की कुछ ऐसी ज़रूरतें हैं जो सुझाए गए Analytics इवेंट टाइप में शामिल नहीं हैं, तो आपके पास अपने कस्टम Analytics इवेंट लॉग करने का विकल्प है. इसके लिए, यह उदाहरण देखें:

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

लॉग आउटपुट में इवेंट देखना

iOS+

इवेंट, कंसोल में लॉग किए जाते हैं. साथ ही, XCode की मदद से ऐप्लिकेशन चलाते समय इन्हें देखा जा सकता है.

Android

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

वर्बोस लॉगिंग को adb कमांड की सीरीज़ की मदद से चालू किया जा सकता है:

adb shell setprop log.tag.FA VERBOSE
 
adb shell setprop log.tag.FA-SVC VERBOSE
 
adb logcat -v time -s FA FA-SVC

यह निर्देश, Android Studio के Logcat में आपके इवेंट दिखाता है. इससे आपको तुरंत यह पुष्टि करने में मदद मिलती है कि इवेंट भेजे जा रहे हैं.

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

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

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

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

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

डैशबोर्ड के बारे में ज़्यादा जानें.