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

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

string

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

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

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

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