Method: stats.get
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Restituisce le statistiche sul coinvolgimento e sulla spesa in questa applicazione per l'utente attualmente autenticato.
Richiesta HTTP
GET https://games.googleapis.com/games/v1/stats
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Una risorsa di statistiche di terze parti.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione 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
} |
| Campi |
churn_probability |
number
La probabilità che un giocatore non torni a giocare il giorno successivo. Ad es. 0, 0,1, 0,5, ..., 1,0. Non compilato se non sono disponibili informazioni sufficienti.
|
num_purchases |
integer
Numero di acquisti in-app effettuati dal giocatore in questo gioco. Ad es. 0, 1, 5, 10, ... . Non compilato se non sono disponibili informazioni sufficienti.
|
spend_percentile |
number
Il percentile di spesa approssimativo del giocatore in questo gioco. Ad es. 0, 0,25, 0,5, 0,75. Non compilato se non sono disponibili informazioni sufficienti.
|
days_since_last_played |
integer
Numero di giorni dall'ultima volta che il giocatore ha giocato a questa partita. Ad es. 0, 1, 5, 10, ... . Non compilato se non sono disponibili informazioni sufficienti.
|
num_sessions |
integer
Il numero approssimativo di sessioni del giocatore negli ultimi 28 giorni, in cui una sessione inizia quando il giocatore è connesso ai servizi per i giochi di Play e termina quando è disconnesso. Ad es. 0, 1, 5, 10, ... . Non compilato se non sono disponibili informazioni sufficienti.
|
num_sessions_percentile |
number
L'approssimazione del percentile delle sessioni del giocatore negli ultimi 30 giorni, in cui una sessione inizia quando il giocatore è connesso ai servizi per i giochi di Play e termina quando è disconnesso. Ad es. 0, 0,25, 0,5, 0,75. Non compilato se non sono disponibili informazioni sufficienti.
|
avg_session_length_minutes |
number
Durata media della sessione in minuti del player. Ad es. 1, 30, 60, ... . Non compilato se non sono disponibili informazioni sufficienti.
|
spend_probability |
number
La probabilità che il giocatore spenda la partita nei prossimi sette giorni. Ad es. 0, 0,25, 0,50, 0,75. Non compilato se non sono disponibili informazioni sufficienti.
|
high_spender_probability |
number
La probabilità che il giocatore spenda oltre una soglia di denaro. Ad es. 0, 0,25, 0,50, 0,75. Non compilato se non sono disponibili informazioni sufficienti.
|
total_spend_next_28_days |
number
La quantità di denaro prevista che il giocatore spenderà nei prossimi 28 giorni. Ad es. 1, 30, 60, ... . Non compilato se non sono disponibili informazioni sufficienti.
|
kind |
string
Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#statsResponse.
|
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[null,null,["Ultimo aggiornamento 2025-07-27 UTC."],[],[],null,["# Method: stats.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.PlayerStats.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns engagement and spend statistics in this application for the currently authenticated user.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/stats`\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA third party stats resource.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"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 } ``` |\n\n| Fields ||\n|------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `churn_probability` | `number` The probability of the player not returning to play the game in the next day. E.g., 0, 0.1, 0.5, ..., 1.0. Not populated if there is not enough information. |\n| `num_purchases` | `integer` Number of in-app purchases made by the player in this game. E.g., 0, 1, 5, 10, ... . Not populated if there is not enough information. |\n| `spend_percentile` | `number` The approximate spend percentile of the player in this game. E.g., 0, 0.25, 0.5, 0.75. Not populated if there is not enough information. |\n| `days_since_last_played` | `integer` Number of days since the player last played this game. E.g., 0, 1, 5, 10, ... . Not populated if there is not enough information. |\n| `num_sessions` | `integer` The approximate number of sessions of the player within the last 28 days, where a session begins when the player is connected to Play Games Services and ends when they are disconnected. E.g., 0, 1, 5, 10, ... . Not populated if there is not enough information. |\n| `num_sessions_percentile` | `number` The approximation of the sessions percentile of the player within the last 30 days, where a session begins when the player is connected to Play Games Services and ends when they are disconnected. E.g., 0, 0.25, 0.5, 0.75. Not populated if there is not enough information. |\n| `avg_session_length_minutes` | `number` Average session length in minutes of the player. E.g., 1, 30, 60, ... . Not populated if there is not enough information. |\n| `spend_probability` | `number` The probability of the player going to spend the game in the next seven days. E.g., 0, 0.25, 0.50, 0.75. Not populated if there is not enough information. |\n| `high_spender_probability` | `number` The probability of the player going to spend beyond a threshold amount of money. E.g., 0, 0.25, 0.50, 0.75. Not populated if there is not enough information. |\n| `total_spend_next_28_days` | `number` The predicted amount of money that the player going to spend in the next 28 days. E.g., 1, 30, 60, ... . Not populated if there is not enough information. |\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#statsResponse`. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/games`\n- `\n https://www.googleapis.com/auth/games_lite`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
