تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك خدمة أحداث "ألعاب Google Play" جمع بيانات متراكمة
ينشئها اللاعبون أثناء اللعب وتخزينها في
خوادم Google لتحليلات الألعاب. يمكنك تحديد بيانات اللاعبين التي يجب أن تجمعها لعبتك بشكل مرن، وقد تشمل ذلك مقاييس مثل عدد المرات التي:
يستخدم اللاعبون سلعة معيّنة
بلوغ اللاعبين مستوى معيّنًا
ينفّذ اللاعبون بعض الإجراءات المحدّدة في اللعبة
يمكنك استخدام بيانات الأحداث كملاحظات حول كيفية تحسين لعبتك. على سبيل المثال، يمكنك تعديل مستوى صعوبة بعض المستويات في لعبتك التي يجد اللاعبون صعوبة في إكمالها.
للتعرّف على كيفية تنفيذ الأحداث لمنصّتك، اطّلِع على مقالة
عمليات تنفيذ العميل.
دمج الأحداث في لعبتك
يوضّح سير العمل التالي كيفية تطبيق الأحداث في
اللعبة:
تحديد الأحداث لتحديد أحداث جديدة لتسجيلها في لعبتك:
نفِّذ ميزة تسجيل الأحداث في لعبتك باستخدام واجهات برمجة تطبيقات الأحداث. على سبيل المثال، في رمز Android، يمكنك استدعاء طريقة events increment كلما رصدت لعبتك بدء حدث يهمّها.
عرض بيانات الأحداث انتقِل إلى صفحة الأحداث للعبة في
Google Play Console لعرض إحصاءات الأحداث التي تم تسجيلها.
أساسيات الأحداث
تمنحك واجهات برمجة تطبيقات الأحداث طريقة لتحديد ومقايسة ميزات اللعب المثيرة للاهتمام وتحميل هذه المقاييس إلى حزمة تطوير البرامج (SDK) لألعاب Play.
يحتوي حدث حزمة تطوير البرامج (SDK) لـ "ألعاب Play" على السمات الرئيسية التالية:
الخاصية
الوصف
الإندونيسية
سلسلة فريدة أنشأتها Google Play Console لهذا الحدث.
استخدِم هذا المعرّف الفريد للإشارة إلى الحدث في عملاء لعبتك.
الاسم
اسم مختصر للحدث يمكن أن يصل طول الاسم إلى 100 حرف.
تستخدم Google Play Console هذه القيمة ويمكن عرضها في
لعبتك.
أمثلة:
"عدد الزومبي الذين تم قتلهم"
"تم جمع الأحجار الكريمة الحمراء"
الوصف
وصف أطول للحدث (على سبيل المثال، "عدد المرات التي قتل فيها اللاعب زومبيًا" أو "إجمالي عدد الأحجار الكريمة الحمراء التي eliminated and matched اللاعب") يمكن أن يصل طول الوصف إلى 500 حرف.
تستخدم Google Play Console هذه القيمة ويمكن عرضها في لعبتك.
نوع الحدث
حقل يوضّح نوع البيانات التي يتتبّعها الحدث
تستخدم Google Play Console هذه القيمة لإتاحة إعداد تقارير "إحصاءات Google" لتطبيق Player.
يتوفّر نوعان من الأحداث:
مصدر عملات الميزات الإضافية في الألعاب
اختَر هذا النوع للأحداث التي تتبّع مصادر
العملة الإضافية داخل اللعبة. على سبيل المثال:
"عملات ذهبية تم كسبها"
"تم شراء زمرد"
خصم على عملات الميزات الإضافية في الألعاب
اختَر هذا النوع للأحداث التي تتبّع إنفاق العملات الإضافية داخل اللعبة التي يمكن شراؤها أو
استخدامها. على سبيل المثال:
"عملات ذهبية تم إنفاقها"
"الأحجار الكريمة المستخدَمة"
الرمز
رمز مربّع سيتم ربطه بحدثك
إنشاء حدث
لإنشاء حدث جديد للعبة، اتّبِع الخطوات التالية:
في Google Play Console،
انقر على رمز خدمات الألعاب على يمين الصفحة
وحدِّد إدخال لعبتك.
اختَر علامة التبويب الأحداث على يمين الصفحة، ثم انقر على الزر إضافة حدث.
املأ تفاصيل الحدث الذي تريد إنشاؤه.
انقر على حفظ. في حال عدم حدوث أي أخطاء، يتم وضع الحدث في الحالة
"جاهز للنشر". يمكنك الآن المتابعة إلى مرحلة
نشر التغييرات في لعبتك.
تعديل حدث
لتعديل حدث أنشأته:
في Google Play Console،
افتح علامة التبويب الأحداث واختَر
الإدخال الخاص بالحدث الذي تريد تعديله. من المفترض أن يظهر لك النموذج نفسه الذي استخدمته
عند إنشاء الحدث.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Events\n\nThe Google Play Games events service allows you to collect cumulative\ndata generated by your players during gameplay and store them in Google's\nservers for game analytics. You can flexibly define what player data your game\nshould collect; this might include metrics such as how often:\n\n- Players use a particular item\n- Players reach a certain level\n- Players perform some specific game action\n\nYou can use the events data as feedback on how to improve your game. For\nexample, you can adjust the difficulty level of certain levels in your game\nthat players are finding too hard to complete.\n\nTo learn how to implement events for your platform, see\n[Client implementations](#implement-event).\n\nIntegrate events in your game\n-----------------------------\n\nThe following workflow describes how you can apply events in your\ngame:\n\n1. **Define events** . To define new events to capture in your game:\n 1. Go to the *Events* page for your game in the [Google Play Console](//play.google.com/apps/publish/).\n 2. Click the *Add new event* button and configure the [event properties](#event-basics).\n 3. Publish your event definitions by following the steps described in [Publishing your game changes](/games/pgs/console/publish).\n2. **Implement event capturing in your game using the events APIs** . For\n example, in your Android code, call the events `increment` method whenever\n your game detects that an event that it cares about has been triggered.\n\n | **Note:** On mobile clients, Play Games SDK updates events in batches, so you will see cumulative, rather than fine-grained, changes to your events. When using the REST API, implement your own batching to avoid sending event updates too frequently, as this might cause you to quickly exceed your [rate limits](/games/pgs/quota).\n3. **View events data** . Go to the *Events* page for your game in\n Google Play Console to view statistics for the captured events.\n\nEvent basics\n------------\n\nThe events APIs provide you with a way to define and collect interesting gameplay\nmetrics and upload these metrics to Play Games SDK.\n\nA Play Games SDK event contains these key properties:\n\n| Property | Description |\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **ID** | A unique string generated by Google Play Console for this event. Use this unique ID to refer to the event in your game clients. |\n| **Name** | A short name of the event. The name can be up to 100 characters. This value is used by Google Play Console and can be displayed in your game. Examples: - *\"Zombies Killed\"* - *\"Red Gems Collected\"* |\n| **Description** | A longer description of the event (for example, \"Number of times a player has killed a zombie\" or \"The total number of red gems the player has eliminated and matched\"). The description can be up to 500 characters. This value is used by Google Play Console and can be displayed in your game. |\n| **Event type** | A field that declares the type of data the event is tracking. This value is used by Google Play Console to support Player Analytics reporting. Two event types are supported: Premium currency source : Select this type for events that track sources of a premium currency. For example: - *\"Gold coins earned\"* - *\"Emeralds bought\"* Premium currency sink : Select this type for events that track sinks, or consumption, of a premium currency. For example: - *\"Gold coins spent\"* - *\"Emeralds used\"* \u003cbr /\u003e |\n| **Icon** | A square icon that will be associated with your event. |\n\n### Create an event\n\nTo create a new event for your game, follow these steps:\n\n1. In the [Google Play Console](https://play.google.com/apps/publish/), click the **Game services** icon on the left and select the entry for your game.\n2. Select the **Events** tab on the left, and click the **Add event** button.\n3. Fill in the details for the event you want to create.\n4. Click **Save** . If there are no errors, your event is placed in the \"Ready to publish\" state. You can now proceed to [publish your game changes](/games/pgs/console/publish).\n\n### Edit an event\n\nTo edit an event that you've created:\n\n1. In the [Google Play Console](https://play.google.com/apps/publish/), open the **Events** tab and select the entry for the event you want to edit. You should see the same form you used when creating the event.\n2. Make your edit changes.\n3. When you've finished editing the event, click the **Save** button.\n4. Test your game to verify the modified event. If it is working correctly, [republish your game changes](/games/pgs/console/publish).\n\n### Delete an event\n\nYou can delete events that are in draft state or that have been published. To\ndelete an event in Google Play Console, click the button labeled **Delete**\nat the bottom of the form for that event.\n\n### Reset event data\n\nYou can reset player progress data for testers of your events.\n\n- To reset draft events in Google Play Console, click the button labeled **Reset event progress** at the bottom of the form for that event.\n- To reset event data programmatically, call the [Management API `Events` methods](/games/services/management/api/events).\n\nClient implementations\n----------------------\n\nTo learn how to implement events for your platform, see the following resources:\n\n- [Android](/games/pgs/android/events)\n- [Web](/games/services/web/api/rest#rest-resource:-events)"]]
