إحصاءات اللاعبين لألعاب Android

يوضّح لك هذا الدليل كيفية استخدام واجهة برمجة التطبيقات Player stats API لخدمة "خدمات ألعاب Play". يمكنك استخدام واجهة برمجة التطبيقات Player stats API لاسترداد بيانات عن نشاط اللاعب داخل اللعبة.

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

يمكن العثور على واجهات برمجة التطبيقات في الحزم com.google.android.gms.games.stats وcom.google.android.gms.games.

قبل البدء

قبل بدء استخدام واجهة برمجة التطبيقات Player stats API:

• نزِّل نموذج الرمز البرمجي وراجِعه.
• اطّلِع على الاقتراحات الموضّحة في قائمة التحقّق من الجودة.

الحصول على عميل إحصاءات اللاعبين

لبدء استخدام واجهة برمجة التطبيقات Player stats API، يجب أن تحصل لعبتك أولاً على عنصر PlayerStatsClient. يمكنك إجراء ذلك من خلال استدعاء الأسلوب PlayerStatsClient.getPlayersClient() وإرسال النشاط.

تستخدِم فئة PlayerStatsClient فئة Task من "خدمات Google Play" لعرض النتائج بشكل غير متزامن. للاطّلاع على مزيد من المعلومات عن استخدام المهام لإدارة العمل المُدرَج في سلسلة محادثات، يُرجى الاطّلاع على دليل مطوّري Tasks API.

أساسيات إحصاءات اللاعبين

يمكنك استخدام واجهة برمجة التطبيقات Player stats API لاسترداد بيانات عن نشاط اللاعب داخل اللعبة. تشمل أنواع بيانات اللاعبين التي يمكنك استردادها ما يلي:

• متوسط مدة الجلسة: متوسط مدة جلسة المشغّل بال دقائق يتم تحديد مدة الجلسة حسب الوقت الذي يكون فيه اللاعب مسجِّلاً الدخول إلى "خدمات ألعاب Google Play".

• الأيام منذ آخر مرة تم فيها تشغيل اللعبة: العدد التقريبي للأيام التي مضت منذ المرة الأخيرة التي لعب فيها اللاعب

• عدد عمليات الشراء: العدد التقريبي لعمليات الشراء داخل التطبيق التي أجراها اللاعب

• عدد الجلسات: العدد التقريبي لجلسات اللاعب يتم تحديد الجلسات حسب عدد المرات التي يسجّل فيها اللاعب الدخول إلى "خدمات ألعاب Google Play".

• الشريحة المئوية للجلسة: التقريب الوارد في الشريحة المئوية للجلسات الخاصة باللاعب، ويتم تقديمه كقيمة عشرية تتراوح بين 0 و1. تشير هذه القيمة إلى عدد جلسات اللعب التي لعبها اللاعب الحالي مقارنةً بباقي قاعدة مستخدمي هذه اللعبة. تشير الأرقام الأعلى إلى أنّ هذا اللاعب قد لعب المزيد من الجلسات.

• النسبة المئوية للإنفاق: النسبة المئوية التقريبية للإنفاق الخاصة باللاعب، مقدَّمة كقيمة عشرية تتراوح بين 0 و1. تشير هذه القيمة إلى المبلغ الذي ينفقه اللاعب الحالي مقارنةً بباقي قاعدة مستخدمي هذه اللعبة. تشير الأرقام الأعلى إلى أنّ هذا اللاعب قد أنفق أكثر.

تم إيقاف الأنواع التالية من بيانات اللاعبين نهائيًا، وهي تُعرِض دائمًا قيمة ثابتة غير محدّدة:

استرداد بيانات إحصاءات اللاعبين

لاسترداد بيانات إحصاءات اللاعب الذي سجّل الدخول، اتّبِع الخطوات التالية:

1. استخدِم الطريقة PlayerStatsClient.loadPlayerStats().

2. في حال نجاح الطلب، تُرجع "خدمات ألعاب Google Play" ملفًا شخصيًا Task يحمِّل بشكل غير متزامن ملفًا شخصيًا PlayerStats. استخدِم طُرق هذا العنصر لاسترداد بيانات عن أنشطة اللاعب الذي سجّل الدخول في تطبيقك.

وفي ما يلي مثال لذلك:

public void checkPlayerStats() {
  PlayGames.getPlayerStatsClient(this)
      .loadPlayerStats(true)
      .addOnCompleteListener(new OnCompleteListener<AnnotatedData<PlayerStats>>() {
        @Override
        public void onComplete(@NonNull Task<AnnotatedData<PlayerStats>> task) {
          if (task.isSuccessful()) {
            // Check for cached data.
            if (task.getResult().isStale()) {
              Log.d(TAG, "using cached data");
            }
            PlayerStats stats = task.getResult().get();
            if (stats != null) {
              Log.d(TAG, "Player stats loaded");
              if (stats.getDaysSinceLastPlayed() > 7) {
                Log.d(TAG, "It's been longer than a week");
              }
              if (stats.getNumberOfSessions() > 1000) {
                Log.d(TAG, "Veteran player");
              }
              if (stats.getChurnProbability() == 1) {
                Log.d(TAG, "Player is at high risk of churn");
              }
            }
          } else {
            int status = CommonStatusCodes.DEVELOPER_ERROR;
            if (task.getException() instanceof ApiException) {
              status = ((ApiException) task.getException()).getStatusCode();
            }
            Log.d(TAG, "Failed to fetch Stats Data status: "
                + status + ": " + task.getException());
          }
        }
      });
}

نصائح لاستخدام بيانات إحصاءات اللاعبين

تتيح لك واجهة برمجة التطبيقات Play Stats API تحديد أنواع مختلفة من اللاعبين استنادًا إلى سلوك التفاعل والإنفاق، وتطبيق الاستراتيجيات المناسبة لتحسين تجربتهم في اللعبة.

يسرد الجدول التالي بعض الأمثلة على شرائح اللاعبين واستراتيجيات التفاعل المقترَحة: