الأحداث

تتيح لك خدمة الأحداث في "ألعاب Google Play" جمع البيانات التراكمية التي ينشئها اللاعبون أثناء اللعب وتخزينها في خوادم Google لإجراء إحصاءات الألعاب. يمكنك تحديد بيانات اللاعبين التي يجب أن تجمعها لعبتك بشكل مرن، وقد يشمل ذلك مقاييس مثل عدد المرات التي:

  • يستخدم اللاعبون عنصرًا معيّنًا
  • وصول اللاعبين إلى مستوى معيّن
  • ينفّذ اللاعبون بعض الإجراءات المحدّدة في اللعبة

يمكنك استخدام بيانات الأحداث كملاحظات حول كيفية تحسين لعبتك. على سبيل المثال، يمكنك تعديل مستوى صعوبة بعض المستويات في لعبتك التي يجد اللاعبون صعوبة في إكمالها.

للتعرّف على كيفية تنفيذ الأحداث على منصتك، اطّلِع على عمليات التنفيذ من جهة العميل.

دمج الأحداث في لعبتك

توضّح سير العمل التالي كيفية تطبيق الأحداث في لعبتك:

  1. تحديد الأحداث: لتحديد أحداث جديدة يتم تسجيلها في لعبتك، اتّبِع الخطوات التالية:
    1. انتقِل إلى صفحة الأحداث الخاصة بلعبتك في Google Play Console.
    2. انقر على الزر إضافة حدث جديد واضبط خصائص الحدث.
    3. انشر تعريفات الأحداث باتّباع الخطوات الموضّحة في مقالة نشر التغييرات التي أجريتها على لعبتك.

  2. تنفيذ عملية تسجيل الأحداث في لعبتك باستخدام واجهات برمجة التطبيقات للأحداث على سبيل المثال، في رمز Android، استخدِم طريقة increment للأحداث كلما رصدت لعبتك حدثًا يهمّها.

  3. عرض بيانات الأحداث انتقِل إلى صفحة الأحداث الخاصة بلعبتك في Google Play Console للاطّلاع على إحصاءات الأحداث التي تم تسجيلها.

أساسيات الأحداث

توفّر لك واجهات برمجة التطبيقات الخاصة بالأحداث طريقة لتحديد وجمع مقاييس شيّقة حول طريقة اللعب وتحميل هذه المقاييس إلى حزمة تطوير البرامج (SDK) الخاصة "بألعاب Play".

يحتوي حدث "حزمة تطوير البرامج (SDK) الخاصة بخدمات ألعاب Play" على الخصائص الرئيسية التالية:

الخاصية الوصف
الإندونيسية سلسلة فريدة تنشئها Google Play Console لهذا الحدث. استخدِم هذا المعرّف الفريد للإشارة إلى الحدث في برامج ألعابك.
الاسم اسم مختصر للحدث يمكن أن يصل طول الاسم إلى 100 حرف. تستخدم Google Play Console هذه القيمة ويمكن عرضها في لعبتك.

أمثلة:

  • "الزومبي الذين تم قتلهم"
  • "الجواهر الحمراء التي تم جمعها"
الوصف وصف أطول للحدث (على سبيل المثال، "عدد المرات التي قتل فيها اللاعب أحد الزومبي" أو "إجمالي عدد الجواهر الحمراء التي أزالها اللاعب وطابقها"). يمكن أن يصل طول الوصف إلى 500 حرف. تستخدم Google Play Console هذه القيمة ويمكن عرضها في لعبتك.
نوع الحدث

حقل يحدّد نوع البيانات التي يتتبّعها الحدث. تستخدم Google Play Console هذه القيمة للمساعدة في إعداد تقارير "إحصاءات اللاعبين".

يتوفّر نوعان من الأحداث:

مصدر عملات الميزات الإضافية في الألعاب
اختَر هذا النوع للأحداث التي تتتبّع مصادر العملات الإضافية داخل اللعبة. على سبيل المثال:
  • "العملات الذهبية المكتسبة"
  • "الزمرد الذي تم شراؤه"
خصم على عملات الميزات الإضافية في الألعاب
اختَر هذا النوع للأحداث التي تتتبّع عمليات إنفاق أو استهلاك العملات الإضافية داخل اللعبة التي يمكن شراؤها. على سبيل المثال:
  • "العملات الذهبية التي تم إنفاقها"
  • "الزمرد المستخدَم"
الرمز رمز مربّع سيتم ربطه بالحدث.

إنشاء حدث

لإنشاء حدث جديد في لعبتك، اتّبِع الخطوات التالية:

  1. في Google Play Console، انقر على رمز خدمات الألعاب على اليمين، ثم اختَر إدخال لعبتك.
  2. انقر على علامة التبويب الأحداث على يمين الصفحة، ثمّ انقر على الزرّ إضافة حدث.
  3. املأ تفاصيل الحدث الذي تريد إنشاءه.
  4. انقر على حفظ. إذا لم تكن هناك أخطاء، يتم وضع الحدث في الحالة "جاهز للنشر". يمكنك الآن المتابعة إلى نشر تغييرات لعبتك.

تعديل حدث

لتعديل حدث أنشأته، اتّبِع الخطوات التالية:

  1. في Google Play Console، افتح علامة التبويب الأحداث واختَر إدخال الحدث الذي تريد تعديله. سيظهر لك النموذج نفسه الذي استخدمته عند إنشاء الحدث.
  2. أدخِل التعديلات المطلوبة.
  3. عند الانتهاء من تعديل الحدث، انقر على زر حفظ.
  4. اختبِر لعبتك للتأكّد من الحدث المعدَّل. إذا كان يعمل بشكل صحيح، أعِد نشر التغييرات التي أجريتها على لعبتك.

حذف حدث

يمكنك حذف الأحداث التي تكون في حالة "مسوّدة" أو تم نشرها. لحذف حدث في Google Play Console، انقر على الزر حذف في أسفل نموذج هذا الحدث.

إعادة ضبط بيانات الحدث

يمكنك إعادة ضبط بيانات مستوى تقدّم اللاعبين الذين يختبرون أحداثك.

  • لإعادة ضبط أحداث المسودّة في Google Play Console، انقر على الزر إعادة ضبط مستوى تقدّم الحدث في أسفل نموذج هذا الحدث.
  • لإعادة ضبط بيانات الأحداث آليًا، استخدِم طرق Management API Events.

عمليات التنفيذ من جانب العميل

لمعرفة كيفية تنفيذ الأحداث على منصتك، اطّلِع على المراجع التالية: