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

بعد إيقاف واجهة برمجة التطبيقات تسجيل الدخول باستخدام Google نهائيًا، سنزيل الإصدار v1 من حزمة تطوير البرامج (SDK) للألعاب في عام 2026. بعد فبراير 2025، لن يكون بإمكانك نشر الألعاب التي تم دمجها حديثًا مع الإصدار v1 من حزمة SDK للألعاب على Google Play. ننصحك باستخدام الإصدار v2 من حزمة SDK للألعاب بدلاً من ذلك.
مع أنّ التطبيقات الحالية التي تتضمّن عمليات الدمج السابقة للإصدار 1 من "خدمات ألعاب Google Play" ستستمر في العمل لعدّة سنوات، ننصحك بنقل البيانات إلى الإصدار 2 بدءًا من يونيو 2025.
هذا الدليل مخصّص لاستخدام الإصدار 1 من حزمة تطوير البرامج (SDK) الخاصة بـ "خدمات ألعاب Play". للحصول على معلومات حول أحدث إصدار من حزمة SDK، يُرجى الاطّلاع على مستندات الإصدار 2.

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

يوضّح لك هذا الدليل كيفية استخدام واجهة برمجة التطبيقات الخاصة بإحصاءات اللاعبين في الألعاب التي تستخدم خدمات ألعاب Google Play. يمكن العثور على واجهات برمجة التطبيقات في حزمتَي com.google.android.gms.games.stats وcom.google.android.gms.games.

قبل البدء

قبل البدء في استخدام واجهة برمجة التطبيقات لإحصاءات اللاعبين، يُرجى مراعاة ما يلي:

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

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

لبدء استخدام واجهة برمجة التطبيقات الخاصة بإحصاءات اللاعبين، يجب أن تحصل لعبتك أولاً على عنصر PlayerStatsClient. يمكنك إجراء ذلك من خلال استدعاء الطريقة Games.getPlayerStatsClient() وتمرير النشاط وGoogleSignInAccount للاعب الحالي. للتعرّف على كيفية استرداد معلومات حساب اللاعب، راجِع تسجيل الدخول في ألعاب Android.

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

يمكنك استخدام واجهة برمجة تطبيقات إحصاءات اللاعبين لاسترداد بيانات حول نشاط اللاعب داخل اللعبة. تشمل أنواع بيانات اللاعبين التي يمكنك استردادها ما يلي:

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

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

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

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

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

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

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

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

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

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

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

public void checkPlayerStats() {
  Games.getPlayerStatsClient(this, GoogleSignIn.getLastSignedInAccount(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 تحديد أنواع مختلفة من اللاعبين بسهولة، استنادًا إلى مستوى تفاعلهم وسلوكهم في الإنفاق، وتطبيق الاستراتيجيات المناسبة لتحسين تجربة اللعب.

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