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. Tài liệu này đề cập đến các định dạng tệp CSV và ZIP thiết yếu, đồng thời mô tả cách tạo, nhập và quản lý các định dạng này.
Tạo hoặc nhập sự kiện
Bạn có thể thêm sự kiện lần đầu tiên bằng Google Play Console theo hai cách:
- Tạo sự kiện: Thêm từng sự kiện một.
- Nhập sự kiện: Nhập nhiều sự kiện.
Tạo sự kiện
Để tạo một sự kiện cho trò chơi, hãy hoàn tất các bước sau:
- Trong Google Play Console, hãy chọn một trò chơi.
- 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 Thêm sự kiện > Tạo sự kiện.
- Trên trang Tạo sự kiện, hãy hoàn tất biểu mẫu.
- Nhấp vào Lưu thay đổi.
Nhập sự kiện
Để thêm nhiều sự kiện vào trò chơi cùng một lúc, hãy làm theo các bước sau:
- Tạo tệp CSV sự kiện PlayerGameEvent.csv.
- Trong Google Play Console, hãy chọn một trò chơi.
- 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 Thêm sự kiện > Nhập qua tệp CSV.
- Trên trang Cấu hình sự kiện, hãy thả tệp CSV để tải lên.
- Sau khi bạn tạo một sự kiện, hãy thiết lập số liệu thống kê.
Tạo hoặc nhập số liệu thống kê
Bạn có thể thêm số liệu thống kê lần đầu tiên bằng Google Play Console theo hai cách:
- Tạo số liệu thống kê: Thêm từng số liệu thống kê một.
- Nhập số liệu thống kê: Nhập nhiều số liệu thống kê.
Tạo số liệu thống kê
Để tạo một số liệu thống kê cho trò chơi, hãy hoàn tất các bước sau:
- Trong Google Play Console, hãy chọn một trò chơi.
- 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 Thêm số liệu thống kê > Tạo số liệu thống kê.
- Trên trang Tạo số liệu thống kê, hãy hoàn tất biểu mẫu.
- Nhấp vào Lưu thay đổi.
- Sau khi tạo một số liệu thống kê, hãy xuất bản trò chơi của bạn.
Số liệu thống kê về lượt nhập
Để nhập số liệu thống kê, hãy làm theo các bước sau:
- Tạo tệp ZIP chứa tệp số liệu thống kê, tệp bản dịch và tệp biểu tượng theo nguyên tắc về tệp ZIP cho số liệu thống kê.
- Trong Google Play Console, hãy chọn một trò chơi.
- 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 Thêm số liệu thống kê > Nhập qua tệp ZIP.
- 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.
- Sau khi bạn tải tất cả số liệu thống kê lên, hãy 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 để kiểm thử:
- Trong Play Console, hãy thiết lập một kênh thử nghiệm nội bộ.
- Thêm tài khoản kiểm thử vào dự án trò chơi cho người kiểm thử.
- 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 đã 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 việc 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 liệu các sự kiện đã được ghi lại hay chưa.
Quản lý chế độ hiển thị Số liệu thống kê về trò chơi trên thiết bị để kiểm thử
Sau khi trò chơi có sẵn cho người kiểm thử trong Play Console, hãy làm theo các bước sau để xem Số liệu thống kê về trò chơi trên thiết bị của bạn:
Xoá bộ nhớ đệm của Cửa hàng Google Play:
- Mở ứng dụng Cài đặt trên thiết bị của bạn.
- Nhấn vào Ứng dụng > Cửa hàng Google Play.
- Nhấn vào Bộ nhớ và bộ nhớ đệm, sau đó nhấn vào Xoá bộ nhớ đệm.
Mở ứng dụng Cửa hàng Google Play.
Xem số liệu thống kê về hoạt động chơi game của bạn bằng cách sử dụng phần Theo dõi thời gian chơi hoặc hồ sơ người chơi:
Cách 1: Sử dụng phần Theo dõi thời gian chơi
Chuyển đến phần Theo dõi thời gian chơi, rồi nhấn vào phần này để xem số liệu thống kê về hoạt động chơi game của bạn.
Cách 2: Sử dụng hồ sơ người chơi
- Nhấn vào thẻ Bạn, rồi nhấn vào hồ sơ người chơi của bạn.
- Chuyển đến phần Số liệu thống kê trò chơi.
- Đối với phạm vi thời gian, hãy chọn Tất cả.
- Nếu trò chơi của bạn không xuất hiện, hãy nhấn vào Xem tất cả trò chơi.
- Chọn trò chơi bạn muốn xem số liệu thống kê.
Xem nhật ký trên thiết bị
Để xác minh rằng số liệu thống kê trò chơi hoạt động như dự kiến, hãy bật nhật ký trên thiết bị của bạn:
Bật tính năng gỡ lỗi adb trên thiết bị của bạn và chạy các lệnh sau trong một cửa sổ dòng lệnh:
adb shell setprop log.tag.Games INFO adb logcat -s "PlayGamesServices[GameStatsAgent]:I"
Xác minh rằng một thông điệp nhật ký thành công xuất hiện, như trong ví dụ sau:
Successfully uploaded batch of X events.
Lưu ý: Vì API này hỗ trợ tải lên một phần, nên nhật ký thông tin này cho biết lô đã được xử lý. Nếu có bất kỳ sự kiện riêng lẻ nào trong lô không xác thực được lược đồ, thì nhật ký lỗi sẽ xuất hiện trước thông báo này.
Nếu có sự kiện nào được gửi không vượt qua quy trình xác thực, bạn sẽ thấy một thông báo lỗi nêu rõ lý do không thành công:
BatchRecordEvents validation failed for X event(s): ...
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:
- Trong Google Play Console, hãy chọn một trò chơi.
- 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.
- 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 đề.
- 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.
Chỉnh sửa số liệu thống kê trò chơi
Nếu bạn đã có số liệu thống kê trò chơi hiện có và muốn chỉnh sửa:
- Trong Google Play Console, hãy chọn một trò chơi.
- Chuyển đế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).
- Cách chỉnh sửa Sự kiện:
- Trong mục Cấu hình sự kiện, hãy chọn một sự kiện.
- Bạn có thể thêm hoặc xoá Thuộc tính sự kiện.
- Bạn không thể chỉnh sửa Tên sự kiện.
- Nhấp vào Lưu thay đổi.
- Cách chỉnh sửa Số liệu thống kê:
- Trong phần Cấu hình Thống kê trò chơi, hãy chọn một số liệu thống kê.
- Bạn có thể chỉnh sửa các trường Tên số liệu thống kê, Nội dung mô tả số liệu thống kê và Tên tệp biểu tượng.
- Bạn không thể chỉnh sửa Mã số liệu thống kê, Hướng tiến trình. Đơn vị thống kê và Thông tin chi tiết về sự kiện được liên kết.
- Nhấp vào Lưu thay đổi.
- Trên trang Dịch vụ trò chơi của Play – Số liệu thống kê trò chơi, số liệu thống kê đã chỉnh sửa có trạng thái Có sẵn cho người kiểm thử.
- Sau khi bạn kiểm thử chỉ số, hãy nhấp vào Xem lại và xuất bản. Thao tác này sẽ phát hành lại trò chơi của bạn, cùng với tất cả số liệu thống kê đã được cập nhật.
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á.
Bạn có thể xoá một Sự kiện hoặc Số liệu thống kê ở trạng thái Dành cho người kiểm thử.
- Trong Google Play Console, hãy chọn một trò chơi.
- Chuyển đế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).
- Cách xoá một Sự kiện:
- Trong mục Cấu hình sự kiện, hãy chọn một sự kiện.
- Nhấp vào Xoá sự kiện.
- Cách xoá Số liệu thống kê:
- Trong cấu hình Thống kê trò chơi , hãy chọn số liệu thống kê mà bạn muốn xoá.
- Nhấp vào Xoá số liệu thống kê về trận đấu.
Nguyên tắc đối với 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 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 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 |
| 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 cho mỗi 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: |
| 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 chưa nén tối đa 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ối đa 50 số liệu thống kê trên
ProgressionStatConfig.csvvàRepetitiveStatsConfig.csv. - Các tệp CSV được hỗ trợ:
ProgressionStatConfig.csv,RepetitiveStatsConfig.csvvàStatLocalizations.csv(không bắt buộc). Nếu chỉ muốn tải số liệu thống kê về tiến trình lên, đừng thêm 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 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ả 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ự |
| Tên hiển thị của số liệu thống kê | Bắt buộc | Tối đa 50 ký tự Tên hiển thị mặc định cho số liệu thống kê (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ề số liệu thống kê | Bắt buộc | Tối đa 500 ký tự Nội dung mô tả mặc định cho số liệu thống kê. |
| Loại tổng hợp | Bắt buộc | Tối đa 50 ký tự SUM, MAX, MIN, COUNT. |
| Lọc tài sản | 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ử 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 xung đột với tên tệp biểu tượng được dùng trong số liệu thống kê định kỳ. |
| Hướng dẫn về 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ị bằng số hoặc giá trị 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ã số liệu thống kê | Tên sự kiện | Tên thuộc tính | Tổng hợp | Tên hiển thị của số liệu thống kê | Nội dung mô tả về số liệu thống kê | Lọc tài sản (không bắt buộc) | Toán tử lọc (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 | Hướng dẫn về giá trị tốt | đơn vị |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | matchCompleted | thời lượng | TỐI ĐA | Longest Match Survival | Chỉ số này biểu thị 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 | Giảm đi | giây |
| 2 | matchCompleted | isWinner | COUNT | Số trận thắng | Đây là số trận đấu mà một người chơi đã thắng | isWinner | = | TRUE | TRUE | 0 | 50 | stat3.png | 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 | 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 | 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ủa họ.
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ả 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ự Phải là Tên thuộc tính được xác định trong PlayerGameEvent.csv. |
| Tên hiển thị của số liệu thống kê | Bắt buộc | Phải là một tên riêng biệt. |
| Nội dung mô tả về số liệu thống kê | Bắt buộc | Tối đa 50 ký tự Nội dung mô tả mặc định cho chỉ số. |
| 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 xung đột với tên tệp biểu tượng được dùng trong số liệu thống kê định kỳ. |
| Hướng dẫn về 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ị bằng số hoặc giá trị thời lượng thô. Ví dụ: KILOMETER, SECOND, PERCENTAGE, UNITLESS. |
Bảng ví dụ
| Mã số liệu thống kê | 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 giá trị tốt |
|---|---|---|---|---|---|
| 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ả số liệu thống kê trong trò chơi. |
| Tên hiển thị của số liệu thống kê | Bắt buộc | Phải là một tên riêng biệ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ị được bản địa hoá của số liệu thống kê | Không bắt buộc | Tối đa 50 ký tự. Tên hiển thị của số liệu thống kê đã dịch cho ngôn ngữ cụ thể. |
| Nội dung mô tả được bản địa hoá của 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ề số liệu thống kê cho ngôn ngữ đã cho. |
Bảng ví dụ
| Mã số liệu thống kê | Tên hiển thị của số liệu thống kê | Mã ngôn ngữ | Tên số liệu thống kê được bản địa hoá (UTF-8) | Nội dung mô tả được bản địa hoá của số liệu thống kê (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 / giới hạn thực thi |
|---|---|
| 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 | Chính xác là 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. |
| Quy trình 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 chỉ số. |
| 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 với nền trong suốt.
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ê dạng số (INT64, DOUBLE)
| Giá trị đơn vị được cho phép | Ví dụ về giá trị thô |
| (Trống) / KHÔNG CÓ ĐƠN VỊ / KHÔNG CÓ | 1234567 |
| % / PERCENTAGE / PERCENT | 0,857 |
| Khoảng cách/Độ dài: CENTIMET, MÉT, KILÔMÉT, BỘ, INCH, DẶM, YARD, MILIMÉT, NANÔMÉT | 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ê về thời lượng (DURATION)
| Giá trị danh mục định dạng | Giá trị đơn vị được cho phép | Ví dụ về giá trị thô | Ví dụ về đầu ra được định dạng |
| UNIT_BASED / DURATION | Bắt buộc: GIÂY, PHÚT, GIỜ, NGÀY, TUẦN, THÁNG, NĂM | 5.400 giây (GIỜ) | 1,5 giờ |
| COMPONENT_NUMERIC / HH:MM:SS / CLOCK | Độ chi tiết (Không bắt buộc, mặc định là WHOLE_SECONDS): WHOLE_MINUTES, WHOLE_SECONDS, MILLISECONDS_ONE_DIGIT, MILLISECONDS_TWO_DIGITS, MILLISECONDS_THREE_DIGITS | 3661 giây | 01:01:01 |
| COMPONENT_TEXT / TEXT | Đơn vị nhỏ nhất (Không bắt buộc, mặc định là GIÂY): GIÂY, PHÚT, GIỜ, NGÀY, THÁNG, NĂM | 90.000 giây | 1 ngày 1 giờ |
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ị.