Oyun İstatistiklerini entegre etme

Bu belgede, Google Play Console'u kullanarak Oyun İstatistikleri'ni oyununuza nasıl entegre edeceğiniz açıklanmaktadır. Temel CSV ve ZIP dosyası biçimlerini kapsar ve bunları nasıl oluşturacağınız, içe aktaracağınız ve yöneteceğiniz açıklanır.

Etkinlik oluşturma

Yeni ve yayınlanmamış bir oyun için etkinlik oluşturmak istiyorsanız aşağıdaki adımları uygulayın:

  1. Etkinlikler CSV dosyası PlayerGameEvent.csv'yi 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) Etkinlikleri ayarlayın'ı seçin.
  4. Etkinlik yapılandırması sayfasında, yüklenecek CSV dosyasını sürükleyip bırakın.
  5. Etkinlik oluşturduktan sonra istatistikleri ayarlamanız gerekir.

İstatistikleri ayarlama

Bir etkinlik oluşturduktan sonra istatistikleri ayarlamanız gerekir:

  1. İstatistikleri, yerelleştirmeleri ve simge dosyalarını içeren ZIP dosyasını oluşturun. İstatistikler için ZIP dosyası yönergeleri.
  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) İstatistikleri ayarlayın'ı seçin.
  4. Oyun İstatistikleri yapılandırması sayfasında, yüklenecek ZIP dosyasını bırakın.
  5. Tüm istatistikleri yükledikten sonra oyununuzu yayınlayabilirsiniz.

Test Oyun İstatistikleri

Oyun İstatistikleri'nin 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 bildirimi"nin, 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.
  • Test hesabı kullanıcısı, etkinlikleri tetiklemek için oyunu oynayabilir. Etkinliklerin kaydedilip kaydedilmediğini öğrenmek için API yanıtını kontrol edin.

Oyun istatistiklerini yayınlama

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

Yayınlamak için şu 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) İnceleyin ve yayınlayın'ı 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 inceleyin ve sorunları düzeltin.
  4. Yayınla'yı tıklayın. Tüm oyun istatistikleriniz yayınlanır.

Oyun istatistiklerini silme

Oyun istatistikleri yayınlandıktan sonra silinemez.

Etkinlikler için CSV dosyası yönergeleri

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

PlayerGameEvent.csv biçimi

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

 Event Name,Property Name,Property Type

progressionStat için progressUpdate etkinliğini gönderiyorsanız 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 En fazla 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 En fazla 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.

Aşağıdaki ayrılmış anahtar kelimeleri kullanmayın: id, count, key, value, where, from, and, or, true veya false.
Mülk Türü Zorunlu Büyük/küçük harfe duyarlı, desteklenen veri türlerinden biriyle eşleşen 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 Tekrarlayan bir istatistik, oyuncular tarafından düzenli olarak gerçekleştirilen oyun içi işlemleri ifade eder.
ProgressionStatConfig.csv Zorunlu İlerleme istatistiği, oyuncunun bir oyundaki ilerlemesini gösterir.
StatLocalizations.csv İsteğe bağlı Oyun istatistikleri 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 dosya boyutu sınırı: Sıkıştırılmamış maksimum toplam boyut 10 MB'tır.
  • 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 istatistiklerini yüklemek istiyorsanız ZIP dosyasına tekrarlayan istatistikler CSV dosyasını eklemeyin. Aksi takdirde konsol hata verir. Yalnızca tekrarlayan istatistikleri yüklemek istiyorsanız da aynı durum geçerlidir.
  • Simge resim dosyaları: PNG (.png) veya JPEG (.jpg, .jpeg).
    • CSV dosyalarında referans verilen tüm simgeler, ZIP dosyasının kök dizininde bulunmalıdır.
    • ZIP dosyasında bulunan tüm resim dosyaları 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, aşağıdaki sırayla virgülle ayrılmış değerler olarak bildirilmiş etkinliği ve özelliklerini 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 En fazla 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 En fazla 50 karakter
İstatistik Görünen Adı Zorunlu Maksimum 50 karakter
İstatistik için varsayılan görünen ad (varsayılan yerel ayar). İstatistikler arasında benzersiz olmalıdır.
Stat Description Zorunlu Maksimum 500 karakter
İstatistik için varsayılan açıklama.
Toplama Türü Zorunlu Maksimum 50 karakter
SUM, MAX, MIN, COUNT.
Özelliği Filtrele İsteğe bağlı En fazla 50 karakter
PlayerGameEvent.csv dosyasında tanımlanmış 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ıldı. Filtre değeri INT64, DOUBLE, BOOL, STRING olmalıdır.
Rekabetçi Zorunlu true, false
Minimum sınır Is Competitive doğru olduğunda zorunludur. Rekabetçi istatistikler için izin verilen minimum skor.
Maksimum sınır Is Competitive doğru olduğunda zorunludur. Rekabetçi istatistikler için izin verilen maksimum skor.
Simge Dosyası Adı Zorunlu ZIP dosyasının kök dizininde bulunan simge resminin dosya adı. Tekrarlayan istatistiklerde kullanılan simge dosyası adlarıyla çakışamaz.
İyi değer yönü Zorunlu Yüksek değerlerin INCREASING mi yoksa 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
Stat ID Etkinlik Adı Mülk Adı Toplama İstatistik Görünen Adı Stat Description Özelliği 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ı) Sıra numarası İ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 1 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 2 Artma
3 matchCompleted öldürme TOPLA Bire bir maçta öldürme Bire bir maçlarda yapılan öldürme sayısı matchType = "1-on-1" YANLIŞ stat4.png 4 Artma
4 itemCollected coinsAmount TOPLA Toplanan Toplam Altın Oyuncu, maçta oynarken para topluyor weaponType = "sword" YANLIŞ stat2.png 3 Artma

ProgressionStatConfig.csv biçimi

CSV dosyasında, aşağıdaki sırayla virgülle ayrılmış değerler olarak belirtilen etkinlik ve özellikleri yer alır:

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

İlerleme durumu istatistiği, oyuncunun oyuncu profilinde ilk gösterilen istatistik olur.

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 En fazla 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 En fazla 50 karakter

PlayerGameEvent.csv biçiminde tanımlanan etkinlik adına referans vermelidir.
Etkinlik Özelliği Adı Zorunlu En fazla 50 karakter

PlayerGameEvent.csv dosyasında tanımlanmış bir Tesis Adı olmalıdır.
İstatistik Görünen Adı Zorunlu Benzersiz bir ad olmalıdır.
Stat Description Zorunlu En fazla 50 karakter
İstatistik için varsayılan açıklama.
Simge Dosyası Adı Zorunlu ZIP dosyasının kök dizininde bulunan simge resminin dosya adı. Tekrarlayan istatistiklerde kullanılan simge dosyası adlarıyla çakışamaz.
İyi değer yönü Zorunlu Yüksek değerlerin INCREASING mi yoksa 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
Statü 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ç oynayarak XP kazanır ve seviye atlar. Level.png artıyor

StatLocalizations.csv biçimi

CSV dosyasında, aşağıdaki sırayla virgülle ayrılmış değerler olarak belirtilen etkinlik ve özellikleri yer alır:

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 En fazla 100 karakter

Yalnızca harf, rakam ve alt çizgilerden oluşmalıdır. Oyundaki tüm istatistikler arasında benzersiz olmalıdır.
İstatistik 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 unutmayın.

Desteklenen yerel ayar kodlarını desteklenen diller listesinde bulabilirsiniz.
Yerelleştirilmiş İstatistik Görünen Adı İsteğe bağlı En fazla 50 karakter. Belirli 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
Statü Kimliği İstatistik Görünen Adı Language Code 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 özelliği Zorunlu kısıtlama / kural
Maksimum dosya boyutu Simge dosyası başına en fazla 1 MB (1.048.576 bayt).
Boyutlar Tam olarak 512 × 512 piksel (genişlik = 512, yükseklik = 512)
En boy oranı Kesinlikle 1:1 (kare en boy oranı)
İzin verilen biçimler PNG (.png) ve JPEG (.jpg, .jpeg)
ZIP'deki yerleşim ZIP dosyasındaki kök dizinde bulunmalıdır.
Referans verilen çek Simge Dosyası Adı sütunlarında belirtilen tüm simge dosyası adları ZIP dosyasında bulunmalıdır.
Orphan Check 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ışmamalıdır.
Görsel Yinelenenler Yinelenen simgeler işaretlenir.

Simgeyle ilgili kurallar

Simgeler 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
% / YÜZDE / 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)

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

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