Oyun İstatistiklerini entegre etme

Bu belgede, Google Play Console'u kullanarak Oyun İstatistikleri'ni oyununuza nasıl entegre edeceğiniz açıklanmaktadır. Bu bölümde, temel CSV ve ZIP dosyası biçimleri ele alınmakta ve bunların nasıl oluşturulacağı, içe aktarılacağı ve yönetileceği açıklanmaktadır.

Etkinlik oluşturma veya içe aktarma

Google Play Console'u kullanarak ilk kez etkinlik eklemek için iki yöntem bulunur:

Etkinlik oluşturma

Bir oyun için etkinlik oluşturmak istiyorsanız aşağıdaki adımları uygulayın:

  1. Google Play Console'da bir oyun seçin.
  2. Google Play Games Hizmetleri - Oyun İstatistikleri sayfasında (Kullanıcı sayısını artırın > Google Play Games Hizmetleri > Kurulum ve yönetim > Oyun İstatistikleri) Etkinlik ekle > Etkinlik oluştur'u seçin.
  3. Etkinlik oluştur sayfasında formu doldurun.
  4. Değişiklikleri kaydet'i tıklayın.

Etkinlikleri içe aktar

Oyununuza aynı anda birden fazla etkinlik eklemek için aşağıdaki adımları uygulayın:

  1. Etkinlikler CSV dosyasını (PlayerGameEvent.csv) oluşturun.
  2. Google Play Console'da bir oyun seçin.
  3. Google Play Games Hizmetleri - Oyun İstatistikleri sayfasında (Kullanıcı sayısını artırın > Google Play Games Hizmetleri > Kurulum ve yönetim > Oyun İstatistikleri), Etkinlik ekle > CSV ile içe aktar'ı seçin.
  4. Etkinlik yapılandırması sayfasında, yüklemek istediğiniz CSV dosyasını sürükleyip bırakın.
  5. Etkinlik oluşturduktan sonra istatistikleri ayarlayın.

İstatistik oluşturma veya içe aktarma

Google Play Console'u kullanarak ilk kez istatistik eklemek için iki yöntem bulunur:

İstatistik oluştur

Bir oyun için istatistik oluşturmak istiyorsanız aşağıdaki adımları uygulayın:

  1. Google Play Console'da bir oyun seçin.
  2. Google Play Games Hizmetleri - Oyun İstatistikleri sayfasında (Kullanıcı sayısını artırın > Google Play Games Hizmetleri > Kurulum ve yönetim > Oyun İstatistikleri) İstatistik ekle > İstatistik oluştur'u seçin.
  3. İstatistik oluştur sayfasında formu doldurun.
  4. Değişiklikleri kaydet'i tıklayın.
  5. İstatistik oluşturduktan sonra oyununuzu yayınlayın.

İstatistikleri içe aktarma

İstatistikleri içe aktarmak için aşağıdaki adımları uygulayın:

  1. İstatistikler için ZIP dosyası yönergelerine uygun şekilde istatistikleri, yerelleştirmeleri ve simge dosyalarını içeren ZIP dosyasını oluşturun.
  2. Google Play Console'da bir oyun seçin.
  3. Google Play Games Hizmetleri - Oyun İstatistikleri sayfasında (Kullanıcı sayısını artırın > Google Play Games Hizmetleri > Kurulum ve yönetim > Oyun İstatistikleri) İstatistik ekle > ZIP ile içe aktar'ı seçin.
  4. Oyun İstatistikleri yapılandırması sayfasında, yüklemek istediğiniz ZIP dosyasını bırakın.
  5. Tüm istatistikleri yükledikten sonra oyununuzu yayınlayın.

Oyun İstatistiklerini test etme

Oyun İstatistikleri'nin amaçlandığı şekilde çalıştığını doğrulamak için aşağıdaki test adımlarını uygulayın:

  • Google Play Store uygulamasını açın.
  • Google Play Store uygulamasında Google Play Games profilinizde oturum açın.
  • Oyuncu profilinizde Oyun istatistiklerinizi görüntüleyin.

Cihazınızdaki günlükleri görüntüleme

Oyun İstatistikleri'nin tasarlandığı şekilde çalıştığını doğrulamak için cihazınızda günlükleri etkinleştirin:

  1. Cihazınızda adb hata ayıklamayı etkinleştirin ve bir terminalde aşağıdaki komutları çalıştırın:

    adb shell setprop log.tag.Games INFO
adb logcat -s "PlayGamesServices[GameStatsAgent]:I"

  2. Aşağıdaki örnekte gösterildiği gibi, başarılı bir günlük mesajının göründüğünü doğrulayın:

    Successfully uploaded batch of X events.

    Not: API, kısmi yüklemeleri desteklediğinden bu bilgi günlüğü, grubun işlendiğini gösterir. Gruptaki bağımsız etkinliklerden herhangi biri şema doğrulamasında başarısız olursa bu mesajdan önce bir hata günlüğü gösterilir.

  3. Gönderilen etkinliklerden herhangi biri doğrulamadan geçemezse hatayı ayrıntılı olarak açıklayan bir hata mesajı görürsünüz:

    BatchRecordEvents validation failed for X event(s): ...

Oyun İstatistiklerini yayınlama

Testi tamamladıktan sonra oyununuzu yayınlamanız gerekir. Oyununuzdaki tüm etkinlikler ve istatistikler de yayınlanır.

Yayınlamak için aşağıdaki adımları uygulayın:

  1. Google Play Console'da bir oyun seçin.
  2. Google Play Games Hizmetleri - Oyun İstatistikleri sayfasında (Kullanıcı sayısını artırın > Google Play Games Hizmetleri > Kurulum ve yönetim > Oyun İstatistikleri) İncele ve yayınla'yı tıklayın.
  3. Google Play Games Hizmetleri - Yayınlama sayfasında (Kullanıcı sayısını artırın > Google Play Games Hizmetleri > Kurulum ve yönetim > Yayınlama) işlemleri inceleyip sorunları düzeltin.
  4. Yayınla'yı tıklayın. Tüm Oyun İstatistikleriniz yayınlanır.

Oyun İstatistiklerini Düzenleme

Mevcut Oyun İstatistikleriniz varsa ve bunları düzenlemek istiyorsanız:

  1. Google Play Console'da bir oyun seçin.
  2. Google Play Games Hizmetleri - Oyun İstatistikleri sayfasına (Kullanıcı sayısını artırın > Google Play Games Hizmetleri > Kurulum ve yönetim > Oyun İstatistikleri) gidin.
  3. Bir etkinliği düzenlemek için:
    1. Etkinlik yapılandırması bölümünde bir etkinlik seçin.
    2. Etkinlik özellikleri ekleyebilir veya silebilirsiniz.
      • Etkinlik Adı'nı düzenleyemezsiniz.
    3. Değişiklikleri kaydet'i tıklayın.
  4. Bir istatistiği düzenlemek için:
    1. Oyun İstatistikleri yapılandırması bölümünde bir istatistik seçin.
    2. İstatistik adı, İstatistik açıklaması ve Simge dosya adı alanlarını düzenleyebilirsiniz.
      • İstatistik kimliği ve İlerleme yönü'nü düzenleyemezsiniz. İstatistik birimi ve İlişkili etkinlik ayrıntıları.
    3. Değişiklikleri kaydet'i tıklayın.
  5. Google Play Games Hizmetleri - Oyun İstatistikleri sayfasında, düzenlenen istatistik Test kullanıcıları tarafından kullanılabilir durumundadır.
  6. İstatistiği test ettikten sonra İncele ve yayınla'yı tıklayın. Bu işlem, oyununuzu ve güncellenmiş tüm istatistiklerinizi yeniden yayınlar.

Oyun İstatistiklerini Silme

Oyun İstatistikleri yayınlandıktan sonra silinemez.

Test kullanıcıları tarafından kullanılabilir durumundaki bir etkinliği veya istatistiği silebilirsiniz.

  1. Google Play Console'da bir oyun seçin.
  2. Google Play Games Hizmetleri - Oyun İstatistikleri sayfasına (Kullanıcı sayısını artırın > Google Play Games Hizmetleri > Kurulum ve yönetim > Oyun İstatistikleri) gidin.
  3. Bir etkinliği silmek için:
    1. Etkinlik yapılandırması bölümünde bir etkinlik seçin.
    2. Etkinliği sil'i tıklayın.
  4. Bir istatistiği silmek için:
    1. Oyun İstatistikleri yapılandırması bölümünde, silmek istediğiniz istatistiği seçin.
    2. Oyun istatistiğini sil'i tıklayın.

Etkinlikler için CSV dosyası yönergeleri

CSV dosyasının ilk satırı başlık satırıdır. Etkinlikleri, etkinlik CSV dosyasını (ör. PlayerGameEvent.csv) kullanarak içe aktarmanız gerekir.

PlayerGameEvent.csv biçimi

CSV, tanımlanan etkinliği ve özelliklerini aşağıdaki sırayla virgülle ayrılmış değerler olarak içerir:

 Event Name,Property Name,Property Type

progressionStat için progressUpdate etkinliğini gönderirseniz bu etkinlik için bir satır ekleyin. Bu etkinlik, INT veya STRING türünde en az bir currentProgress özelliği ve göndermek istediğiniz diğer özellikleri içermelidir.

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
Etkinlik Adı Zorunlu Maksimum 50 karakter

Yalnızca harf, rakam ve alt çizgilerden oluşmalıdır.

progressUpdate özel etkinlik adı kullanılıyorsa INT64 veya STRING türünde currentProgress adlı bir özellik içermelidir.
Mülk Adı Zorunlu Maksimum 50 karakter

Yalnızca harf, rakam ve alt çizgilerden oluşmalıdır.

Etkinlik başına benzersiz: Özellik adları aynı etkinlik içinde benzersiz olmalıdır.

Şu ayrılmış anahtar kelimeleri kullanmayın: id, count, key, value, where, from, and, or, true veya false.
Mülk Türü Zorunlu Desteklenen veri türlerinden biriyle eşleşen, büyük/küçük harfe duyarlı enum dizesi: INT64, DOUBLE, STRING, BOOL

PlayerGameEvent.csv dosyasıyla ilgili şartlar:

  • Dosya, etkinlik başına en fazla 20 özellik olmak üzere en fazla 20 benzersiz etkinlik adını destekler.
  • Dosya içeriği boş olamaz ve en az 1 satır içermelidir.
Example table
Etkinlik Adı Mülk Adı Mülk Türü
matchCompleted süre DOUBLE
matchCompleted öldürme INT64
matchCompleted isWinner BOOL
matchCompleted matchType STRING
itemCollected coinsAmount INT64
itemCollected weaponType STRING
progressUpdate currentProgress INT64

İstatistikler için ZIP dosyası yönergeleri

ZIP dosyası kullanarak istatistikleri 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
RepetitiveStatsConfig.csv Zorunlu Tekrarlanan istatistikler, oyuncular tarafından düzenli olarak gerçekleştirilen oyun içi işlemleri temsil eder.
ProgressionStatConfig.csv Zorunlu İlerleme istatistiği, oyuncunun oyundaki ilerleme durumunu gösterir.
StatLocalizations.csv İsteğe bağlı Oyun İstatistikleri adları ve açıklamalarını çevirir.
Simge dosyaları Zorunlu 512 x 512 PNG, JPEG veya JPG biçimindeki simgeler.

ZIP dosyası aşağıdaki koşulları karşılamalıdır:

  • ZIP dosyası boyutu sınırı: Sıkıştırılmamış toplam boyut en fazla 10 MB olabilir.
  • Maksimum dosya sayısı: ZIP arşivinde toplamda en fazla 53 dosya (3 CSV ve 50 simge) bulunabilir.
  • Maksimum birleştirilmiş istatistik sınırı: ProgressionStatConfig.csv ve RepetitiveStatsConfig.csv genelinde toplamda en fazla 50 istatistik.
  • Desteklenen CSV dosyaları: ProgressionStatConfig.csv, RepetitiveStatsConfig.csv ve StatLocalizations.csv (isteğe bağlı). Yalnızca ilerleme durumu istatistiği yüklemek istiyorsanız tekrarlanan istatistikler CSV dosyasını ZIP dosyasına eklemeyin. Aksi takdirde konsol hata verir. Yalnızca tekrarlanan istatistikleri yüklemek istiyorsanız da aynı durum geçerlidir.
  • Simge resim dosyaları: PNG (.png) veya JPEG (.jpg, .jpeg).
    • CSV'lerde referans verilen tüm simgeler ZIP dosyasının kök dizininde bulunmalıdır.
    • ZIP dosyasındaki tüm resim dosyalarına en az bir istatistik tarafından referans verilmelidir.
  • Dizin yapısı: Tüm dosyalar ZIP dosyasının kök dizininde bulunmalıdır. Alt dizinlere izin verilmez.

RepetitiveStatsConfig.csv biçimi

CSV, tanımlanan etkinliği ve özelliklerini aşağıdaki sırayla virgülle ayrılmış değerler olarak içerir:

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

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
İstatistik Kimliği Zorunlu Maksimum 100 karakter

Yalnızca harf, rakam ve alt çizgilerden oluşmalıdır. Oyundaki tüm istatistikler arasında benzersiz olmalıdır.
Etkinlik Adı Zorunlu Maksimum 50 karakter

PlayerGameEvent.csv biçiminde tanımlanan Etkinlik Adı'na referans vermelidir.
Etkinlik Özelliği Adı Zorunlu Maksimum 50 karakterdir.
İstatistiğin Görünen Adı Zorunlu Maksimum 50 karakter
İstatistiğin varsayılan görünen adı (varsayılan yerel ayar). İstatistikler genelinde benzersiz olmalıdır.
Stat Description Zorunlu Maksimum 500 karakter
İstatistiğin varsayılan açıklaması.
Toplama Türü Zorunlu Maksimum 50 karakter
SUM, MAX, MIN, COUNT.
Mülkü filtrele İsteğe bağlı En fazla 50 karakter
PlayerGameEvent.csv dosyasında tanımlanan bir özellik adı olmalıdır.
Filtre Operatörü İsteğe bağlı =, !=, >, <, >=, <=
Filtre karşılaştırma operatörleri.
Filtre Değeri İsteğe bağlı Filtre özelliğiyle karşılaştırılır. Filtre değeri INT64, DOUBLE, BOOL, STRING olmalıdır.
Rekabetçi Zorunlu true, false
Alt sınır Rekabetçi mi? alanı doğru olarak ayarlandığında zorunludur. Rekabet istatistikleri için izin verilen minimum puan.
Maksimum sınır Rekabetçi mi? alanı doğru olarak ayarlandığında zorunludur. Rekabet istatistikleri için izin verilen maksimum puan.
Simge Dosyası Adı Zorunlu ZIP dosyasının kök dizinine eklenen simge resminin dosya adı. Tekrarlanan istatistiklerde kullanılan simge dosya adlarıyla çakışamaz.
İyi değer yönü Zorunlu Daha yüksek değerlerin INCREASING mi yoksa daha düşük değerlerin DECREASING mi daha iyi olduğunu belirtir.
Birim İsteğe bağlı Ham sayısal veya süre değerleri için ölçü birimi. Örneğin, KILOMETER, SECOND, PERCENTAGE, UNITLESS.

Filtre koşulunu kullanmak istemiyorsanız hücreyi boş bırakın.

Example table
İstatistik kimliği Etkinlik Adı Mülk Adı Toplama İstatistiğin Görünen Adı Stat Description Mülkü filtrele (isteğe bağlı) Filtre operatörü (isteğe bağlı) Filtre değeri (isteğe bağlı) Rekabetçi minLimit maxLimit Icon filename (Simge dosyası adı) İyi değer yönü birim
1 matchCompleted süre MAKS. En Uzun Eşleşme Hayatta Kalma Bu, bir oyuncunun herhangi bir maçta hayatta kalma süresini gösterir. isWinner = DOĞRU DOĞRU 0 50 stat1.png Azalma saniye
2 matchCompleted isWinner COUNT Kazanılan Maçlar Bu, bir oyuncunun kazandığı maç sayısını gösterir. isWinner = DOĞRU DOĞRU 0 50 stat3.png Artma
3 matchCompleted öldürme SUM Bire bir maçta öldürme sayısı Bire bir maçlarda yapılan öldürme sayısı matchType = "Bire bir" YANLIŞ stat4.png Artma
4 itemCollected coinsAmount SUM Toplanan Toplam Altın Maç sırasında para toplayan oyuncu weaponType = "kılıç" YANLIŞ stat2.png Artma

ProgressionStatConfig.csv biçimi

CSV, tanımlanan etkinliği ve özelliklerini aşağıdaki sırayla virgülle ayrılmış değerler olarak içerir:

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

İlerleme istatistiği, oyuncunun oyuncu profilinde ilk istatistik olarak gösterilir.

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
İstatistik Kimliği Zorunlu Maksimum 100 karakter

Yalnızca harf, rakam ve alt çizgilerden oluşmalıdır. Oyundaki tüm istatistikler arasında benzersiz olmalıdır.
Etkinlik Özelliği Adı Zorunlu Maksimum 50 karakter

PlayerGameEvent.csv dosyasında tanımlanan bir özellik adı olmalıdır.
İstatistiğin Görünen Adı Zorunlu Benzersiz bir ad olmalıdır.
Stat Description Zorunlu Maksimum 50 karakter
İstatistiğin varsayılan açıklaması.
Simge Dosyası Adı Zorunlu ZIP dosyasının kök dizinine eklenen simge resminin dosya adı. Tekrarlanan istatistiklerde kullanılan simge dosya adlarıyla çakışamaz.
İyi değer yönü Zorunlu Daha yüksek değerlerin INCREASING mi yoksa daha düşük değerlerin DECREASING mi daha iyi olduğunu belirtir.
Birim İsteğe bağlı Ham sayısal veya süre değerleri için ölçü birimi. Örneğin, KILOMETER, SECOND, PERCENTAGE, UNITLESS.
Example table
İstatistik kimliği Etkinlik Özelliği Adı İstatistik Görünen Adı İstatistik Açıklaması Simge Dosyası Adı İyi değer yönü
5 currentProgress Seviye Oyuncular maç yaparak XP kazanır ve seviye atlar. Level.png artma

StatLocalizations.csv biçimi

CSV, tanımlanan etkinliği ve özelliklerini aşağıdaki sırayla virgülle ayrılmış değerler olarak içerir:

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

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
İstatistik Kimliği Zorunlu Maksimum 100 karakter

Yalnızca harf, rakam ve alt çizgilerden oluşmalıdır. Oyundaki tüm istatistikler arasında benzersiz olmalıdır.
İstatistiğin Görünen Adı Zorunlu Benzersiz bir ad olmalıdır.
Yerel ayar Zorunlu Yerel ayar kodu (ör. tr-TR).
Yerel ayar belirtmeden önce oyununuz için çeviri ekleyin. Varsayılan yerel ayar belirtemeyeceğinizi hatırlatırız.

Desteklenen yerel ayar kodlarını desteklenen diller listesinde bulabilirsiniz.
Yerelleştirilmiş İstatistik Görünen Adı İsteğe bağlı Maksimum 50 karakter. Belirli bir yerel ayar için çevrilmiş istatistik görünen adı.
Yerelleştirilmiş İstatistik Açıklaması İsteğe bağlı Maksimum 500 karakter. Belirtilen yerel ayar için çevrilmiş istatistik açıklaması.
Example table
İstatistik kimliği İstatistiğin Görünen Adı Dil Kodu Yerelleştirilmiş İstatistik Adı (UTF-8) Yerelleştirilmiş İstatistik Açıklaması (UTF-8)
1 En Uzun Eşleşme Hayatta Kalma es Supervivencia más larga en partidos Esto denota el tiempo de supervivencia de una jugadora en cualquier partido.
1 En Uzun Eşleşme Hayatta Kalma fr Survie du match le plus long Cela indique la durée de survie d'un joueur dans n'importe quel match.
4 Toplanan Toplam Altın es Oro total recolectado La jugadora recoge monedas mientras juega en un partido
4 Toplanan Toplam Altın fr Or total collecté Le joueur collecte des pièces en jouant un match

Simge dosyaları

CSV dosyasında referans verdiğiniz simgeler, içe aktardığınız mevcut ZIP arşivinde bulunmalıdır.

Simge doğrulama kuralları şunlardır:

Doğrulama mülkü Zorunlu kılınan kısıtlama/kural
Maksimum dosya boyutu Simge dosyası başına maksimum 1 MB (1.048.576 bayt).
Boyutlar Tam olarak 512 × 512 piksel (genişlik = 512, yükseklik = 512)
En boy oranı Tam olarak 1:1 (kare en-boy oranı)
İzin Verilen Biçimler PNG (.png) ve JPEG (.jpg, .jpeg)
ZIP'teki yerleşim ZIP dosyasındaki kök dizinde bulunmalıdır.
Referans Verilen Çek Simge Dosya Adı sütunlarında belirtilen tüm simge dosya adları ZIP dosyasında bulunmalıdır.
Sahipsiz öğe kontrolü ZIP dosyasındaki tüm resim dosyalarına en az bir istatistik tarafından referans verilmelidir.
Çakışma Kontrolü ProgressionStatConfig.csv içindeki simge dosyası adları, RepetitiveStatsConfig.csv ile çakışamaz.
Görsel olarak yinelenenler Yinelenen simgeler işaretlenir.

Simgeyle ilgili kurallar

Simgeler, arka planı şeffaf olan 512 x 512 PNG, JPEG veya JPG dosyaları olarak oluşturulmalıdır.

Tüm yerel ayarlarda aynı simge kullanıldığı için simgelere metin veya yerelleştirilmiş içerik eklemeniz önerilmez.

Birim özellikleri

Birim sütunları, ham istatistik değerlerinin oyuncular için nasıl biçimlendirileceğini ve yerelleştirileceğini kontrol eder.

Sayısal istatistik özellikleri (INT64, DOUBLE)

İzin Verilen Birim Değeri Örnek Ham Değer
(Boş) / BİRİMSİZ / YOK 1234567
% / PERCENTAGE / PERCENT 0,857
Mesafe/Uzunluk: CENTIMETER, METER, KILOMETER, FOOT, INCH, MILE, YARD, MILLIMETER, NANOMETER 15 (KİLOMETRE)
Hız: KILOMETER_PER_HOUR, METER_PER_SECOND, MILE_PER_HOUR 60 (MILE_PER_HOUR)

Süre istatistiği özellikleri (DURATION)

Biçim Kategorisi Değeri İzin Verilen Birim Değerleri Örnek Ham Değer Biçimlendirilmiş çıkış örneği
BİRİM TABANLI / SÜRE Zorunlu: SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, YEAR 5.400 saniye (SAAT) 1,5 saat
COMPONENT_NUMERIC / HH:MM:SS / CLOCK Ayrıntı düzeyi (İsteğe bağlı, varsayılan WHOLE_SECONDS): WHOLE_MINUTES, WHOLE_SECONDS, MILLISECONDS_ONE_DIGIT, MILLISECONDS_TWO_DIGITS, MILLISECONDS_THREE_DIGITS 3.661 saniye 01:01:01
COMPONENT_TEXT / TEXT En Küçük Birim (İsteğe bağlı, varsayılan SECONDS): SECONDS, MINUTES, HOURS, DAYS, MONTHS, YEARS 90.000 saniye 1 gün 1 sa.

Sayısal Olmayan İstatistik Özellikleri (STRING, BOOL)

Birim sütunları boş bırakılmalıdır.