Method: stats.get

عرض إحصاءات التفاعل والإنفاق في هذا التطبيق للمستخدم الذي تمت مصادقته حاليًا.

طلب HTTP

GET https://games.googleapis.com/games/v1/stats

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

مورد إحصاءات تابع لجهة خارجية

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "churn_probability": number,
  "num_purchases": integer,
  "spend_percentile": number,
  "days_since_last_played": integer,
  "num_sessions": integer,
  "num_sessions_percentile": number,
  "avg_session_length_minutes": number,
  "spend_probability": number,
  "high_spender_probability": number,
  "total_spend_next_28_days": number,
  "kind": string
}
الحقول
churn_probability

number

احتمالية عدم عودة اللاعب لتشغيل اللعبة في اليوم التالي. على سبيل المثال: 0، 0.1، 0.5، ...، 1.0. لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.

num_purchases

integer

عدد عمليات الشراء داخل التطبيق التي أجراها اللاعب في هذه اللعبة على سبيل المثال: 0، 1، 5، 10، ... . لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.

spend_percentile

number

النسبة المئوية التقريبية للإنفاق للاعب في هذه اللعبة على سبيل المثال: 0، 0.25، 0.5، 0.75. لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.

days_since_last_played

integer

عدد الأيام التي مرّت منذ آخر مرة لعب فيها اللاعب هذه اللعبة. على سبيل المثال: 0، 1، 5، 10، ... . لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.

num_sessions

integer

العدد التقريبي لجلسات اللاعب خلال آخر 28 يومًا، حيث تبدأ الجلسة عندما يكون اللاعب متصلاً بخدمات ألعاب Play وتنتهي عندما يكون غير متصل بالإنترنت. على سبيل المثال: 0، 1، 5، 10، ... . لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.

num_sessions_percentile

number

يشير ذلك إلى القيمة التقريبية للجلسات بالنسبة إلى اللاعب خلال آخر 30 يومًا، حيث تبدأ الجلسة عندما يكون اللاعب متصلاً بخدمات ألعاب Play وتنتهي عند عدم اتصاله بالإنترنت. على سبيل المثال: 0، 0.25، 0.5، 0.75. لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.

avg_session_length_minutes

number

متوسط مدة الجلسة بالدقائق للمشغّل على سبيل المثال: 1، 30، 60، ... . لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.

spend_probability

number

احتمالية أن ينفق اللاعب اللعبة خلال الأيام السبعة المقبلة. على سبيل المثال: 0، 0.25، 0.50، 0.75. لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.

high_spender_probability

number

احتمالية أن ينفق اللاعب مبلغ أكبر من الحدّ الأدنى من المال. على سبيل المثال: 0، 0.25، 0.50، 0.75. لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.

total_spend_next_28_days

number

المبلغ المتوقع الذي سينفقه اللاعب خلال الأيام الـ 28 المقبلة. على سبيل المثال: 1، 30، 60، ... . لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.

kind

string

تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة games#statsResponse.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.