Method: stats.get
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Trả về số liệu thống kê về mức độ tương tác và chi tiêu trong ứng dụng này cho người dùng hiện đã được xác thực.
Yêu cầu HTTP
GET https://games.googleapis.com/games/v1/stats
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Tài nguyên số liệu thống kê của bên thứ ba.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng 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
} |
| Trường |
churn_probability |
number
Xác suất người chơi không quay lại để chơi trò chơi đó vào ngày tiếp theo. Ví dụ: 0, 0,1, 0,5, ..., 1.0. Không được điền nếu không đủ thông tin.
|
num_purchases |
integer
Số giao dịch mua hàng trong ứng dụng mà người chơi đã thực hiện trong trò chơi này. Ví dụ: 0, 1, 5, 10, ... . Không được điền nếu không đủ thông tin.
|
spend_percentile |
number
Phân vị chi tiêu gần đúng của người chơi trong trò chơi này. Ví dụ: 0; 0, 25; 0, 5; 0, 75. Không được điền nếu không đủ thông tin.
|
days_since_last_played |
integer
Số ngày kể từ lần gần nhất người chơi chơi trò chơi này. Ví dụ: 0, 1, 5, 10, ... . Không được điền nếu không đủ thông tin.
|
num_sessions |
integer
Số phiên ước tính của người chơi trong vòng 28 ngày qua, trong đó phiên bắt đầu khi người chơi kết nối với Dịch vụ trò chơi của Play và kết thúc khi họ bị ngắt kết nối. Ví dụ: 0, 1, 5, 10, ... . Không được điền nếu không đủ thông tin.
|
num_sessions_percentile |
number
Giá trị ước tính số phần trăm phiên của người chơi trong vòng 30 ngày qua, trong đó phiên bắt đầu khi người chơi kết nối với Dịch vụ trò chơi của Play và kết thúc khi họ bị ngắt kết nối. Ví dụ: 0; 0, 25; 0, 5; 0, 75. Không được điền nếu không đủ thông tin.
|
avg_session_length_minutes |
number
Thời lượng phiên trung bình tính bằng phút của người chơi. Ví dụ: 1, 30, 60, ... . Không được điền nếu không đủ thông tin.
|
spend_probability |
number
Xác suất người chơi sẽ chơi trò chơi này trong 7 ngày tới. Ví dụ: 0; 0, 25; 0, 50; 0, 75. Không được điền nếu không đủ thông tin.
|
high_spender_probability |
number
Xác suất người chơi sẽ chi tiêu vượt quá ngưỡng. Ví dụ: 0; 0, 25; 0, 50; 0, 75. Không được điền nếu không đủ thông tin.
|
total_spend_next_28_days |
number
Số tiền dự đoán mà người chơi sẽ chi tiêu trong 28 ngày tới. Ví dụ: 1, 30, 60, ... . Không được điền nếu không đủ thông tin.
|
kind |
string
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi games#statsResponse cố định.
|
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-07-27 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 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)."]]
