Bu belgede, Google Play Console'u veya API çağrılarını kullanarak başarıları oyununuza nasıl entegre edeceğiniz açıklanmaktadır. Bu dokümanda, başarımların temel öğeleri ve durumları ele alınmakta, ayrıca başarımların nasıl oluşturulacağı, içe aktarılacağı ve yönetileceği açıklanmaktadır.
Başlamadan önce
Yüksek kaliteli başarılar tasarlama yönergelerini inceleyin.
Başarılarla ilgili temel bilgiler bölümündeki terimleri inceleyin.
Yeni başarılar oluşturma veya içe aktarma
Başarıları sıfırdan uygulamak için aşağıdaki adımları uygulayın:
Başarı ekle
Google Play Console'u kullanarak ilk kez başarı oluşturmak için iki yöntem bulunur:
- Başarı oluşturma: Her başarı için tanımları ve meta verileri tek tek ekleyin.
- Başarıları içe aktarma: Birden fazla başarının tanımlarını ve diğer meta verilerini tek 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.
- Google Play Games Hizmetleri - Başarılar sayfasında (Büyüme > Google Play Games Hizmetleri > Kurulum ve yönetim > Başarılar), Başarı oluştur'u seçin.
- Başarı ekle sayfasında formu doldurun.
- Taslak olarak kaydet'i tıklayın.
- Başarı oluşturduktan sonra başarılarınızı yayınlamanız gerekir.
Başarıları içe aktar
Oyununuza aynı anda 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ı yönergeleri konusunu inceleyin.
Başarıları içe aktarmak için:
- Google Play Console'da bir oyun seçin.
- Google Play Games Hizmetleri - Başarılar sayfasında (Büyüme > Google 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.
ZIP dosyası yönergeleri
ZIP dosyası kullanarak birden fazla başarıyı tek seferde içe aktarabilirsiniz. ZIP dosyanızda kullanabileceğiniz 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ıya ait meta veriler. Özellikler başlıklı makaleyi inceleyin. |
AchievementsLocalizations.csv
|
İsteğe bağlı | Başarı adları ve açıklamalarını çevirir. |
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ıyla ilgili şartlar:
- Alt dizin içermez.
- 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 az olmalıdır.
AchievementsMetadata.csv biçimi
AchievementsMetadata.csv dosyası, her başarıya ait meta verileri 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 |
|---|---|---|
| Name (Ad) | Zorunlu | Maksimum 100 karakterdir |
| Description (Açıklama) | İsteğe bağlı | Maksimum 500 karakterdir |
| Incremental Value (Artımlı Değer) | İsteğe bağlı | True veya False
|
| Steps Needed (Gereken Adım Sayısı) | Incremental Value, True. ise zorunludur.
|
Sayı (kesirli veya ondalık sayı içermez) |
| Initial State (İlk Durum) | Zorunlu | Hidden veya Revealed
|
| Puan | Zorunlu | 5 ile 200 arasında 5'in katları olan bir sayı |
| List Order (Liste Sıralaması) | İsteğe bağlı | Sayı (kesirli veya ondalık sayı içermez, sıfırdan büyüktür) |
AchievementsMetadata.csv dosyasıyla ilgili şartlar:
- Her satırda yedi değer olmalıdır. Bir değeri çıkarmak istiyorsanız boş bırakın.
NameveDescriptionalanları varsayılan yerel ayar olarak kullanılır.Namealanı, tüm başarılarda benzersiz olmalıdır.- Şu alanlar virgül içermemelidir:
NameveDescription.
Örnek 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ı, farklı yerel ayarlardaki kullanıcılara her bir başarıyı açıklamak için gerekli tüm verilerin ayarlandığı 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 |
|---|---|---|---|
| Name (Ad) | Zorunlu | AchievementsMetadata.csv dosyasındaki Name sütunuyla eşleşmelidir.
|
Maksimum 100 karakterdir |
| Localized name (Yerelleştirilmiş ad) | Zorunlu | Başarının yerelleştirilmiş adı. | Maksimum 100 karakterdir |
| Localized description (Yerelleştirilmiş açıklama) | İsteğe bağlı | Başarının, belirtilen yerel ayardaki yerelleştirilmiş açıklaması. | Maksimum 500 karakterdir |
| Locale (Yerel ayar) | Zorunlu | Yerel ayar kodu (ör. en-US).
|
Yerel ayar belirtmeden önce oyununuza
çeviri ekleyin. Varsayılan yerel ayarı belirtemeyeceğinizi hatırlatırız.
Desteklenen yerel ayar kodlarını desteklenen diller listesinde bulabilirsiniz. |
AchievementsLocalizations.csv dosyasıyla ilgili şartlar:
- Bir oyundaki başarı adları, her yerel ayar için 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 bu alanı boş bırakın.
Örnek 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ı dosyadır. Bilgiler aşağıdaki sırayla virgülle ayrılmış 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 |
|---|---|---|
| Name (Ad) | Zorunlu | AchievementsMetadata.csv dosyasındaki Name sütunuyla eşleşmelidir.
|
| Icon filename (Simge dosyası adı) | Zorunlu | Simge dosyanızın adı. |
AchievementsIconMappings.csv dosyasıyla ilgili şartlar:
- Her satırda iki değer bulunmalıdır.
- Simge dosyaları yalnızca PNG veya JPEG biçiminde olabilir.
ÖrnekAchievementsIconMappings.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
Simgeyle ilgili kurallar
Simgeler 512 x 512 PNG, JPEG veya JPG dosyaları olarak oluşturulmalıdır. Bize yalnızca kilidi açılmış başarının simgesini göndermeniz yeterlidir. Ardından, görünür simgenin gri tonlamalı sürümü otomatik olarak oluşturulur. Bu nedenle, kullanıcılarınızın görünür ve kilidi açılan başarıları ayırt edebilmesi için başarı simgelerinizin renkli öğeler içermesini öneririz.
Android [toast][a] mesajında 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ıldığı için simgelere metin veya yerelleştirilmiş içerik eklemeniz önerilmez.
Simge dosyaları
AchievementsIconMappings.csv dosyasında referans verdiğiniz simgeler, içe aktardığınız mevcut ZIP arşivinde bulunmalıdır.
Mevcut başarıları içeren oyunları güncelleme
Google Play Console'da bir oyuna daha fazla başarı ekleyebilir ve mevcut başarıları güncelleyebilirsiniz.
Daha fazla başarı ekleme
Mevcut başarılarınız varsa ve daha fazla başarı eklemek istiyorsanız:
- Google Play Console'da bir oyun seçin.
- Google Play Games Hizmetleri - Başarılar sayfasında (Büyüme > Google Play Games Hizmetleri > Kurulum ve yönetim > Başarılar), Başarı ekle'yi seçin.
Başarıları düzenleme
Mevcut başarılarınız varsa ve bunları düzenlemek istiyorsanız:
- Google Play Console'da bir oyun seçin.
- Google Play Games Hizmetleri - Başarılar sayfasında (Büyüme > Google Play Games Hizmetleri > Kurulum ve yönetim > Başarılar) bir başarı seçin.
- Alanlardan herhangi birini düzenleyebilirsiniz.
- Taslak olarak kaydet'i tıklayın.
- Play Games Hizmetleri - Başarılar sayfasında, düzenlenen başarı "Test kullanıcıları tarafından kullanılabilir" durumundadır.
- Başarıyı test ettikten sonra İncele ve yayınla'yı tıklayın.
Bu işlem, oyununuzu ve güncellenmiş tüm başarılarınızı yeniden yayınlar.
Başarıları silme
Başarınız yayınlandıktan sonra silinemez. Yalnızca önceden yayınlanmış durumdaki bir başarıyı silebilirsiniz.
- Google Play Games Hizmetleri - Başarılar sayfasında bir başarı seçin.
- Başarıyı silmek için Başarıyı sil'i tıklayın.
Başarıları sıfırlama
Yalnızca taslak durumundaki başarılarınıza ait oyuncu ilerleme verilerini sıfırlayabilirsiniz.
- Google Play Games Hizmetleri - Başarılar sayfasında bir başarı seçin.
- Başarıları sıfırlamak için İlerlemeyi sıfırla'yı tıklayın.
- Başarı verilerini programatik olarak sıfırlamak için Management API
Achievementsyöntemlerini çağırın.
Başarıların çevirisini 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ı uyguladığınızdan emin olun.
Oyununuza iki şekilde çeviri ekleyebilirsiniz:
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 başarıyla ilgili çevirilerinizi ekleyerek formu 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:
Başarıları test etme
Başarıların amaçlandığı şekilde çalıştığını doğrulamak için test etme adımlarını uygulayın:
- Dahili test kanalı oluşturun.
- Test kullanıcıları için oyun projenize test hesapları ekleyin.
- Play Games uygulamasını kullanarak test hesaplarından biri için Play Games Hizmetleri profili oluşturun.
- Play Games Hizmetleri profilini oluşturduğunuz test hesabıyla oyunu açın.
- Play Games Hizmetleri "Hoş geldiniz" pop-up'ının, oyun başlatıldığında otomatik kimlik doğrulamanın başarılı olduğunu onaylamak için ekranda gösterildiğini doğrulayın.
- Oyunu oynayın ve başarıların kilidini açmak için gerekli adımları tamamlayın.
Başarıları doğrulamak için:
Başarı tamamlandığında ekranda "Başarı kilidi açıldı" pop-up'ının gösterildiğini doğrulayın.
Play Store uygulamasını açın ve Siz sekmesindeki başarılar bölümünde tamamlanan ve devam eden başarıların (ilerleme durumu ayrıntılarıyla birlikte) gösterildiğini doğrulayın.
Play Console'da başarı performansını izleme
Her bir başarıya özel istatistikleri hızlıca bulmak için:
- Google Play Console'da
- Ayarlar > Oyun projeleri'ne gidin.
- Bir oyun seçin.
- Sol taraftaki menüden Başarılar'ı tıklayın.
- Başarılar sayfanızda, oyuncularınızın başarıları açıp açmadığını anlamanıza yardımcı olacak istatistikler bulabilirsiniz. Başarıları gizlenmemiş kullanıcıların başarıların kilidini açma yüzdesini görebilirsiniz. Erken aşama başarılarında kilidi açma yüzdesi genellikle %100'e yakındır.
Ayrıca Büyüme > Google Play Games Hizmetleri > Oyun istatistikleri sayfasında başarıların zaman serisi performansını da takip edebilirsiniz.
Başarıları yayınlama
Testi tamamladıktan sonra oyununuzu yayınlamanız gerekir. Oyununuzdaki tüm başarılar da yayınlanır. Başarıların düzgün çalışması için yayınlanması gerekir.
Yayınlamak için şu adımları uygulayın:
- Google Play Console'da bir oyun seçin.
- Google Play Games Hizmetleri - Başarılar sayfasında (Büyüme > Google Play Games Hizmetleri > Kurulum ve yönetim > Başarılar), İncele ve yayınla'yı tıklayın.
- Google Play Games Hizmetleri - Yayınlama sayfasında (Büyüme > Google Play Games Hizmetleri > Kurulum ve yönetim > Yayınlama) işlemleri inceleyin ve sorunları düzeltin.
- Yayınla'yı tıklayın.
Oyununuzdaki tüm başarılar yayınlanır.
Sık yapılan ve sakınmanız gereken hatalar
Bu noktalarda, bir oyunda başarıları uygularken kaçınılması gereken yaygın hatalar vurgulanmaktadır. Aşağıdakilerin önemini vurgularlar:
Play Console'da Büyüme > Play Games Hizmetleri > Kurulum ve yönetim > Başarılar'a gidin.
- Yayınlamadan önce Play Console'da yapılandırılan başarıların "Taslak" durumunda olmadığını doğrulayın.
- Play Console'daki başarı kimliği değerlerini oyun koduna eklemeyin. Bunun yerine istemci uygulamalarını kullanın.
İstemcinizde kilit açma mantığını da uyguladığınızdan emin olun.
- Oyuncular, kilidi açma API'sinin çağrıldığı tetikleyici adımını atlayamaz. Örneğin, eğiticiyi tamamlamak bir başarıdır ancak oyuncular eğiticiyi atlayabilir.