با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
Google Analytics داده های استفاده و رفتار برنامه شما را جمع آوری می کند. SDK دو نوع اصلی اطلاعات را ثبت می کند:
رویدادها: آنچه در برنامه شما اتفاق می افتد، مانند اقدامات کاربر، رویدادهای سیستم یا خطاها.
ویژگی های کاربر: ویژگی هایی که برای توصیف بخش هایی از پایگاه کاربر خود تعریف می کنید، مانند ترجیح زبان یا موقعیت جغرافیایی.
Analytics به طور خودکار برخی رویدادها و ویژگی های کاربر را ثبت می کند. برای فعال کردن آنها نیازی به اضافه کردن کد ندارید. اگر برنامه شما نیاز به جمع‌آوری داده‌های اضافی دارد، می‌توانید حداکثر 25 ویژگی کاربر Analytics مختلف را تنظیم کنید و تا 500 نوع رویداد Analytics مختلف را در برنامه خود ثبت کنید. هیچ محدودیتی در حجم کل رویدادهایی که برنامه شما ثبت می کند وجود ندارد.
برای مشاهده داشبورد گزارش Analytics ، Analytics از منو انتخاب کنید.
برگه رویدادها گزارش‌های رویداد را نشان می‌دهد که به‌طور خودکار برای هر نوع متمایز رویداد Analytics ثبت‌شده توسط برنامه شما ایجاد می‌شوند. در مورد داشبورد بیشتر بخوانید.
برای کمک به شروع، Analytics SDK تعدادی رویداد توصیه شده را تعریف می‌کند که در بین انواع مختلف برنامه‌ها، از جمله برنامه‌های خرده‌فروشی و تجارت الکترونیک، سفر، و بازی مشترک هستند. برای اطلاعات بیشتر درباره این رویدادها و زمان استفاده از آنها، به رویدادهای توصیه شده مراجعه کنید. برای دریافت حداکثر جزئیات در گزارش‌ها، رویدادهای پیشنهادی Analytics را که برای برنامه شما و پارامترهای تعیین‌شده آن معنا دارد، ثبت کنید. این همچنین تضمین می کند که از آخرین ویژگی های Google Analytics به محض در دسترس قرار گرفتن آنها بهره مند شوید.
پروژه Unity خود را ثبت کرده و آن را برای استفاده از Firebase پیکربندی کنید.
اگر پروژه Unity شما قبلاً از Firebase استفاده می‌کند، پس از قبل برای Firebase ثبت و پیکربندی شده است.
اگر پروژه یونیتی ندارید، می توانید یک برنامه نمونه دانلود کنید.
FirebaseUnity SDK (به طور خاص، FirebaseAnalytics.unitypackage ) را به پروژه Unity خود اضافه کنید.
توجه داشته باشید که افزودن Firebase به پروژه Unity شما شامل وظایفی در کنسول Firebase و پروژه Unity باز شما می شود (به عنوان مثال، فایل های پیکربندی Firebase را از کنسول دانلود می کنید، سپس آنها را به پروژه Unity خود منتقل می کنید).
ثبت رویدادها
شما می توانید بلافاصله با متد LogEvent() شروع به ثبت رویدادها کنید.
مثال زیر رویدادها را با انواع مختلفی از آرگومان ها ثبت می کند:
// Log an event with no parameters.Firebase.Analytics.FirebaseAnalytics.LogEvent(Firebase.Analytics.FirebaseAnalytics.EventLogin);// Log an event with a float parameterFirebase.Analytics.FirebaseAnalytics.LogEvent("progress","percent",0.4f);// Log an event with an int parameter.Firebase.Analytics.FirebaseAnalytics.LogEvent(Firebase.Analytics.FirebaseAnalytics.EventPostScore,Firebase.Analytics.FirebaseAnalytics.ParameterScore,42);// Log an event with a string parameter.Firebase.Analytics.FirebaseAnalytics.LogEvent(Firebase.Analytics.FirebaseAnalytics.EventJoinGroup,Firebase.Analytics.FirebaseAnalytics.ParameterGroupId,"spoon_welders");// Log an event with multiple parameters, passed as a struct:Firebase.Analytics.Parameter[]LevelUpParameters={newFirebase.Analytics.Parameter(Firebase.Analytics.FirebaseAnalytics.ParameterLevel,5),newFirebase.Analytics.Parameter(Firebase.Analytics.FirebaseAnalytics.ParameterCharacter,"mrspoon"),newFirebase.Analytics.Parameter("hit_accuracy",3.14f)};Firebase.Analytics.FirebaseAnalytics.LogEvent(Firebase.Analytics.FirebaseAnalytics.EventLevelUp,LevelUpParameters);
مراحل بعدی
بازخوانی داده های خود را به صورت دوره ای در کنسول Firebase مشاهده کنید.
تاریخ آخرین بهروزرسانی 2025-08-08 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-08 بهوقت ساعت هماهنگ جهانی."],[],[],null,["Google Analytics collects usage and behavior data for your app. The SDK\nlogs two primary types of information:\n\n- **Events:** What is happening in your app, such as user actions, system events, or errors.\n- **User properties:** Attributes you define to describe segments of your user base, such as language preference or geographic location.\n\nAnalytics automatically logs some\n[events](https://support.google.com/analytics/answer/9234069) and\n[user properties](https://support.google.com/analytics/answer/9268042);\nyou don't need to add any code to enable them. If your app needs to collect\nadditional data, you can set up to 25 different Analytics user properties\nand log up to 500 different Analytics event *types* in your app.\nThere is no limit on the total volume of events your app logs.\n\nTo access this data:\n\n1. In the [Firebase console](//console.firebase.google.com/), open your project.\n2. Select **Analytics** from the menu to view the Analytics reporting dashboard.\n\nThe **Events** tab shows the event reports that are\nautomatically created for each distinct type of Analytics event logged by\nyour app. Read more about the [dashboard](https://support.google.com/analytics/answer/11014767).\n\nTo help you get started, the Analytics SDK defines a number of\nrecommended events that are common among different types of apps, including\nretail and ecommerce, travel, and gaming apps. To learn more about these events\nand when to use them, see [Recommended events](https://support.google.com/analytics/answer/9267735).\nTo get the maximum detail in reports, log\nthe suggested Analytics events that make sense for your app and their\nprescribed parameters. This also ensures that you benefit from the latest\nGoogle Analytics features as they become available.\n\nBefore you begin\n\nBefore you can use\n[Google Analytics](/docs/reference/unity/namespace/firebase/analytics),\nyou need to:\n\n- Register your Unity project and configure it to use Firebase.\n\n - If your Unity project already uses Firebase, then it's already\n registered and configured for Firebase.\n\n - If you don't have a Unity project, you can download a\n [sample app](//github.com/google/mechahamster).\n\n- Add the [Firebase Unity SDK](/download/unity) (specifically, `FirebaseAnalytics.unitypackage`) to\n your Unity project.\n\n| **Find detailed instructions for these initial\n| setup tasks in\n| [Add Firebase to your Unity project](/docs/unity/setup#prerequisites).**\n\nNote that adding Firebase to your Unity project involves tasks both in the\n[Firebase console](//console.firebase.google.com/) and in your open Unity project\n(for example, you download Firebase config files from the console, then move\nthem into your Unity project).\n\nLog events\n\nYou can immediately begin to log events with the\n[`LogEvent()`](/docs/reference/unity/class/firebase/analytics/firebase-analytics#logevent) method.\n\nThe following example logs events with various types of arguments: \n\n```c#\n// Log an event with no parameters.\nFirebase.Analytics.FirebaseAnalytics\n .LogEvent(Firebase.Analytics.FirebaseAnalytics.EventLogin);\n\n// Log an event with a float parameter\nFirebase.Analytics.FirebaseAnalytics\n .LogEvent(\"progress\", \"percent\", 0.4f);\n\n// Log an event with an int parameter.\nFirebase.Analytics.FirebaseAnalytics\n .LogEvent(\n Firebase.Analytics.FirebaseAnalytics.EventPostScore,\n Firebase.Analytics.FirebaseAnalytics.ParameterScore,\n 42\n );\n\n// Log an event with a string parameter.\nFirebase.Analytics.FirebaseAnalytics\n .LogEvent(\n Firebase.Analytics.FirebaseAnalytics.EventJoinGroup,\n Firebase.Analytics.FirebaseAnalytics.ParameterGroupId,\n \"spoon_welders\"\n );\n\n// Log an event with multiple parameters, passed as a struct:\nFirebase.Analytics.Parameter[] LevelUpParameters = {\n new Firebase.Analytics.Parameter(\n Firebase.Analytics.FirebaseAnalytics.ParameterLevel, 5),\n new Firebase.Analytics.Parameter(\n Firebase.Analytics.FirebaseAnalytics.ParameterCharacter, \"mrspoon\"),\n new Firebase.Analytics.Parameter(\n \"hit_accuracy\", 3.14f)\n};\nFirebase.Analytics.FirebaseAnalytics.LogEvent(\n Firebase.Analytics.FirebaseAnalytics.EventLevelUp,\n LevelUpParameters);\n```\n| **Note:** After the property is registered, it can take up to 24 hours for data collected with the property to be included in reports. When the new data is available, the user property can be used as a report filter.\n\nNext Steps\n\n- See your data refresh periodically in the [Firebase console](//console.firebase.google.com/).\n- Explore the guides on [events](/docs/analytics/unity/events) and [user properties](/docs/analytics/unity/properties)."]]
