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

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

ملاحظة مهمة: استنادًا إلى نتائج التجارب التي تم إجراؤها باستخدام واجهة برمجة التطبيقات هذه، توقّفنا عن ملء نقاط النهاية التالية: احتمال التوقّف عن استخدام التطبيق، واحتمال الإنفاق، وإجمالي الإنفاق خلال الـ 28 يومًا القادمة، واحتمال الإنفاق بمبلغ كبير. تعرض كل نقطة من نقاط النهاية هذه الآن قيمة ثابتة غير مضبوطة. هذه القيمة هي نفسها التي يستخدمها نظام "إحصاءات اللاعبين" للإشارة إلى عدم توفّر بيانات كافية لاحتساب نقطة نهاية معيّنة.

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

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

قبل البدء

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• احتمالية إيقاف الاستخدام: هي توقّع ما إذا كان اللاعب سيوقف الاستخدام في اليوم التالي، ويتم عرضها كقيمة عشرية تتراوح بين 0 (احتمالية منخفضة لإيقاف الاستخدام) و1 (احتمالية عالية لإيقاف الاستخدام) ضِمنًا. يتم تعريف معدّل التوقّف عن الاستخدام بأنّه 7 أيام من عدم النشاط.
• احتمالية الإنفاق: هي الاحتمالية التقريبية لاختيار اللاعب الإنفاق في هذه اللعبة، ويتم عرضها كقيمة عشرية تتراوح بين 0 (احتمالية منخفضة للإنفاق) و1 (احتمالية عالية للإنفاق)، ضِمنًا.
• إجمالي الإنفاق خلال الـ 28 يومًا القادمة: إجمالي الإنفاق المقدَّر للاعبين خلال الـ 28 يومًا القادمة في هذه اللعبة.
• احتمالية الإنفاق المرتفع: هي الاحتمالية التقريبية لأن ينفق أحد اللاعبين خلال الـ 28 يومًا التالية مبلغًا يقع في الشريحة المئوية الخامسة والتسعين أو أعلى من قاعدة اللاعبين في هذه اللعبة. يتم عرض هذا الاحتمال كقيمة عشرية تتراوح بين 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 تحديد أنواع مختلفة من اللاعبين بسهولة، استنادًا إلى مستوى تفاعلهم وسلوكهم في الإنفاق، وتطبيق الاستراتيجيات المناسبة لتحسين تجربة اللعب لديهم.

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

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