الأحداث

تسمح لك خدمة أحداث "ألعاب 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 لإتاحة إعداد تقارير "إحصاءات حول اللاعبين".

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

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

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

إنشاء حدث

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

  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 لواجهة برمجة تطبيقات الإدارة.

عمليات التنفيذ المتعلقة بالعملاء

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