Số liệu thống kê về người chơi trong trò chơi Android

Tài liệu này sẽ hướng dẫn bạn cách sử dụng API thống kê số liệu về người chơi trong Dịch vụ trò chơi của Google Play. Bạn có thể sử dụng API thống kê số liệu về người chơi để truy xuất dữ liệu hoạt động của người chơi trong trò chơi.

API thống kê người chơi cho phép bạn điều chỉnh trải nghiệm trò chơi theo các phân khúc người chơi cụ thể và các giai đoạn khác nhau trong vòng đời người chơi. Bạn có thể xây dựng trải nghiệm phù hợp cho từng phân khúc người chơi dựa trên cách người chơi tiến bộ, chi trả và tương tác. Ví dụ: bạn có thể sử dụng API này để thực hiện các hành động chủ động nhằm khuyến khích người chơi giảm hoạt động tương tác với trò chơi của bạn, chẳng hạn như bằng cách hiển thị và quảng bá các vật phẩm mới khi người chơi đăng nhập.

Bạn có thể tìm thấy API trong các gói com.google.android.gms.games.statsvà com.google.android.gms.games.

Trước khi bắt đầu

Trước khi bạn bắt đầu sử dụng API số liệu thống kê về người chơi:

• Vui lòng tải và xem lại mã mẫu.
• Làm quen với những đề xuất được mô tả trong Danh mục kiểm tra chất lượng.

Tải ứng dụng số liệu thống kê về người chơi

Để bắt đầu sử dụng API số liệu thống kê về người chơi, trước tiên trò chơi của bạn phải có được một đối tượng PlayerStatsClient. Bạn có thể thực hiện việc này bằng cách gọi phương thức PlayerStatsClient.getPlayersClient() và truyền vào hoạt động.

Lớp PlayerStatsClient sử dụng lớp Task của Dịch vụ Google Play để trả về kết quả không đồng bộ. Để tìm hiểu thêm về cách sử dụng tác vụ quản lý các nhiệm vụ theo chuỗi, hãy xem Hướng dẫn dành cho nhà phát triển API Tác vụ.

Kiến thức cơ bản về số liệu thống kê của người chơi

Bạn có thể sử dụng API thống kê số liệu về người chơi để truy xuất dữ liệu về hoạt động của người chơi trong trò chơi. Bạn có thể truy xuất những loại dữ liệu người chơi sau:

• Thời lượng phiên trung bình: Thời lượng phiên trung bình của người chơi tính bằng phút. Thời lượng phiên được xác định theo thời gian mà người chơi đăng nhập vào dịch vụ Google Play Games.

• Số ngày kể từ lần chơi gần đây nhất: Số ngày ước tính kể từ lần chơi gần nhất của người chơi.

• Số giao dịch mua: Số lần mua hàng trong ứng dụng ước tính của người chơi.

• Số phiên: Số phiên ước tính của người chơi. Số phiên được xác định theo số lần người chơi đăng nhập vào các dịch vụ Google Play Games.

• Phần trăm phiên: Giá trị ước tính số phần trăm phiên của người chơi, được cung cấp dưới dạng một giá trị thập phân từ 0 đến 1. Giá trị này cho biết số phiên mà người chơi hiện tại đã chơi so với phần còn lại của cơ sở người chơi trong trò chơi này. Số cao hơn cho biết người chơi đã chơi nhiều phiên hơn.

• Phân vị chi tiêu: Phân vị chi tiêu ước tính của người chơi, được cung cấp dưới dạng một giá trị thập phân từ 0 đến 1. Giá trị này cho biết số tiền mà người chơi hiện tại đã chi tiêu so với phần còn lại của cơ sở người chơi trong trò chơi này. Số cao hơn cho biết người chơi này đã chi tiêu nhiều hơn.

Các loại dữ liệu sau đây của người chơi không được dùng nữa, và luôn trả về một hằng số giá trị không đặt được:

Truy xuất dữ liệu thống kê về người chơi

Để truy xuất dữ liệu thống kê về người chơi cho người chơi đã đăng nhập, hãy làm theo các bước sau:

1. Gọi phương thức PlayerStatsClient.loadPlayerStats().

2. Nếu cuộc gọi thành công, Dịch vụ trò chơi của Google Play sẽ trả về một đối tượng Task tải không đồng bộ đối tượng PlayerStats. Sử dụng các phương thức của đối tượng này để truy xuất dữ liệu về hoạt động của người chơi đã đăng nhập trong ứng dụng của bạn.

Ví dụ:

public void checkPlayerStats() {
  PlayGames.getPlayerStatsClient(this)
      .loadPlayerStats(true)
      .addOnCompleteListener(new OnCompleteListener<AnnotatedData<PlayerStats>>() {
        @Override
        public void onComplete(@NonNull Task<AnnotatedData<PlayerStats>> task) {
          if (task.isSuccessful()) {
            // Check for cached data.
            if (task.getResult().isStale()) {
              Log.d(TAG, "using cached data");
            }
            PlayerStats stats = task.getResult().get();
            if (stats != null) {
              Log.d(TAG, "Player stats loaded");
              if (stats.getDaysSinceLastPlayed() > 7) {
                Log.d(TAG, "It's been longer than a week");
              }
              if (stats.getNumberOfSessions() > 1000) {
                Log.d(TAG, "Veteran player");
              }
              if (stats.getChurnProbability() == 1) {
                Log.d(TAG, "Player is at high risk of churn");
              }
            }
          } else {
            int status = CommonStatusCodes.DEVELOPER_ERROR;
            if (task.getException() instanceof ApiException) {
              status = ((ApiException) task.getException()).getStatusCode();
            }
            Log.d(TAG, "Failed to fetch Stats Data status: "
                + status + ": " + task.getException());
          }
        }
      });
}

Mẹo sử dụng dữ liệu số liệu thống kê của người chơi

API Play Stats cho phép bạn xác định các kiểu người chơi khác nhau, dựa trên mức độ tương tác và chi tiêu của họ, đồng thời áp dụng các chiến lược phù hợp để nâng cao trải nghiệm của họ về trò chơi.

Bảng dưới đây sẽ liệt kê một số phân khúc người chơi mẫu và chiến lược tương tác được đề xuất: