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

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

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

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

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

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

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

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

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

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

लॉग इवेंट

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

शुरू करने में आपकी मदद करने के लिए, Analytics एसडीके टूल में सुझाए गए कई इवेंट तय किए गए हैं. ये इवेंट, अलग-अलग तरह के ऐप्लिकेशन में सामान्य तौर पर इस्तेमाल किए जाते हैं. इनमें खुदरा और ई-कॉमर्स, यात्रा, और गेमिंग ऐप्लिकेशन शामिल हैं. इन इवेंट के बारे में ज़्यादा जानने और इनका इस्तेमाल कब करना है, यह जानने के लिए 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);

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

Android

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

adb कमांड की मदद से, Verbose logging चालू की जा सकती है:

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 में आपके इवेंट दिखते हैं. इससे आपको यह तुरंत पुष्टि करने में मदद मिलती है कि इवेंट भेजे जा रहे हैं.

iOS+

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

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

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

Firebase कंसोल में यह डेटा ऐक्सेस करने के लिए:

  1. Firebase कंसोल में, अपना प्रोजेक्ट खोलें.
  2. Analytics रिपोर्टिंग डैशबोर्ड देखने के लिए, मेन्यू से Analytics चुनें.

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