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 Games Services ומסתיים כשהוא מנותק. למשל: 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.