Pencapaian

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Kirim masukan

Pencapaian dapat menjadi cara yang luar biasa untuk meningkatkan interaksi pengguna dalam game Anda. Anda dapat menerapkan pencapaian dalam game untuk mendorong pemain bereksperimen dengan fitur yang biasanya tidak digunakan, atau untuk mendekati game Anda dengan gaya bermain yang benar-benar berbeda. Pencapaian juga bisa menjadi cara seru bagi pemain untuk membandingkan progres satu sama lain dan berinteraksi dalam kompetisi yang ringan.

Untuk mempelajari cara menerapkan pencapaian untuk platform Anda, lihat Implementasi klien.

Atribut

Untuk memahami cara kerja pencapaian, Anda harus memahami beberapa atribut yang terkait dengan pencapaian tersebut.

Elemen dasar berikut dikaitkan dengan setiap pencapaian:

• Id adalah string unik yang dihasilkan oleh Konsol Google Play. Anda akan menggunakan ID unik ini untuk merujuk ke pencapaian di klien game Anda.
• Nama adalah nama pendek pencapaian (misalnya, "Pieman"). Nilai dapat berisi maksimal 100 karakter.
• Deskripsi adalah deskripsi singkat tentang pencapaian Anda. Biasanya, hal ini memberi tahu pemain cara memperoleh pencapaian (misalnya, "Memanggang pai krim lemon sebelum matahari terbenam"). Nilai dapat mencapai maksimum 500 karakter.
• Ikon adalah ikon persegi yang terkait dengan pencapaian Anda. Untuk praktik terbaik saat membuat ikon pencapaian, lihat bagian Panduan Ikon.
• Urutan daftar adalah urutan kemunculan pencapaian yang dikunci saat pemain melihat pencapaian yang terkait dengan game Anda. Urutannya dapat diatur sesuai keinginan Anda. Pencapaian terbuka akan muncul di bagian atas daftar dalam urutan pencapaian.

Status

Pencapaian dapat berada dalam salah satu dari tiga status:

• Pencapaian tersembunyi berarti detail tentang pencapaian disembunyikan dari pemain. Layanan game Play memberikan deskripsi dan ikon placeholder umum untuk pencapaian saat dalam status tersembunyi. Sebaiknya sembunyikan pencapaian jika berisi spoiler tentang game yang tidak ingin diungkapkan terlalu awal (misalnya, "Ketahui bahwa selama ini Anda adalah hantu!").
• Pencapaian terungkap berarti pemain mengetahui tentang pencapaian tersebut, tetapi belum mendapatkannya. Sebagian besar pencapaian dimulai dengan status terungkap.
• Pencapaian terbuka berarti pemain telah berhasil memperoleh pencapaian tersebut. Pencapaian dapat dibuka secara offline. Setelah online kembali, game akan disinkronkan dengan Layanan game Play untuk memperbarui status terbuka pencapaian tersebut.

Pencapaian inkremental

Pencapaian dapat ditetapkan sebagai standar atau inkremental. Umumnya, pencapaian inkremental melibatkan pemain yang membuat progres bertahap dalam mendapatkan pencapaian selama jangka waktu yang lebih lama. Saat pemain membuat progres terhadap pencapaian inkremental, Anda dapat melaporkan sebagian progres pemain ke Layanan game Play.

Layanan Google Play terus melacak informasi progres, memberi tahu game saat pemain telah memenuhi kriteria yang diperlukan untuk membuka pencapaian tersebut, dan memberi tahu pemain sejauh mana mereka mencapai tujuan tersebut.

Pencapaian inkremental bersifat kumulatif di seluruh sesi game, dan progres tidak dapat dihapus atau direset dari dalam game. Misalnya, "Menang 50 game" akan memenuhi syarat sebagai pencapaian inkremental. "Menang 3 game berturut-turut" tidak memenuhi syarat, karena progres pemain akan direset saat mereka kalah. "Memiliki 5.000 chip poker" juga tidak akan memenuhi syarat, karena pemain dapat memperoleh dan kehilangan chip saat mereka bermain. Untuk dua pencapaian terakhir, Anda dapat melacak status "Menang berturut-turut" atau total chip pemain dan membuka pencapaian standar saat pemain mendapatkan pencapaian tersebut.

Saat membuat pencapaian inkremental, Anda harus menentukan jumlah total langkah yang diperlukan untuk membuka pencapaian (jumlahnya harus antara 2 dan 10.000). Saat pengguna membuat progres untuk membuka pencapaian, Anda harus melaporkan jumlah langkah tambahan yang telah dilakukan pengguna ke Layanan game Play. Setelah jumlah total langkah mencapai nilai buka kunci, pencapaian akan terbuka (meskipun tersembunyi). Anda tidak perlu menyimpan progres kumulatif pengguna.

Poin

Pencapaian memiliki nilai poin yang terkait dengannya. Skor pemain harus dalam kelipatan 5 dan game tidak boleh memiliki total lebih dari 1.000 poin untuk semua pencapaiannya (meskipun bisa kurang). Selain itu, tidak ada satu pencapaian yang dapat memiliki lebih dari 200 poin.

Melacak poin pengalaman (XP)

Pemain dapat memperoleh level di Profil Game saat memperoleh pencapaian dalam game yang mengaktifkan Play Game. Untuk setiap poin yang terkait dengan pencapaian, pemain mendapatkan 100 poin pengalaman (XP) saat mendapatkan pencapaian tersebut. Dengan kata lain:

XP for an achievement = 100 * (point value for the achievement)

Layanan Play Game memantau XP yang diperoleh setiap pemain dan mengirimkan notifikasi ke aplikasi Google Play Game saat pemain mendapatkan cukup poin untuk 'naik level'. Pemain dapat melihat level dan histori XP dari halaman Profil mereka di aplikasi Google Play Game.

Pencapaian minimum

Game yang mengintegrasikan pencapaian harus memiliki minimal lima pencapaian sebelum dipublikasikan. Anda dapat melakukan pengujian dengan kurang dari lima pencapaian, tetapi sebaiknya Anda memiliki minimal lima pencapaian yang dibuat sebelum memublikasikan game.

Pencapaian maksimum

Jumlah pencapaian dibatasi oleh distribusi dan batas poin. Dengan jumlah maksimum 1.000 poin, dan setiap pencapaian menetapkan 5 poin, jumlah maksimum pencapaian adalah 200. Namun, jika pencapaian diberi lebih banyak poin, jumlah pencapaian yang tersedia akan menurun.

Tambahkan pencapaian

Ada dua cara untuk membuat pencapaian untuk pertama kalinya menggunakan Konsol Google Play:

• Membuat pencapaian: Tambahkan definisi dan metadata untuk setiap pencapaian satu per satu.
• Impor pencapaian: Mengimpor definisi dan metadata lainnya untuk beberapa pencapaian secara bersamaan dalam satu langkah.

Membuat pencapaian

Untuk membuat pencapaian bagi game baru dan yang belum dipublikasikan, selesaikan langkah-langkah berikut:

1. Di Konsol Google Play, pilih game.
2. Di halaman Layanan game Play - Pencapaian (Grow > Layanan game Play > Penyiapan dan pengelolaan > Pencapaian), pilih Buat pencapaian.
3. Di halaman Tambahkan pencapaian, lengkapi formulir.
4. Klik Simpan sebagai draf.
5. Setelah membuat pencapaian, Anda perlu memublikasikan game.

Menambahkan pencapaian lainnya

Jika Anda sudah memiliki pencapaian dan ingin menambahkan pencapaian lainnya:

1. Di Konsol Google Play, pilih game.
2. Di halaman Layanan game Play - Pencapaian (Grow > Layanan game Play > Penyiapan dan pengelolaan > Pencapaian), pilih Tambahkan pencapaian.

Impor pencapaian

Untuk menambahkan beberapa pencapaian ke game Anda sekaligus, gunakan langkah-langkah berikut:

1. Buat file ZIP yang berisi pencapaian Anda.
2. Upload file.

Untuk informasi selengkapnya tentang file ZIP, lihat Panduan file ZIP.

Untuk mengimpor pencapaian:

1. Di Konsol Google Play, pilih game.
2. Di halaman Layanan game Play - Pencapaian (Grow > Layanan game Play > Penyiapan dan pengelolaan > Pencapaian), pilih Impor pencapaian.
3. Di halaman Impor pencapaian, klik Upload.
4. Pilih file zip yang akan diupload.
5. Klik Simpan sebagai draf.
6. Setelah mengimpor pencapaian, Anda harus memublikasikan game.

Publikasikan game Anda

Setelah Anda menguji dan memublikasikan game, semua pencapaian game akan dipublikasikan bersama game tersebut.

Mengedit pencapaian

Untuk mengedit pencapaian yang telah Anda buat, pilih pencapaian di tab Pencapaian di Konsol Google Play. Pada tahap ini, Anda akan melihat formulir yang sama dengan yang digunakan saat pertama kali membuat pencapaian, dan Anda dapat mengedit kolom apa pun sesuai kebutuhan.

Setelah selesai mengedit pencapaian, klik tombol Simpan sebagai draf. Pencapaian yang baru diedit akan berada pada tahap "siap untuk diuji", dan Anda dapat mengujinya. Jika berfungsi dengan benar, pilih Publikasikan ulang dari menu drop-down. Tindakan ini akan memublikasikan ulang game Anda, beserta semua pencapaian terbaru Anda, ke publik.

Mengurungkan pengeditan

Jika Anda merasa tidak menyukai pencapaian saat ini dan ingin kembali ke pencapaian sebelumnya, pilih Kembalikan dari menu drop-down di Konsol Google Play, dan semua pencapaian Anda akan kembali ke versi yang telah dipublikasikan sebelumnya.

Menghapus pencapaian

Setelah dipublikasikan, pencapaian Anda tidak dapat dihapus.

Anda hanya dapat menghapus pencapaian dalam status pra-publikasi dengan mengklik tombol berlabel Hapus di bagian bawah formulir untuk pencapaian tersebut.

Mereset pencapaian

Anda hanya dapat mereset data progres pemain untuk pencapaian draf.

• Untuk mereset pencapaian di Konsol Google Play, klik tombol berlabel Reset progres pencapaian di bagian bawah formulir untuk peristiwa tersebut.
• Untuk mereset data pencapaian secara terprogram, panggil metode Achievements Management API.

Pedoman ikon

Ikon harus dibuat sebagai file PNG, JPEG, atau JPG berukuran 512 x 512. Anda hanya perlu memberikan ikon untuk pencapaian terbuka. Kami akan otomatis membuat versi hitam putih untuk ikon yang ditampilkan. Oleh karena itu, sebaiknya ikon pencapaian Anda menyertakan elemen yang berwarna-warni, sehingga pengguna dapat membedakan antara pencapaian terungkap dan pencapaian terbuka.

Saat ikon pencapaian ditampilkan dalam toast Android, ikon akan ditempatkan dalam lingkaran dan sudut-sudut luarnya tersembunyi. Pastikan ikon Anda masih terlihat bagus dalam kondisi ini.

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

Panduan file ZIP

Anda dapat mengimpor beberapa pencapaian sekaligus menggunakan file zip. Lihat tabel untuk mengetahui nama file yang tepat untuk digunakan dalam file zip Anda:

Persyaratan file ZIP:

• Tidak ada subdirektori.
• Nama file yang unik.
• Hanya file CSV, PNG, JPEG, atau JPG.
• File CSV tidak boleh memiliki baris header.
• Ukuran setiap file tidak boleh lebih dari 1 MB.
• File zip tidak boleh berisi lebih dari 203 file.
• Total ukuran file zip harus kurang dari 200 MB.

Format AchievementsMetadata.csv

File AchievementsMetadata.csv berisi metadata untuk setiap pencapaian. File ini harus menyertakan informasi sebagai nilai yang dipisahkan koma dalam urutan berikut:

    Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order

Kolom-kolom ini dijelaskan dalam tabel berikut:

Persyaratan file AchievementsMetadata.csv:

• Setiap baris harus memiliki tujuh nilai. Jika Anda ingin menghapus nilai, kosongkan nilai tersebut.
• Kolom Name dan Description digunakan sebagai lokalitas default.
• Kolom Name harus unik di semua pencapaian.
• Kolom berikut tidak boleh berisi koma: Name dan Description.

Contoh file AchievementsMetadata.csv:

  Achievement1,Achievement One,True,100,Hidden,5,20
  Achievement2,Achievement Two,False,,Revealed,10,30

Format AchievementsLocalizations.csv

File AchievementsLocalizations.csv adalah file opsional yang menyiapkan semua data yang diperlukan untuk mendeskripsikan setiap pencapaian kepada pengguna di lokalitas yang berbeda. Pencapaian diterjemahkan sesuai dengan lokalitas yang ditentukan untuk game.

File ini harus menyertakan informasi sebagai nilai yang dipisahkan koma dalam urutan berikut:

   Name, Localized name, Localized description, locale

Kolom-kolom ini dijelaskan dalam tabel berikut:

Persyaratan file AchievementsLocalizations.csv:

• Nama pencapaian dalam game harus unik per lokalitas. Misalnya, jika game mendukung lokalitas en-US dan fr-FR, pencapaian bernama "Achievement1" untuk en-US juga dapat diberi nama "Achievement1" untuk fr-FR.
• Setiap baris harus memiliki empat nilai. Jika Anda ingin menghapus nilai Deskripsi lokal, biarkan kosong.

Contoh file AchievementsLocalizations.csv:

Achievement1,Achievement One,This is the description of achievement one in English.,en-US
Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR
Achievement2,Achievement Two,Description of achievement two.,en-US
Achievement2,Logro Dos,Descripción del logro dos.,es-ES
Achievement3,Achievement Three,,en-US
Achievement3,Erfolg Drei,,de-DE

Format AchievementsIconMappings.csv

File AchievementsIconMappings.csv adalah file opsional yang digunakan untuk memetakan pencapaian Anda dengan ikon yang diberikan. File ini harus menyertakan informasi sebagai nilai yang dipisahkan koma dalam urutan berikut:

Name, icon filename

Kolom-kolom ini dijelaskan dalam tabel berikut:

Persyaratan file AchievementsIconMappings.csv:

• Setiap baris harus memiliki dua nilai.
• File ikon hanya boleh dalam format PNG atau JPEG.

Contoh fileAchievementsIconMappings.csv:

Valid Achievement,valid-achievement-icon.png
Incremental Achievement,incremental-achievement-icon.jpeg
No Description,no-description-icon.png
Hidden Initial State,hidden-initial-state-icon.png
Large Point Value,large-point-value-icon.jpeg

File ikon

Ikon yang Anda referensikan dalam file AchievementsIconMappings.csv harus ada dalam arsip zip saat ini yang Anda impor. Untuk informasi selengkapnya, lihat Panduan ikon.

Menambahkan terjemahan untuk pencapaian

Anda dapat menentukan terjemahan Anda sendiri untuk pencapaian yang terkait dengan game Anda. Sebelum melakukannya, pastikan Anda sudah menyelesaikan langkah-langkah yang dijelaskan dalam Menambahkan terjemahan untuk game.

Ada dua cara untuk menambahkan terjemahan game:

• Anda dapat menggunakan opsi impor pencapaian untuk mengupload terjemahan untuk banyak pencapaian baru sekaligus. Anda tidak dapat menggunakan opsi ini untuk mengupload terjemahan untuk pencapaian yang sudah ada.

• Anda dapat menambahkan terjemahan untuk setiap pencapaian dalam game. Untuk menambahkan terjemahan Anda sendiri untuk setiap pencapaian:

  1. Di Konsol Google Play, buka tab Pencapaian untuk game Anda, lalu pilih pencapaian yang sudah ada.
  2. Di halaman detail pencapaian, pilih tab untuk bahasa yang sebelumnya Anda tambahkan di tab Detail game.
  3. Di halaman detail pencapaian untuk bahasa tersebut, edit formulir dengan terjemahan Anda untuk pencapaian tersebut.
  4. Klik Simpan untuk menyimpan detail pencapaian yang telah diterjemahkan.

Implementasi klien

Untuk mempelajari cara mengimplementasikan pencapaian untuk platform Anda, lihat referensi berikut:

• Android
• Unity
• Web
• Praktik terbaik untuk mengimplementasikan pencapaian