Mengintegrasikan Statistik Game

Dokumen ini menjelaskan cara mengintegrasikan Statistik Game ke dalam game Anda menggunakan Konsol Google Play. Bagian ini mencakup format file CSV dan ZIP penting, serta menjelaskan cara membuat, mengimpor, dan mengelolanya.

Membuat peristiwa

Untuk membuat acara untuk game baru yang tidak dipublikasikan, selesaikan langkah-langkah berikut:

  1. Buat file CSV peristiwa PlayerGameEvent.csv
  2. Di Konsol Google Play, pilih game.
  3. Di halaman Layanan Play Games - Statistik Game (Mendorong pertumbuhan pengguna > Layanan Play Games > Penyiapan dan pengelolaan > Statistik Game), pilih Siapkan peristiwa.
  4. Di halaman Konfigurasi acara, tarik lalu lepas file CSV yang akan diupload.
  5. Setelah membuat Acara, Anda perlu menyiapkan statistik

Siapkan statistik

Setelah membuat acara, Anda perlu menyiapkan statistik:

  1. Buat file ZIP yang berisi file statistik, pelokalan, dan ikon Panduan file ZIP untuk statistik.
  2. Di Konsol Google Play, pilih game.
  3. Di halaman Layanan Play Games - Statistik Game (Mendorong pertumbuhan pengguna > Layanan Play Games > Penyiapan dan pengelolaan > Statistik Game), pilih Siapkan statistik.
  4. Di halaman Konfigurasi statistik game, lepas file ZIP untuk diupload.
  5. Setelah mengupload semua statistik, Anda dapat memublikasikan game.

Menguji Statistik Game

Untuk memverifikasi bahwa Statistik Game berfungsi sebagaimana mestinya, ikuti langkah-langkah untuk mengujinya:

  • Siapkan jalur pengujian internal.
  • Tambahkan akun uji ke project game Anda untuk penguji.
  • Buat profil Layanan Play Games untuk salah satu akun pengujian menggunakan Aplikasi Play Game.
  • Buka game menggunakan akun pengujian yang sama dengan yang Anda gunakan untuk membuat profil Layanan Play Games.
  • Pastikan "Toast selamat datang" Layanan Play Games ditampilkan di layar sebagai konfirmasi keberhasilan autentikasi otomatis saat peluncuran game.
  • Pengguna akun pengujian dapat memainkan game untuk memicu peristiwa. Periksa respons API untuk mengetahui apakah peristiwa telah direkam.

Memublikasikan Statistik Game

Setelah selesai menguji, Anda harus memublikasikan game. Semua acara dan statistik game Anda dipublikasikan bersama game tersebut.

Untuk memublikasikan, ikuti langkah-langkah berikut:

  1. Di Konsol Google Play, pilih game.
  2. Di halaman Layanan Play Games - Statistik Game (Mendorong pertumbuhan pengguna > Layanan Play Games > Penyiapan dan pengelolaan > Statistik Game), klik Tinjau dan publikasikan.
  3. Di halaman Layanan Play Games - Publikasi (Mendorong pertumbuhan pengguna > Layanan Play Games > Penyiapan dan pengelolaan > Publikasi), tinjau tindakan dan perbaiki masalah.
  4. Klik Publikasikan. Semua Statistik Game Anda dipublikasikan.

Menghapus Statistik Game

Setelah dipublikasikan, Statistik Game tidak dapat dihapus.

Panduan file CSV untuk acara

Baris pertama file CSV adalah baris header. Anda harus mengimpor acara menggunakan file CSV acara, misalnya, PlayerGameEvent.csv.

Format PlayerGameEvent.csv

CSV berisi peristiwa yang dideklarasikan dan propertinya sebagai nilai yang dipisahkan koma dalam urutan berikut:

 Event Name,Property Name,Property Type

Jika Anda mengirim peristiwa progressUpdate untuk progressionStat, tambahkan baris untuk peristiwa ini. Peristiwa ini harus berisi setidaknya properti currentProgress berjenis INT atau STRING, ditambah properti lain yang ingin Anda kirim.

Kolom-kolom ini dijelaskan dalam tabel berikut:

Header kolom CSV Wajib Diisi atau Opsional Nilai yang diterima
Nama Peristiwa Wajib Maksimum 50 karakter

Hanya boleh terdiri dari huruf, angka, dan garis bawah.

Jika nama acara khusus progressUpdate digunakan, nama tersebut harus menyertakan properti bernama currentProgress berjenis INT64 atau STRING.
Nama Properti Wajib Maksimum 50 karakter

Hanya boleh terdiri dari huruf, angka, dan garis bawah.

Unik per Peristiwa: Nama properti harus unik dalam peristiwa yang sama.

Jangan gunakan kata kunci khusus berikut: id, count, key, value, where, from, and, or, true, atau false.
Jenis Properti Wajib String enum peka huruf besar/kecil yang cocok dengan salah satu jenis data yang didukung: INT64, DOUBLE, STRING, BOOL

Persyaratan file PlayerGameEvent.csv:

  • File ini mendukung maksimum 20 nama peristiwa unik, dengan hingga 20 properti per peristiwa.
  • Konten file tidak boleh kosong dan harus memiliki minimal 1 baris.
Tabel contoh
Nama Peristiwa Nama Properti Jenis Properti
matchCompleted durasi DOUBLE
matchCompleted membunuh INT64
matchCompleted isWinner BOOL
matchCompleted matchType STRING
itemCollected coinsAmount INT64
itemCollected weaponType STRING
progressUpdate currentProgress INT64

Panduan file ZIP untuk statistik

Anda dapat mengimpor statistik sekaligus menggunakan file ZIP. Lihat tabel untuk mengetahui nama file yang tepat untuk digunakan dalam file ZIP Anda:

Nama file Wajib Diisi atau Opsional Nilai yang diterima
RepetitiveStatsConfig.csv Wajib Statistik berulang merepresentasikan tindakan dalam game yang terjadi secara rutin yang dilakukan oleh pemain.
ProgressionStatConfig.csv Wajib Statistik progres mewakili progres pemain dalam game.
StatLocalizations.csv Opsional Memberikan terjemahan untuk nama dan deskripsi Statistik Game.
File ikon Wajib Ikon dalam format PNG, JPEG, atau JPG berukuran 512 x 512.

File ZIP harus memenuhi persyaratan berikut:

  • Batas ukuran file ZIP: Ukuran total maksimum yang tidak dikompresi adalah 10 MB.
  • File maks.: Maksimum 53 file (3 CSV dan 50 ikon) total di dalam arsip ZIP.
  • Batas statistik gabungan maksimum: Maksimum 50 total statistik di ProgressionStatConfig.csv dan RepetitiveStatsConfig.csv.
  • File CSV yang didukung: ProgressionStatConfig.csv, RepetitiveStatsConfig.csv, dan StatLocalizations.csv (opsional). Jika Anda hanya ingin mengupload statistik progres, jangan sertakan file CSV statistik berulang dalam ZIP; jika tidak, konsol akan menampilkan error. Hal yang sama berlaku jika Anda hanya ingin mengupload statistik berulang.
  • File gambar ikon: PNG (.png) atau JPEG (.jpg, .jpeg).
    • Semua ikon yang dirujuk dalam CSV harus ada di root file ZIP.
    • Semua file gambar yang ada di ZIP harus direferensikan oleh setidaknya satu statistik.
  • Struktur direktori: Semua file harus berada di root file ZIP. Subdirektori tidak diizinkan.

Format RepetitiveStatsConfig.csv

CSV berisi peristiwa yang dideklarasikan dan propertinya sebagai nilai yang dipisahkan koma dalam urutan berikut:

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

Kolom-kolom ini dijelaskan dalam tabel berikut:

Header kolom CSV Wajib Diisi atau Opsional Nilai yang diterima
ID Statistik Wajib Maksimum 100 karakter

Hanya boleh terdiri dari huruf, angka, dan garis bawah. Harus unik di semua statistik dalam game.
Nama Properti Peristiwa Wajib Maksimum 50 karakter
Nama Tampilan Statistik Wajib Maksimum 50 karakter
Nama tampilan default untuk statistik (lokalitas default). Harus unik di seluruh statistik.
Deskripsi Statistik Wajib Maksimum 500 karakter
Deskripsi default untuk statistik.
Jenis Agregasi Wajib Maksimum 50 karakter
SUM, MAX, MIN, COUNT.
Filter Properti Opsional Maksimum 50 karakter
Harus berupa Nama Properti yang ditentukan dalam PlayerGameEvent.csv.
Operator Filter Opsional =, !=, >, <, >=, <=
Operator perbandingan filter.
Nilai Filter Opsional Dibandingkan dengan Properti Filter. Nilai filter harus INT64, DOUBLE, BOOL, STRING.
Bersaing Wajib true, false
Batas minimum Wajib diisi jika Is Competitive adalah benar (true) Skor minimum yang diizinkan untuk statistik kompetitif.
Batas maksimum Wajib diisi jika Is Competitive adalah benar (true) Skor maksimum yang diizinkan untuk statistik kompetitif.
Nama File Ikon Wajib Nama file gambar ikon yang disertakan di root file ZIP. Tidak boleh bertentangan dengan nama file ikon yang digunakan dalam statistik berulang.
Arah nilai yang baik Wajib Menentukan apakah nilai yang lebih tinggi INCREASING atau nilai yang lebih rendah DECREASING lebih baik.
Unit Opsional Satuan pengukuran untuk nilai numerik atau durasi mentah. Misalnya, KILOMETER, SECOND, PERCENTAGE, UNITLESS.

Jika Anda tidak ingin menggunakan kondisi filter, biarkan sel kosong.

Tabel contoh
ID Statistik Nama Peristiwa Nama Properti Agregasi Nama Tampilan Statistik Deskripsi Statistik Filter Properti (opsional) Operator Filter (opsional) Nilai Filter (opsional) Bersaing minLimit maxLimit Nama file ikon Nomor urutan Arah nilai yang baik satuan
1 matchCompleted durasi MAX Longest Match Survival Ini menunjukkan waktu bertahan pemain dalam pertandingan apa pun isWinner = TRUE TRUE 0 50 stat1.png 1 Menurun detik
2 matchCompleted isWinner COUNT Pertandingan yang Dimenangkan Ini menunjukkan jumlah pertandingan yang dimenangkan pemain isWinner = TRUE TRUE 0 50 stat3.png 2 Meningkat
3 matchCompleted membunuh SUM Membunuh pertandingan 1 lawan 1 Jumlah pembunuhan yang dilakukan dalam pertandingan 1 lawan 1 matchType = "1-on-1" (Personal) SALAH stat4.png 4 Meningkat
4 itemCollected coinsAmount SUM Total Emas yang Dikumpulkan Pemain mengumpulkan koin saat bermain dalam pertandingan weaponType = "sword" SALAH stat2.png 3 Meningkat

Format ProgressionStatConfig.csv

CSV berisi peristiwa yang dideklarasikan dan propertinya sebagai nilai yang dipisahkan koma dalam urutan berikut:

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

Statistik progres akan ditampilkan sebagai statistik pertama kepada pemain di Profil Gamer mereka.

Kolom-kolom ini dijelaskan dalam tabel berikut:

Header kolom CSV Wajib Diisi atau Opsional Nilai yang diterima
ID Statistik Wajib Maksimum 100 karakter

Hanya boleh terdiri dari huruf, angka, dan garis bawah. Harus unik di semua statistik dalam game.
Nama Peristiwa Wajib Maksimum 50 karakter

Harus mereferensikan Nama Peristiwa yang ditentukan dalam format PlayerGameEvent.csv.
Nama Properti Peristiwa Wajib Maksimum 50 karakter

Harus berupa Nama Properti yang ditentukan dalam PlayerGameEvent.csv.
Nama Tampilan Statistik Wajib Harus berupa nama yang unik.
Deskripsi Statistik Wajib Maksimum 50 karakter
Deskripsi default untuk statistik.
Nama File Ikon Wajib Nama file gambar ikon yang disertakan di root file ZIP. Tidak boleh bertentangan dengan nama file ikon yang digunakan dalam statistik berulang.
Arah nilai yang baik Wajib Menentukan apakah nilai yang lebih tinggi INCREASING atau nilai yang lebih rendah DECREASING lebih baik.
Unit Opsional Satuan pengukuran untuk nilai numerik atau durasi mentah. Misalnya, KILOMETER, SECOND, PERCENTAGE, UNITLESS.
Tabel contoh
ID Statistik Nama Properti Acara Stat Display Name Deskripsi Statistik Nama File Ikon Arah nilai yang baik
5 currentProgress Tingkat Pemain mengumpulkan XP dengan memainkan pertandingan dan naik level. Level.png meningkat

Format StatLocalizations.csv

CSV berisi peristiwa yang dideklarasikan dan propertinya sebagai nilai yang dipisahkan koma dalam urutan berikut:

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

Kolom-kolom ini dijelaskan dalam tabel berikut:

Header kolom CSV Wajib Diisi atau Opsional Nilai yang diterima
ID Statistik Wajib Maksimum 100 karakter

Hanya boleh terdiri dari huruf, angka, dan garis bawah. Harus unik di semua statistik dalam game.
Nama Tampilan Statistik Wajib Harus berupa nama yang unik.
Lokal Wajib Kode lokalitas seperti en-US.
Tambahkan terjemahan untuk game Anda sebelum menentukan lokalitas. Perhatikan bahwa Anda tidak dapat menentukan lokalitas default.

Kode lokalitas yang didukung dapat ditemukan dalam daftar bahasa yang didukung.
Nama Tampilan Statistik yang Dilokalkan Opsional Maksimum 50 karakter. Nama tampilan statistik yang diterjemahkan untuk lokalitas tertentu.
Deskripsi Statistik yang Dilokalkan Opsional Maksimum 500 karakter. Deskripsi statistik yang diterjemahkan untuk lokalitas tertentu.
Tabel contoh
ID Statistik Stat Display Name Kode Bahasa Nama Statistik yang Dilokalkan (UTF-8) Deskripsi Statistik yang Dilokalkan (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 Total Emas yang Dikumpulkan es Total emas yang dikumpulkan Pemain mengumpulkan koin saat bermain dalam pertandingan 4 Total Emas yang Dikumpulkan fr Atau total collecté Le joueur collecte des pièces en jouant un match

File ikon

Ikon yang Anda referensikan dalam file .csv harus ada dalam arsip zip saat ini yang Anda impor.

Aturan validasi ikon adalah:

Properti validasi Batasan / aturan yang diterapkan
Ukuran maks file Maksimum 1 MB (1.048.576 byte) per file ikon.
Dimensi Tepat 512 × 512 piksel (lebar = 512, tinggi = 512)
Rasio Aspek Benar-benar 1:1 (Rasio aspek persegi)
Format yang Diizinkan PNG (.png) dan JPEG (.jpg, .jpeg)
Penempatan dalam ZIP Harus berada di direktori root dalam file ZIP.
Pemeriksaan yang Dirujuk Semua nama file ikon yang ditentukan di kolom Nama File Ikon harus ada di ZIP.
Pemeriksaan Orfan Semua file gambar di dalam ZIP harus direferensikan oleh setidaknya satu statistik.
Pemeriksaan Konflik Nama file ikon di ProgressionStatConfig.csv tidak boleh bertentangan dengan RepetitiveStatsConfig.csv.
Duplikat Visual Ikon duplikat ditandai.

Pedoman ikon

Ikon harus dibuat sebagai file PNG, JPEG, atau JPG berukuran 512 x 512.

Ikon yang sama digunakan di semua lokalitas, jadi sebaiknya jangan sertakan teks atau konten yang dilokalkan dalam ikon.

Spesifikasi unit

Kolom Unit mengontrol cara nilai statistik mentah diformat dan dilokalkan untuk pemain.

Properti statistik numerik (INT64, DOUBLE)

Nilai Unit yang Diizinkan Contoh Nilai Mentah
(Kosong) / TANPA SATUAN / TIDAK ADA 1234567
% / PERSENTASE / PERSEN 0,857
Jarak/Panjang: SENTIMETER, METER, KILOMETER, KAKI, INCI, MIL, YARD, MILIMETER, NANOMETER 15 (KILOMETER)
Kecepatan: KILOMETER_PER_HOUR, METER_PER_SECOND, MILE_PER_HOUR 60 (MILE_PER_HOUR)

Properti Statistik Non-Numerik (STRING, BOOL)

Kolom unit harus dibiarkan kosong.