تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تقدِّم الأحداث إحصاءات حول ما يحدث في تطبيقك، مثل إجراءات المستخدم أو أحداث النظام أو الأخطاء.
تسجّل Google Analytics بعض الأحداث تلقائيًا، ولا تحتاج إلى إضافة أي رمز لتلقّيها. إذا كان تطبيقك بحاجة إلى جمع بيانات إضافية، يمكنك تسجيل ما يصل إلى 500 نوع مختلف من Analytics الأحداث
في تطبيقك، بدون فرض حدّ أقصى للحجم الإجمالي للأحداث التي يسجّلها تطبيقك.
يُرجى العِلم أنّ أسماء الأحداث حسّاسة لحالة الأحرف، وأنّ تسجيل حدثَين يختلف اسم كل منهما عن الآخر في حالة الأحرف فقط يؤدّي إلى حدثَين مختلفَين.
سجِّل مشروع Unity الخاص بك وأعدَّه لاستخدام Firebase.
إذا كان مشروع Unity يستخدم Firebase، يكون قد تم تسجيله وإعداده لاستخدام Firebase.
إذا لم يكن لديك مشروع Unity، يمكنك تنزيل تطبيق نموذجي.
أضِف FirebaseUnity SDK (تحديدًا FirebaseAnalytics.unitypackage) إلى مشروع Unity.
يُرجى العِلم أنّ إضافة Firebase إلى مشروع Unity يتضمّن مهامًا في كل من
وحدة تحكّم Firebase ومشروع Unity المفتوح (على سبيل المثال، يمكنك تنزيل ملفات إعداد Firebase من وحدة التحكّم، ثم نقلها إلى مشروع Unity).
أحداث السجلّ
بعد إعداد وحدة Firebase.Analytics.FirebaseAnalytics،
يمكنك استخدامها لتسجيل الأحداث باستخدام طريقة LogEvent().
لمساعدتك في البدء، تحدّد حزمة تطوير البرامج (SDK) الخاصة بـ Analytics عددًا من الأحداث المقترَحة الشائعة بين أنواع مختلفة من التطبيقات، بما في ذلك تطبيقات البيع بالتجزئة والتجارة الإلكترونية والسفر والألعاب. لمزيد من المعلومات عن هذه الأحداث وحالات استخدامها، راجِع مقالات الأحداث المقترَحة في "مركز مساعدة إحصاءات Google".
يمكنك العثور على تفاصيل التنفيذ للأحداث المقترَحة في المواقع التالية:
الأحداث المقترَحة: اطّلِع على قائمة الثوابت 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: هي مَعلمة
عامة الأغراض ومفيدة لتجميع مقياس رئيسي ذي صلة Analytics بحدث.VALUE وتشمل الأمثلة الأرباح والمسافة والوقت والنقاط.
إذا كان تطبيقك يتضمّن احتياجات معيّنة لا يغطيها Analyticsنوع حدثAnalytics مقترَح، يمكنك تسجيل AnalyticsأحداثAnalytics مخصّصة خاصة بك كما هو موضّح في المثال التالي:
يمكنك تفعيل التسجيل المفصّل للأحداث في "سجلّ تصحيح الأخطاء" في 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
يعرض هذا الأمر أحداثك في Logcat في "استوديو Android"، ما يساعدك في التأكّد على الفور من أنّه يتم إرسال الأحداث.
iOS+
يتم تسجيل الأحداث في وحدة التحكّم، ويمكن عرضها أثناء تشغيل التطبيق
من خلال XCode.
عرض أحداث "إحصاءات Google" في لوحة البيانات
يمكنك عرض إحصاءات مجمّعة حول أحداث Analytics في لوحات بيانات وحدة التحكّم Firebase. يتم تعديل لوحات البيانات هذه بشكل دوري على مدار اليوم. لإجراء اختبار فوري، استخدِم ناتج logcat كما هو موضّح في القسم السابق.
للوصول إلى هذه البيانات في وحدة تحكّم Firebase، اتّبِع الخطوات التالية:
انقر على 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)."]]
