الأحداث

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

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

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

للتعرّف على كيفية تنفيذ الأحداث للنظام الأساسي، اطّلع على عمليات تنفيذ البرامج.

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

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

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

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

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

تزوّدك واجهات برمجة تطبيقات الأحداث بوسيلة لتحديد وتجميع مقاييس ممتعة لأسلوب اللعب، وتحميل هذه المقاييس إلى خدمات ألعاب Google Play.

يتضمن حدث خدمات ألعاب Google Play الخصائص الرئيسية التالية:

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

أمثلة:

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

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

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

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

الرمز رمز مربّع سيتم ربطه بالحدث.

إنشاء حدث

لإنشاء حدث جديد للعبتك، يُرجى اتباع الخطوات التالية:

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

تعديل حدث

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

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

حذف حدث

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

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

يمكنك إعادة تعيين بيانات تقدم اللاعب لمختبِري أحداثك.

  • لإعادة ضبط مسودات الأحداث في Google Play Console، انقر على الزر المُسمَّى إعادة ضبط تقدم الحدث في أسفل النموذج لذلك الحدث.
  • لإعادة تعيين بيانات الحدث برمجيًا، يمكنك استدعاء طرق Events لواجهة برمجة تطبيقات الإدارة.

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

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