الأحداث

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

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

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

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

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

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

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

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

  3. عرض بيانات الأحداث انتقِل إلى صفحة الأحداث للعبة في 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" لتطبيقك.

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

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

إنشاء حدث

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

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

تعديل حدث

لتعديل حدث أنشأته:

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

حذف حدث

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

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

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

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

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

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