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

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

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

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

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

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

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

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

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

शुरुआती सेटअप के इन टास्क के बारे में ज़्यादा जानकारी पाने के लिए, अपने Unity प्रोजेक्ट में Firebase जोड़ें लेख पढ़ें.

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

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

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

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

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

iOS+

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

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

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

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

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

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