Tích hợp số liệu thống kê trò chơi

Tài liệu này giải thích cách tích hợp số liệu thống kê trò chơi vào trò chơi bằng Google Play Console. Bài viết này đề cập đến các định dạng tệp CSV và ZIP cần thiết, đồng thời mô tả cách tạo, nhập và quản lý các tệp này.

Tạo sự kiện

Để tạo sự kiện cho trò chơi mới và chưa phát hành, hãy hoàn tất các bước sau:

  1. Tạo tệp CSV sự kiện PlayerGameEvent.csv
  2. Trong Google Play Console, hãy chọn một trò chơi.
  3. Trên trang Dịch vụ trò chơi của Play – Số liệu thống kê trò chơi (Tăng số lượng người dùng > Dịch vụ trò chơi của Play > Thiết lập và quản lý > Số liệu thống kê trò chơi), hãy chọn Thiết lập sự kiện.
  4. Trong trang Cấu hình sự kiện, hãy thả tệp CSV để tải lên.
  5. Sau khi tạo một Sự kiện, bạn cần thiết lập số liệu thống kê

Thiết lập số liệu thống kê

Sau khi tạo sự kiện, bạn cần thiết lập số liệu thống kê:

  1. Tạo tệp ZIP chứa số liệu thống kê, nội dung bản địa hoá và tệp biểu tượng Nguyên tắc về tệp ZIP cho số liệu thống kê.
  2. Trong Google Play Console, hãy chọn một trò chơi.
  3. Trên trang Dịch vụ trò chơi của Play – Số liệu thống kê trò chơi (Tăng số lượng người dùng > Dịch vụ trò chơi của Play > Thiết lập và quản lý > Số liệu thống kê trò chơi), hãy chọn Thiết lập số liệu thống kê.
  4. Trên trang Cấu hình số liệu thống kê trò chơi, hãy thả Tệp ZIP để tải lên.
  5. Sau khi tải tất cả số liệu thống kê lên, bạn có thể phát hành trò chơi.

Số liệu thống kê trò chơi thử nghiệm

Để xác minh rằng số liệu thống kê trò chơi hoạt động như dự kiến, hãy làm theo các bước sau để kiểm thử:

  • Thiết lập một kênh thử nghiệm nội bộ.
  • Thêm tài khoản thử nghiệm vào dự án trò chơi cho người thử nghiệm.
  • Tạo hồ sơ Dịch vụ trò chơi của Play cho một trong các tài khoản kiểm thử bằng Ứng dụng Play Games.
  • Mở trò chơi bằng chính tài khoản kiểm thử mà bạn đã dùng để tạo hồ sơ Dịch vụ trò chơi của Play.
  • Xác minh rằng "Thông báo chào mừng" của Dịch vụ trò chơi của Play xuất hiện trên màn hình để xác nhận quá trình xác thực tự động thành công khi khởi chạy trò chơi.
  • Người dùng tài khoản kiểm thử có thể chơi trò chơi để kích hoạt các sự kiện. Kiểm tra phản hồi API để biết các sự kiện đã được ghi lại hay chưa.

Xuất bản số liệu thống kê trò chơi

Sau khi hoàn tất kiểm thử, bạn phải phát hành trò chơi. Tất cả sự kiện và số liệu thống kê của trò chơi sẽ được phát hành cùng với trò chơi đó.

Để xuất bản, hãy làm theo các bước sau:

  1. Trong Google Play Console, hãy chọn một trò chơi.
  2. Trên trang Dịch vụ trò chơi của Play – Số liệu thống kê trò chơi (Tăng số lượng người dùng > Dịch vụ trò chơi của Play > Thiết lập và quản lý > Số liệu thống kê trò chơi), hãy nhấp vào Xem xét và xuất bản.
  3. Trên trang Dịch vụ trò chơi của Play – Phát hành (Tăng số lượng người dùng > Dịch vụ trò chơi của Play > Thiết lập và quản lý > Phát hành), hãy xem xét các hành động và khắc phục vấn đề.
  4. Nhấp vào Xuất bản. Tất cả Số liệu thống kê trò chơi của bạn đều được phát hành.

Xoá số liệu thống kê trò chơi

Sau khi số liệu thống kê trò chơi được xuất bản, bạn không thể xoá số liệu thống kê trò chơi.

Nguyên tắc về tệp CSV cho sự kiện

Hàng đầu tiên của tệp CSV là hàng tiêu đề. Bạn phải nhập các sự kiện bằng tệp CSV sự kiện, ví dụ: PlayerGameEvent.csv.

Định dạng PlayerGameEvent.csv

Tệp CSV chứa sự kiện đã khai báo và các thuộc tính của sự kiện đó dưới dạng các giá trị được phân tách bằng dấu phẩy theo thứ tự sau:

 Event Name,Property Name,Property Type

Nếu bạn gửi sự kiện progressUpdate cho progressionStat, hãy thêm một hàng cho sự kiện này. Sự kiện này phải chứa ít nhất một thuộc tính currentProgress thuộc loại INT hoặc STRING, cùng với mọi thuộc tính khác mà bạn muốn gửi.

Các trường này được mô tả trong bảng sau:

Tiêu đề cột CSV Bắt buộc hoặc tuỳ chọn Các giá trị được chấp nhận
Tên sự kiện Bắt buộc Tối đa 50 ký tự

Chỉ được chứa chữ cái, số và dấu gạch dưới.

Nếu bạn sử dụng tên sự kiện đặc biệt progressUpdate, thì tên này phải có một thuộc tính có tên là currentProgress thuộc loại INT64 hoặc STRING.
Tên thuộc tính Bắt buộc Tối đa 50 ký tự

Chỉ được chứa chữ cái, số và dấu gạch dưới.

Riêng biệt theo từng sự kiện: Tên thuộc tính phải riêng biệt trong cùng một sự kiện.

Không sử dụng các từ khoá dành riêng sau đây: id, count, key, value, where, from, and, or, true hoặc false.
Loại bất động sản Bắt buộc So khớp chuỗi enum phân biệt chữ hoa chữ thường với một trong các kiểu dữ liệu được hỗ trợ: INT64, DOUBLE, STRING, BOOL

Yêu cầu đối với tệp PlayerGameEvent.csv:

  • Tệp này hỗ trợ tối đa 20 tên sự kiện riêng biệt, với tối đa 20 thuộc tính cho mỗi sự kiện.
  • Nội dung tệp không được trống và phải có ít nhất 1 hàng.
Bảng ví dụ
Tên sự kiện Tên thuộc tính Loại bất động sản
matchCompleted thời lượng DOUBLE
matchCompleted mạng giết được INT64
matchCompleted isWinner BOOL
matchCompleted matchType STRING
itemCollected coinsAmount INT64
itemCollected weaponType STRING
progressUpdate currentProgress INT64

Nguyên tắc đối với tệp ZIP chứa số liệu thống kê

Bạn có thể nhập số liệu thống kê cùng lúc bằng tệp ZIP. Hãy tham khảo bảng để biết tên tệp chính xác cần sử dụng trong tệp ZIP:

Tên tệp Bắt buộc hoặc tuỳ chọn Các giá trị được chấp nhận
RepetitiveStatsConfig.csv Bắt buộc Số liệu thống kê lặp lại thể hiện những hành động thường xuyên xảy ra trong trò chơi mà người chơi thực hiện.
ProgressionStatConfig.csv Bắt buộc Thống kê tiến trình thể hiện tiến trình của người chơi trong một trò chơi.
StatLocalizations.csv Không bắt buộc Cung cấp bản dịch cho tên và nội dung mô tả của số liệu thống kê trò chơi.
Tệp biểu tượng Bắt buộc Biểu tượng ở định dạng PNG, JPEG hoặc JPG có kích thước 512 x 512.

Tệp ZIP phải đáp ứng các yêu cầu sau:

  • Giới hạn kích thước tệp ZIP: Tổng kích thước tối đa chưa nén là 10 MB.
  • Số lượng tệp tối đa: Tổng cộng tối đa 53 tệp (3 tệp CSV và 50 biểu tượng) trong tệp lưu trữ ZIP.
  • Giới hạn tối đa cho số liệu thống kê kết hợp: Tổng số liệu thống kê tối đa là 50 trên ProgressionStatConfig.csv và RepetitiveStatsConfig.csv.
  • Các tệp CSV được hỗ trợ: ProgressionStatConfig.csv, RepetitiveStatsConfig.csv và StatLocalizations.csv (không bắt buộc). Nếu bạn chỉ muốn tải số liệu thống kê về tiến trình lên, đừng đưa tệp CSV số liệu thống kê lặp lại vào tệp ZIP; nếu không, bảng điều khiển sẽ phát ra lỗi. Điều này cũng áp dụng nếu bạn chỉ muốn tải số liệu thống kê lặp lại lên.
  • Tệp hình ảnh biểu tượng: PNG (.png) hoặc JPEG (.jpg, .jpeg).
    • Tất cả biểu tượng được tham chiếu trong tệp CSV phải có trong thư mục gốc của tệp ZIP.
    • Tất cả tệp hình ảnh có trong tệp ZIP phải được tham chiếu bởi ít nhất một số liệu thống kê.
  • Cấu trúc thư mục: Tất cả tệp phải nằm ở thư mục gốc của tệp ZIP. Không được phép dùng thư mục con.

Định dạng RepetitiveStatsConfig.csv

Tệp CSV chứa sự kiện đã khai báo và các thuộc tính của sự kiện đó dưới dạng các giá trị được phân tách bằng dấu phẩy theo thứ tự sau:

Stat Id,Event Name,Event Property Name,Aggregation Type,Stat Display Name,Stat Description,Filter Property,Filter Operator,Filter Value,Is Competitive,Min limit,Max limit,Icon File Name,Good value direction,Unit

Các trường này được mô tả trong bảng sau:

Tiêu đề cột CSV Bắt buộc hoặc tuỳ chọn Các giá trị được chấp nhận
Mã số liệu thống kê Bắt buộc Tối đa 100 ký tự

Chỉ được chứa chữ cái, số và dấu gạch dưới. Phải là duy nhất trên tất cả các số liệu thống kê trong trò chơi.
Tên thuộc tính sự kiện Bắt buộc Tối đa 50 ký tự
Tên hiển thị của chỉ số Bắt buộc Tối đa 50 ký tự
Tên hiển thị mặc định cho chỉ số (ngôn ngữ mặc định). Phải là duy nhất trên các số liệu thống kê.
Nội dung mô tả về chỉ số Bắt buộc Tối đa 500 ký tự
Nội dung mô tả mặc định cho chỉ số.
Loại tổng hợp Bắt buộc Tối đa 50 ký tự
SUM, MAX, MIN, COUNT.
Lọc thuộc tính Không bắt buộc Tối đa 50 ký tự
Phải là Tên thuộc tính được xác định trong PlayerGameEvent.csv.
Toán tử bộ lọc Không bắt buộc =, !=, >, <, >=, <=
Toán tử so sánh bộ lọc.
Giá trị bộ lọc Không bắt buộc So với Thuộc tính bộ lọc. Giá trị bộ lọc phải là INT64, DOUBLE, BOOL, STRING.
Có tính cạnh tranh Bắt buộc true, false
Giới hạn tối thiểu Bắt buộc khi Is Competitive là true Điểm số tối thiểu được phép cho số liệu thống kê cạnh tranh.
Giới hạn tối đa Bắt buộc khi Is Competitive là true Điểm số tối đa cho phép đối với số liệu thống kê cạnh tranh.
Tên tệp biểu tượng Bắt buộc Tên tệp của hình ảnh biểu tượng có trong thư mục gốc của tệp ZIP. Không được trùng với tên tệp biểu tượng được dùng trong số liệu thống kê định kỳ.
Hướng giá trị tốt Bắt buộc Chỉ định xem giá trị cao hơn INCREASING hay giá trị thấp hơn DECREASING sẽ tốt hơn.
Đơn vị Không bắt buộc Đơn vị đo lường cho các giá trị số hoặc thời lượng thô. Ví dụ: KILOMETER, SECOND, PERCENTAGE, UNITLESS.

Trong trường hợp bạn không muốn sử dụng điều kiện lọc, hãy để trống ô.

Bảng ví dụ
Mã nhận dạng tiểu bang Tên sự kiện Tên thuộc tính Tổng hợp Tên hiển thị của chỉ số Nội dung mô tả về chỉ số Lọc tài sản (không bắt buộc) Bộ lọc toán tử (không bắt buộc) Giá trị bộ lọc (không bắt buộc) Có tính cạnh tranh minLimit maxLimit Tên tệp biểu tượng Số thứ tự Hướng giá trị tốt đơn vị
1 matchCompleted thời lượng TỐI ĐA Longest Match Survival Đây là thời gian sống sót của người chơi trong bất kỳ trận đấu nào isWinner = TRUE TRUE 0 50 stat1.png 1 Giảm đi giây
2 matchCompleted isWinner COUNT Số trận thắng Chỉ số này cho biết số trận đấu mà một người chơi đã thắng isWinner = TRUE TRUE 0 50 stat3.png 2 Tăng lên
3 matchCompleted mạng giết được SUM Số mạng giết được trong trận đấu 1 đấu 1 Số mạng hạ gục trong các trận đấu 1 vs 1 matchType = "1-on-1" FALSE stat4.png 4 Tăng lên
4 itemCollected coinsAmount SUM Tổng số vàng đã thu thập Người chơi thu thập xu khi chơi trong một trận đấu weaponType = "sword" FALSE stat2.png 3 Tăng lên

Định dạng ProgressionStatConfig.csv

Tệp csv chứa sự kiện đã khai báo và các thuộc tính của sự kiện đó dưới dạng giá trị được phân tách bằng dấu phẩy theo thứ tự sau:

Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit

Số liệu thống kê về tiến trình sẽ là số liệu thống kê đầu tiên mà người chơi nhìn thấy trong Hồ sơ người chơi.

Các trường này được mô tả trong bảng sau:

Tiêu đề cột CSV Bắt buộc hoặc tuỳ chọn Các giá trị được chấp nhận
Mã số liệu thống kê Bắt buộc Tối đa 100 ký tự

Chỉ được chứa chữ cái, số và dấu gạch dưới. Phải là duy nhất trên tất cả các số liệu thống kê trong trò chơi.
Tên sự kiện Bắt buộc Tối đa 50 ký tự

Phải tham chiếu đến Tên sự kiện được xác định trong định dạng PlayerGameEvent.csv.
Tên thuộc tính sự kiện Bắt buộc Tối đa 50 ký tự

Phải là Tên thuộc tính được xác định trong PlayerGameEvent.csv.
Tên hiển thị của chỉ số Bắt buộc Phải là một tên duy nhất.
Nội dung mô tả về chỉ số Bắt buộc Tối đa 50 ký tự
Nội dung mô tả mặc định cho số liệu thống kê.
Tên tệp biểu tượng Bắt buộc Tên tệp của hình ảnh biểu tượng có trong thư mục gốc của tệp ZIP. Không được trùng với tên tệp biểu tượng được dùng trong số liệu thống kê định kỳ.
Hướng giá trị tốt Bắt buộc Chỉ định xem giá trị cao hơn INCREASING hay giá trị thấp hơn DECREASING sẽ tốt hơn.
Đơn vị Không bắt buộc Đơn vị đo lường cho các giá trị số hoặc thời lượng thô. Ví dụ: KILOMETER, SECOND, PERCENTAGE, UNITLESS.
Bảng ví dụ
Stat ID Tên thuộc tính sự kiện Tên hiển thị của số liệu thống kê Nội dung mô tả chỉ số Tên tệp biểu tượng Hướng đi có giá trị
5 currentProgress Cấp độ Người chơi tích luỹ điểm kinh nghiệm bằng cách chơi các trận đấu và lên cấp. Level.png tăng lên

Định dạng StatLocalizations.csv

Tệp csv chứa sự kiện đã khai báo và các thuộc tính của sự kiện đó dưới dạng giá trị được phân tách bằng dấu phẩy theo thứ tự sau:

Stat Id,Stat Display Name,Locale,Localized Stat Display Name,Localized Stat Description

Các trường này được mô tả trong bảng sau:

Tiêu đề cột CSV Bắt buộc hoặc tuỳ chọn Các giá trị được chấp nhận
Mã số liệu thống kê Bắt buộc Tối đa 100 ký tự

Chỉ được chứa chữ cái, số và dấu gạch dưới. Phải là duy nhất trên tất cả các số liệu thống kê trong trò chơi.
Tên hiển thị của chỉ số Bắt buộc Phải là một tên duy nhất.
Ngôn ngữ Bắt buộc Mã ngôn ngữ (chẳng hạn như en-US).
Thêm bản dịch cho trò chơi trước khi chỉ định ngôn ngữ. Xin lưu ý rằng bạn không thể chỉ định ngôn ngữ mặc định.

Bạn có thể tìm thấy mã ngôn ngữ được hỗ trợ trong danh sách ngôn ngữ được hỗ trợ.
Tên hiển thị chỉ số được bản địa hoá Không bắt buộc Tối đa 50 ký tự. Tên hiển thị của chỉ số đã được dịch cho ngôn ngữ cụ thể.
Nội dung mô tả được bản địa hoá về số liệu thống kê Không bắt buộc Tối đa 500 ký tự. Nội dung mô tả được dịch về chỉ số cho ngôn ngữ đã chỉ định.
Bảng ví dụ
Stat ID Tên hiển thị của số liệu thống kê Mã ngôn ngữ Tên chỉ số theo ngôn ngữ địa phương (UTF-8) Nội dung mô tả chỉ số theo ngôn ngữ địa phương (UTF-8) 1 Longest Match Survival es Supervivencia más larga en partidos Esto denota el tiempo de supervivencia de una jugadora en cualquier partido. 1 Longest Match Survival fr Survie du match le plus long Cela indique la durée de survie d'un joueur dans n'importe quel match. 4 Tổng số vàng đã thu thập es Oro total recolectado La jugadora recoge monedas mientras juega en un partido 4 Tổng số vàng đã thu thập fr Hoặc tổng số tiền đã thu Le joueur collecte des pièces en jouant un match

Tệp biểu tượng

Các biểu tượng mà bạn tham chiếu trong tệp .csv phải tồn tại trong tệp lưu trữ zip hiện tại mà bạn nhập.

Các quy tắc xác thực biểu tượng là:

Thuộc tính xác thực Quy tắc / ràng buộc bắt buộc
Kích thước tệp tối đa Tối đa 1 MB (1.048.576 byte) cho mỗi tệp biểu tượng.
Kích thước Chính xác là 512 × 512 pixel (chiều rộng = 512, chiều cao = 512)
Tỷ lệ khung hình Tỷ lệ khung hình 1:1 (Tỷ lệ khung hình vuông)
Định dạng được phép PNG (.png) và JPEG (.jpg, .jpeg)
Vị trí trong tệp ZIP Phải nằm trong thư mục gốc của tệp ZIP.
Kiểm tra được tham chiếu Tất cả tên tệp biểu tượng được chỉ định trong cột Tên tệp biểu tượng phải có trong tệp ZIP.
Kiểm tra nội dung không có chủ sở hữu Tất cả tệp hình ảnh trong tệp ZIP phải được tham chiếu bởi ít nhất một số liệu thống kê.
Kiểm tra xung đột Tên tệp biểu tượng trong ProgressionStatConfig.csv không được xung đột với RepetitiveStatsConfig.csv.
Hình ảnh trùng lặp Các biểu tượng trùng lặp sẽ được gắn cờ.

Hướng dẫn về biểu tượng

Biểu tượng phải được tạo dưới dạng tệp PNG, JPEG hoặc JPG có tỷ lệ 512 x 512.

Tất cả các ngôn ngữ đều sử dụng cùng một biểu tượng, do đó bạn nên tránh thêm bất kỳ nội dung hoặc văn bản nào đã được bản địa hóa vào một biểu tượng.

Quy cách của đơn vị

Các cột Đơn vị kiểm soát cách định dạng và bản địa hoá các giá trị thống kê thô cho người chơi.

Thuộc tính số liệu thống kê bằng số (INT64, DOUBLE)

Giá trị đơn vị được phép Ví dụ về giá trị thô
(Trống) / UNITLESS / NONE 1234567
% / PERCENTAGE / PERCENT 0,857
Khoảng cách/Độ dài: CENTIMETER, METER, KILOMETER, FOOT, INCH, MILE, YARD, MILLIMETER, NANOMETER 15 (KILOMETER)
Tốc độ: KILOMETER_PER_HOUR, METER_PER_SECOND, MILE_PER_HOUR 60 (MILE_PER_HOUR)

Thuộc tính số liệu thống kê không phải dạng số (STRING, BOOL)

Bạn phải để trống các cột đơn vị.