با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
رویدادها بینشی در مورد آنچه در برنامه شما اتفاق می‌افتد، مانند اقدامات کاربر، رویدادهای سیستم یا خطاها ارائه می‌دهند.
Google Analytics به طور خودکار برخی رویدادها را برای شما ثبت می کند. برای دریافت آنها نیازی به افزودن کد ندارید. اگر برنامه شما نیاز به جمع آوری داده های اضافی دارد، می توانید تا 500 نوع رویداد Analytics مختلف را در برنامه خود ثبت کنید. هیچ محدودیتی در حجم کل رویدادهایی که برنامه شما ثبت می کند وجود ندارد. توجه داشته باشید که نام رویدادها به حروف بزرگ و کوچک حساس هستند و ثبت دو رویداد که نام آنها فقط در حروف بزرگ متفاوت است منجر به دو رویداد مجزا می شود.
پروژه Unity خود را ثبت کرده و آن را برای استفاده از Firebase پیکربندی کنید.
اگر پروژه Unity شما قبلاً از Firebase استفاده می‌کند، پس از قبل برای Firebase ثبت و پیکربندی شده است.
اگر پروژه یونیتی ندارید، می توانید یک برنامه نمونه دانلود کنید.
FirebaseUnity SDK (به طور خاص، FirebaseAnalytics.unitypackage ) را به پروژه Unity خود اضافه کنید.
توجه داشته باشید که افزودن Firebase به پروژه Unity شما شامل وظایفی در کنسول 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,newFirebase.Analytics.Parameter(Firebase.Analytics.FirebaseAnalytics.ParameterItemId,id),newFirebase.Analytics.Parameter(Firebase.Analytics.FirebaseAnalytics.ParameterItemName,"name"),newFirebase.Analytics.Parameter(Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod,"Google"),newFirebase.Analytics.Parameter("favorite_food",mFavoriteFood),newFirebase.Analytics.Parameter("user_id",mUserId));
علاوه بر پارامترهای تعیین شده، می توانید پارامترهای زیر را به هر رویداد اضافه کنید:
پارامترهای سفارشی: پارامترهای سفارشی مستقیماً در گزارش‌های Analytics شما نشان داده نمی‌شوند، اما می‌توانند به عنوان فیلتر در تعاریف مخاطب استفاده شوند که می‌توانند برای هر گزارش اعمال شوند. اگر برنامه شما به پروژه BigQuery مرتبط باشد، پارامترهای سفارشی نیز در داده‌های صادر شده به BigQuery گنجانده می‌شوند.
پارامتر VALUE : VALUE یک پارامتر با هدف کلی است که برای جمع آوری یک معیار کلیدی که مربوط به یک رویداد Analytics است مفید است. به عنوان مثال می توان به درآمد، مسافت، زمان و امتیاز اشاره کرد.
اگر برنامه شما نیازهای خاصی دارد که توسط یک نوع رویداد Analytics پیشنهادی پوشش داده نمی شود، می توانید رویدادهای Analytics سفارشی خود را همانطور که در این مثال نشان داده شده است ثبت کنید:
برای کمک به تأیید اینکه رویدادها به‌درستی توسط SDK ثبت می‌شوند، می‌توانید ثبت‌نام کامل را در گزارش اشکال‌زدایی Android Studio فعال کنید. این شامل رویدادهای ثبت شده به صورت خودکار و دستی می شود.
شما می‌توانید با یک سری دستورات adb، گزارش کامل را فعال کنید:
adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC
این دستور رویدادهای شما را در logcat اندروید استودیو نمایش می‌دهد و به شما کمک می‌کند فوراً تأیید کنید که رویدادها ارسال می‌شوند.
iOS+
رویدادها در کنسول ثبت می‌شوند و هنگام اجرای برنامه از طریق XCode قابل مشاهده هستند.
رویدادهای تجزیه و تحلیل را در داشبورد مشاهده کنید
می‌توانید آمار جمع‌آوری شده درباره رویدادهای Analytics خود را در داشبوردهای کنسول Firebase مشاهده کنید. این داشبوردها به صورت دوره ای در طول روز به روز می شوند. برای آزمایش فوری، از خروجی logcat همانطور که در بخش قبل توضیح داده شد استفاده کنید.
برای مشاهده داشبورد گزارش Analytics ، Analytics از منو انتخاب کنید.
برگه رویدادها گزارش‌های رویداد را نشان می‌دهد که به‌طور خودکار برای هر نوع متمایز رویداد Analytics ثبت‌شده توسط برنامه شما ایجاد می‌شوند. در مورد داشبورد بیشتر بخوانید.
تاریخ آخرین بهروزرسانی 2025-08-30 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-30 بهوقت ساعت هماهنگ جهانی."],[],[],null,["Events provide insight on what is happening in your app, such as user\nactions, system events, or errors.\n\nGoogle Analytics automatically logs some\n[events](https://support.google.com/analytics/answer/9234069) for you;\nyou don't need to add any code to receive them. If your app needs to collect\nadditional data, you can log up to 500 different Analytics event types\nin your app. There is no limit on the total volume of events your app logs.\nNote that event names are case-sensitive and that logging two events whose\nnames differ only in case results in two distinct events.\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\nAfter you have initialized the `Firebase.Analytics.FirebaseAnalytics` module,\nyou can use it to log events with the [`LogEvent()`](/docs/reference/unity/class/firebase/analytics/firebase-analytics#logevent) method.\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)\narticles in the Google Analytics Help Center.\n| **Note:** To get the maximum detail in reports, log the suggested Analytics Events that make sense for your app and their prescribed parameters. This also ensures that you benefit from the latest Google Analytics features as they become available.\n\nYou can find implementation details for recommended events in the following\nlocations:\n\n- Suggested events: see the list of [`Event`](/docs/reference/unity/class/firebase/analytics/firebase-analytics#eventaddpaymentinfo) constants.\n- Prescribed parameters: see the list of [`Parameters`](/docs/reference/unity/class/firebase/analytics/parameter) constants.\n\nThe following example demonstrates how to log a suggested\n[`SELECT_CONTENT`](/docs/reference/unity/class/firebase/analytics/firebase-analytics#eventselectcontent) Event: \n\n```c#\n // Log an event with multiple parameters, passed as an array:\n\nFirebase.Analytics.FirebaseAnalytics.LogEvent(\n Firebase.Analytics.FirebaseAnalytics.EventSelectContent,\n new Firebase.Analytics.Parameter(\n Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),\n new Firebase.Analytics.Parameter(\n Firebase.Analytics.FirebaseAnalytics.ParameterItemName, \"name\"),\n new Firebase.Analytics.Parameter(\n Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, \"Google\"),\n new Firebase.Analytics.Parameter(\n \"favorite_food\", mFavoriteFood),\n new Firebase.Analytics.Parameter(\n \"user_id\", mUserId)\n);\n```\n\nIn addition to the prescribed parameters, you can add the following parameters\nto any event:\n\n- Custom parameters: Custom parameters are not represented directly in your\n Analytics reports, but they can be used as filters in\n [Audience](https://support.google.com/firebase/answer/6317509) definitions that can be applied to every report. Custom\n parameters are also included in data [exported to BigQuery](https://support.google.com/firebase/answer/6318765) if\n your app is linked to a BigQuery project.\n\n- `VALUE` Parameter: `VALUE` is a general purpose [parameter](/docs/reference/unity/class/firebase/analytics/parameter)\n that is useful for accumulating a key metric that pertains to an\n Analytics Event. Examples include revenue, distance, time and points.\n\nIf your application has specific needs not covered by a suggested\nAnalytics Event type, you can log your own custom Analytics Events\nas shown in this example: \n\n```c#\nFirebase.Analytics.FirebaseAnalytics.LogEvent(\"custom_progress_event\", \"percent\", 0.4f);\n```\n\nView events in the log output \n\nAndroid\n\nYou can enable verbose logging in the Android Studio Debug Log, to help\nverify that events are being logged properly by the SDK.\nThis includes both automatically and manually logged events.\n\nYou can enable verbose logging with a series of adb commands:\n\n\u003cbr /\u003e\n\n```\nadb shell setprop log.tag.FA VERBOSE\n``` \n\n```\nadb shell setprop log.tag.FA-SVC VERBOSE\n``` \n\n```\nadb logcat -v time -s FA FA-SVC\n```\n\n\u003cbr /\u003e\n\nThis command displays your events in the Android Studio logcat, helping\nyou immediately verify that events are being sent.\n\niOS+\n\nEvents are logged to the console, and can be viewed while running the app\nthrough XCode.\n\nView analytics events in the dashboard\n\nYou can view aggregated statistics about your Analytics Events in the\nFirebase console dashboards. These dashboards update periodically\nthroughout the day. For immediate testing, use the logcat output as described in\nthe previous section.\n\nTo access this data in the Firebase console:\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)."]]
