Başarılar, kullanıcılarınızın oyununuzla olan etkileşimini artırmanın mükemmel bir yolu olabilir. Oyunculara normalde kullanmayabilecekleri özellikleri denemeleri veya oyununuza tamamen farklı bir oyun stiliyle yaklaşmaları için oyununuza başarı ekleyebilirsiniz. Başarılar, oyuncuların ilerleme durumlarını birbirleriyle karşılaştırmaları ve keyifli bir rekabete girmeleri için eğlenceli bir yol da olabilir.
Platformunuz için başarıları nasıl uygulayabileceğinizi öğrenmek istiyorsanız Müşteri uygulamalarını inceleyin.
Özellikler
Başarıların işleyiş biçimini anlamak için onlarla ilişkili bazı özelliklerden haberdar olmanız gerekir.
Her başarının temel unsurları şunlardır:
- Id, Google Play Console tarafından oluşturulan benzersiz bir dizedir. Oyun istemcilerinizdeki başarıya referans vermek için bu benzersiz kimliği kullanırsınız.
- Ad, başarının kısa adıdır (örneğin, "Pieman"). Değer en fazla 100 karakter olabilir.
- Açıklama, başarınızla ilgili kısa bir açıklamadır. Genellikle bu metin, oyuncunuza başarının nasıl kazanılacağını söyler (ör. "Gün batmadan önce limonlu meringue turtası pişirin"). Değer en fazla 500 karakter olabilir.
- Simge, başarınızla ilişkilendirilmiş kare bir simgedir. Başarı simgelerinizi oluştururken uygulayabileceğiniz en iyi uygulamalar için Simge Kuralları bölümüne bakın.
- Liste sırası, bir oyuncu oyununuzla ilişkili başarıları görüntülediğinde kilitli başarıların göründüğü sıradır. Bu, istediğiniz sırada olabilir. Kilidi açılan başarılar, kazanılan sırayla listenin en üstünde görünür.
Eyalet
Başarılar üç farklı durumdan birinde olabilir:
- Gizli bir başarı, başarıyla ilgili ayrıntıların oyuncudan gizlendiği anlamına gelir. Play Games Hizmetleri, gizli durumdaki başarı için genel bir yer tutucu açıklama ve simge sağlar. Oyununuzla ilgili çok erken bir aşamada açıklamak istemediğiniz bir spoiler içeren başarıları gizli olarak ayarlamanızı öneririz (ör. "Aslında bir hayalet olduğunuzu keşfedin").
- Açıklanmış bir başarı, oyuncunun başarıdan haberdar olduğu ancak henüz kazanmadığı anlamına gelir. Çoğu başarı, gösterilen durumda başlar.
- Kilidi açılmış bir başarı, oyuncunun başarıyı başarıyla kazandığı anlamına gelir. Başarıların kilidi çevrimdışı olarak da açılabilir. Oyun çevrimiçi olduğunda, başarının kilidi açılmış durumunu güncellemek için Play Oyun Hizmetleri ile senkronize edilir.
Artımlı başarılar
Başarılar standart veya artımlı olarak belirlenebilir. Genellikle, artımlı başarı, oyuncunun daha uzun bir süre boyunca başarıyı kazanma yolunda kademeli olarak ilerlemesini içerir. Oyuncu artımlı başarıya doğru ilerledikçe oyuncunun kısmi ilerlemesini Play Games Hizmetleri'ne bildirebilirsiniz.
Google Play Hizmeti, ilerleme bilgilerini izler, oyuncu bu başarının kilidini açmak için gereken ölçütleri karşıladığında oyunu uyarır ve oyuncuya bu hedefe ne kadar yaklaştığını söyler.

Artımlı başarılar, oyun oturumları boyunca kümülatif olarak hesaplanır ve ilerleme durumu oyun içinden kaldırılamaz veya sıfırlanamaz. Örneğin, "50 oyun kazan" artımlı başarı olarak kabul edilir. "Art arda 3 maç kazan" koşulu, oyuncu bir maç kaybettiğinde ilerleme durumunun sıfırlanacağı için geçerli olmaz. "5.000 poker jetonuna sahip olmak" da uygun değildir. Çünkü oyuncu oynarken jeton kazanabilir ve kaybedebilir. Son iki başarı için oyuncunun "Art arda kazandığı maç sayısı" durumunu veya çip toplamını izlemek ve oyuncu bu başarıları kazandığında standart başarıların kilidini açmak size bağlıdır.
Artımlı başarı oluştururken, kilidini açmak için gereken toplam adım sayısını tanımlamanız gerekir (bu sayı 2 ile 10.000 arasında olmalıdır). Kullanıcı, başarının kilidini açmak için ilerleme kaydettikçe kullanıcının Play Games Hizmetleri'nde attığı ek adım sayısını bildirmeniz gerekir. Toplam adım sayısı kilit açma değerine ulaştığında başarının kilidi açılır (gizli olsa bile). Kullanıcının kümülatif ilerleme durumunu saklamanıza gerek yoktur.
Puan
Başarıların puan değeri vardır. Oyuncunun puanı 5'in katı olmalıdır ve bir oyunun tüm başarıları için toplam puanı hiçbir zaman 1.000'den fazla olamaz (ancak daha az olabilir). Ayrıca, hiçbir başarı 200'den fazla puana sahip olamaz.
Deneyim puanlarını (XP) takip etme
Oyuncular, Play Games özellikli oyunlarda başarı kazandığında oyun profillerinde seviye atlayabilir. Bir başarıyla ilişkili her puan için oyuncu, ilgili başarıyı kazandığında 100 deneyim puanı (XP) kazanır. Başka bir deyişle:
XP for an achievement = 100 * (point value for the achievement)
Play Games Hizmetleri, her oyuncunun kazandığı XP'yi izler ve oyuncu "seviye atlamak" için yeterli puan kazandığında Google Play Games uygulamasına bildirim gönderir. Oyuncular, seviyelerini ve XP geçmişlerini Google Play Games uygulamasındaki profil sayfalarından görüntüleyebilir.
Minimum başarı sayısı
Başarı entegrasyonu olan oyunlarda, yayınlanmadan önce en az beş başarı bulunmalıdır. Beşten az başarı ile test yapabilirsiniz ancak oyununuzu yayınlamadan önce en az beş başarı oluşturmanız önerilir.
Maksimum başarı
Başarı sayısı, puan sınırlamalarına ve dağılımına göre sınırlıdır. Maksimum puan sayısı 1.000 ve her başarıya 5 puan atandığında maksimum başarı sayısı 200'dür. Ancak başarılara daha fazla puan atanırsa kullanılabilir başarı sayısı azalır.
Başarı ekle
Google Play Console'u kullanarak ilk kez başarı oluşturmanın iki yolu vardır:
- Başarıyı oluşturma: Her başarı için tanımları ve meta verileri tek tek ekleyin.
- Başarıları içe aktar: Birden fazla başarının tanımlarını ve diğer meta verilerini tek bir adımda içe aktarın.
Başarı oluşturma
Yeni ve yayınlanmamış bir oyun için başarı oluşturmak istiyorsanız aşağıdaki adımları uygulayın:
- Google Play Console'da bir oyun seçin.
- Play Games Hizmetleri - Başarılar sayfasında (Büyüme > Play Games Hizmetleri > Kurulum ve yönetim > Başarılar) Başarı oluştur'u seçin.
- Başarıları ekle sayfasında formu doldurun.
- Taslak olarak kaydet'i tıklayın.
- Başarı oluşturduktan sonra oyununuzu yayınlamanız gerekir.
Daha fazla başarı ekleme
Zaten başarılarınız varsa ve daha fazlasını eklemek istiyorsanız:
- Google Play Console'da bir oyun seçin.
- Play Games Hizmetleri - Başarılar sayfasında (Büyüme > Play Games Hizmetleri > Kurulum ve yönetim > Başarılar) Başarı ekle'yi seçin.
Başarıları içe aktar
Oyununuza tek seferde birden fazla başarı eklemek için aşağıdaki adımları uygulayın:
- Başarılarınızı içeren bir zip dosyası oluşturun.
- Dosyayı yükleyin.
Zip dosyası hakkında daha fazla bilgi için Zip dosyası kuralları başlıklı makaleyi inceleyin.
Başarıları içe aktarmak için:
- Google Play Console'da bir oyun seçin.
- Play Games Hizmetleri - Başarılar sayfasında (Büyüme > Play Games Hizmetleri > Kurulum ve yönetim > Başarılar) Başarıları içe aktar'ı seçin.
- Başarıları içe aktar sayfasında Yükle'yi tıklayın.
- Yüklenecek zip dosyasını seçin.
- Taslak olarak kaydet'i tıklayın.
- Başarıları içe aktardıktan sonra oyununuzu yayınlamanız gerekir.
Oyununuzu yayınlayın
Oyununuzu test edip yayınladıktan sonra oyununuzdaki tüm başarılar da yayınlanır.
Başarıları düzenleme
Daha önce oluşturduğunuz bir başarıyı düzenlemek için Google Play Console'un Başarıları sekmesinde ilgili başarıyı seçin. Bu noktada, başarıyı ilk kez oluştururken kullandığınız formu görürsünüz ve dilediğiniz alanları düzenleyebilirsiniz.
Bir başarıyı düzenlemeyi bitirdiğinizde Taslak olarak kaydet düğmesini tıklayın. Yeni düzenlenen başarı "teste hazır" aşamasında olur ve bu aşamada başarıyı test edebilirsiniz. Düzgün çalışıyorsa açılır listeden Yeniden yayınla'yı seçin. Bu işlem, oyununuzu ve güncellenmiş tüm başarılarınızı herkese açık olarak yeniden yayınlar.
Düzenlemeyi geri alma
Mevcut başarınızı beğenmediğinize karar verip başarınızın önceki haline dönmek isterseniz Google Play Console'daki açılır listeden Geri dön'ü seçin. Tüm başarılarınız daha önce yayınlanan sürüme geri döner.
Başarı silme
Başarılarınız yayınlandıktan sonra silinemez.
Yalnızca önceden yayınlanmış durumdaki bir başarıyı, ilgili başarı formunun alt kısmındaki Sil düğmesini tıklayarak silebilirsiniz.
Bir başarıyı sıfırlama
Yalnızca taslak başarılarınızın oyuncu ilerleme verilerini sıfırlayabilirsiniz.
- Google Play Console'da başarıları sıfırlamak için ilgili etkinliğin formunun alt kısmındaki Başarıyı sıfırla düğmesini tıklayın.
- Başarı verilerini programatik olarak sıfırlamak için Management API
Achievements
yöntemlerini çağırın.
Simgeyle ilgili kurallar
Simgeler 512 x 512 PNG, JPEG veya JPG dosyası olarak oluşturulmalıdır. Bunun için bize yalnızca kilidi açılmış başarının simgesini göndermeniz yeterlidir. Açığa çıkan simgenin gri tonlamalı bir sürümünü otomatik olarak oluştururuz. Bu nedenle, kullanıcılarınızın gösterilen ve kilidi açılan başarıları ayırt edebilmesi için başarı simgelerinizin renkli öğeler içermesini öneririz.
Android toast'ında bir başarı simgesi gösterildiğinde simgenin üzerine bir daire yerleştirilir ve dış köşeleri gizlenir. Simgenizin bu koşullarda da iyi göründüğünden emin olun.

Tüm yerel ayarlarda aynı simge kullanılır. Bu nedenle, simgelere metin veya yerelleştirilmiş içerik eklemenizi önermeyiz.
Zip dosyası yönergeleri
ZIP dosyası kullanarak birden fazla başarıyı tek seferde içe aktarabilirsiniz. ZIP dosyanızda kullanılacak tam dosya adları için tabloya bakın:
Dosya adı | Zorunlu veya İsteğe Bağlı | Kabul edilen değerler |
---|---|---|
AchievementsMetadata.csv
|
Zorunlu | Her başarının meta verileri. Özellikler başlıklı makaleyi inceleyin. |
AchievementsLocalizations.csv
|
İsteğe bağlı | Başarı adları ve açıklamaları için çeviriler sağlar. |
AchievementsIconMappings.csv
|
İsteğe bağlı | Başarıları simge dosyalarıyla eşleştirir. |
Simge dosyaları | İsteğe bağlı | PNG, JPEG veya JPG biçimindeki simgeler. |
Zip dosyası koşulları:
- Alt dizin yok.
- Benzersiz dosya adları.
- Yalnızca CSV, PNG, JPEG veya JPG dosyaları.
- CSV dosyalarında başlık satırı bulunmamalıdır.
- Her dosya 1 MB'tan küçük olmalıdır.
- Zip dosyası 203'ten fazla dosya içermemelidir.
- Toplam ZIP dosyası boyutu 200 MB'tan küçük olmalıdır.
AchievementsMetadata.csv biçimi
AchievementsMetadata.csv
dosyası, her başarının meta verilerini içerir.
Bilgiler aşağıdaki sırayla virgülle ayrılmış değerler olarak eklenmelidir:
Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order
Bu alanlar aşağıdaki tabloda açıklanmıştır:
CSV sütun başlıkları | Zorunlu veya İsteğe Bağlı | Kabul edilen değerler |
---|---|---|
Ad | Zorunlu | En fazla 100 karakter |
Açıklama | İsteğe bağlı | Maksimum 500 karakter |
Artımlı Değer | İsteğe bağlı | True veya False
|
Gerekli adımlar | Incremental Value True. ise gereklidir
|
Sayı (kesirli veya ondalık basamak içermez) |
Başlangıç Durumu | Zorunlu | Hidden veya Revealed
|
Puan | Zorunlu | 5'in katı olan ve 5 ile 200 arasında olan bir sayı |
Liste sıralaması | İsteğe bağlı | Sayı (kesirli veya ondalık basamak içermez, sıfırdan büyüktür) |
AchievementsMetadata.csv
dosyası koşulları:
- Her satırda yedi değer olmalıdır. Bir değeri çıkarmak istiyorsanız boş bırakın.
Name
veDescription
alanları varsayılan yerel ayar olarak kullanılır.Name
alanı tüm başarılarda benzersiz olmalıdır.- Aşağıdaki alanlar virgül içermemelidir:
Name
veDescription
.
Örnek bir AchievementsMetadata.csv
dosyası:
Achievement1,Achievement One,True,100,Hidden,5,20
Achievement2,Achievement Two,False,,Revealed,10,30
AchievementsLocalizations.csv biçimi
AchievementsLocalizations.csv
dosyası, her bir başarıyı farklı yerel ayarlardaki kullanıcılara açıklamak için gereken tüm verileri ayarlayan isteğe bağlı bir dosyadır.
Başarılar, oyun için belirtilen yerel ayarlara göre çevrilir.
Bilgiler aşağıdaki sırayla virgülle ayrılmış değerler olarak eklenmelidir:
Name, Localized name, Localized description, locale
Bu alanlar aşağıdaki tabloda açıklanmıştır:
CSV sütun başlıkları | Zorunlu veya İsteğe Bağlı | Açıklama | Kabul edilen değerler |
---|---|---|---|
Ad | Zorunlu | AchievementsMetadata.csv 'daki Name sütunuyla eşleşmelidir.
|
En fazla 100 karakter |
Yerelleştirilmiş ad | Zorunlu | Başarının yerelleştirilmiş adı. | En fazla 100 karakter |
Yerelleştirilmiş açıklama | İsteğe bağlı | Belirtilen yerel ayara göre başarının yerelleştirilmiş açıklaması. | Maksimum 500 karakter |
Yerel ayar | Zorunlu | Yerel ayar kodu (ör. en-US ).
|
Yerel ayar belirtmeden önce oyununuz için
çeviriler ekleyin. Varsayılan yerel ayarı belirtemeyeceğinizi unutmayın.
Desteklenen yerel ayar kodlarını desteklenen diller listesinde bulabilirsiniz. |
AchievementsLocalizations.csv
dosyası koşulları:
- Bir oyundaki başarı adları, yerel ayar başına benzersiz olmalıdır. Örneğin, bir oyun hem en-US hem de fr-FR yerel ayarlarını destekliyorsa en-US için "Achievement1" adlı bir başarı, fr-FR için de "Achievement1" olarak adlandırılabilir.
- Her satırda dört değer bulunmalıdır. Yerelleştirilmiş açıklama değerini çıkarmak istiyorsanız alanı boş bırakın.
Örnek bir AchievementsLocalizations.csv
dosyası:
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
AchievementsIconMappings.csv biçimi
AchievementsIconMappings.csv
dosyası, başarılarınızı belirli bir simgeyle eşlemek için kullanılan isteğe bağlı bir dosyadır. Bilgiler aşağıdaki sırayla virgül ayırıcılı değerler olarak eklenmelidir:
Name, icon filename
Bu alanlar aşağıdaki tabloda açıklanmıştır:
CSV sütun başlıkları | Zorunlu veya İsteğe Bağlı | Açıklama |
---|---|---|
Ad | Zorunlu | AchievementsMetadata.csv 'daki Name sütunuyla eşleşmelidir.
|
Simge dosya adı | Zorunlu | Simge dosyanızın adı. |
AchievementsIconMappings.csv
dosyası koşulları:
- Her satırda iki değer bulunmalıdır.
- Simge dosyaları yalnızca PNG veya JPEG biçiminde olabilir.
Örnek birAchievementsIconMappings.csv
dosyası:
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
Simge dosyaları
AchievementsIconMappings.csv
dosyasında referans verdiğiniz simgeler, içe aktardığınız mevcut zip arşivinde bulunmalıdır. Daha fazla bilgi için Simge yönergeleri başlıklı makaleyi inceleyin.
Başarılar için çeviri ekleme
Oyununuzla ilişkili başarılar için kendi çevirilerinizi belirtebilirsiniz. Bunu yapmadan önce Oyununuza çeviri ekleme bölümünde açıklanan adımları tamamladığınızdan emin olun.
Oyununuz için çeviri eklemenin iki yolu vardır:
Birçok yeni başarının çevirisini tek seferde yüklemek için başarıları içe aktar seçeneğini kullanabilirsiniz. Bu seçeneği, mevcut başarıların çevirilerini yüklemek için kullanamazsınız.
Oyununuzdaki her başarı için çeviri ekleyebilirsiniz. Her başarı için kendi çevirinizi eklemek istiyorsanız:
- Google Play Console'da oyununuzun Başarıları sekmesini açıp mevcut bir başarıyı seçin.
- Başarı ayrıntıları sayfasında, daha önce Oyun ayrıntıları sekmesinde eklediğiniz bir dilin sekmesini seçin.
- İlgili dilin başarı ayrıntıları sayfasında, formu ilgili başarı için çevirilerinizle düzenleyin.
- Çevrilmiş başarı ayrıntılarınızı kaydetmek için Kaydet'i tıklayın.
İstemci uygulamaları
Platformunuzda başarıları nasıl uygulayacağınızı öğrenmek için aşağıdaki kaynaklara göz atın: