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

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

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

قبل البدء

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

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

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

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

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

  • متوسط مدة الجلسة: متوسط مدة جلسة التشغيل بالدقائق. يتم تحديد مدة الجلسة عن طريق تسجيل دخول اللاعب إلى خدمات ألعاب Google Play.

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

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

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

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

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

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

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

يسرد الجدول التالي بعض نماذج شرائح اللاعبين وإستراتيجيات الجذب المقترحة:

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