Etkinlikler

Google Play Games etkinlik hizmeti, oyuncularınızın oyun sırasında oluşturduğu kümülatif verileri toplamanıza ve oyun analizi için Google'ın sunucularında saklamanıza olanak tanır. Oyununuzun hangi oyuncu verilerini toplaması gerektiğini esnek bir şekilde tanımlayabilirsiniz. Bu veriler, aşağıdakilerin gerçekleşme sıklığı gibi metrikleri içerebilir:

  • Oyuncuların belirli bir öğeyi kullanması
  • Oyuncuların belirli bir seviyeye ulaşması
  • Oyuncuların belirli bir oyun işlemini gerçekleştirmesi

Etkinlik verilerinden yararlanarak oyununuzu nasıl daha iyi hale getirebileceğinize dair fikir edinebilirsiniz. Örneğin, oyuncuların tamamlamakta zorlandığı belirli seviyelerin zorluk derecesini düzenleyebilirsiniz.

Platformunuzda etkinlikleri nasıl uygulayacağınızı öğrenmek için İstemci uygulamaları bölümüne bakın.

Oyununuza etkinlikleri entegre etme

Aşağıdaki iş akışında, oyununuzda etkinlikleri nasıl uygulayabileceğiniz açıklanmaktadır:

  1. Etkinlikleri tanımlayın. Oyununuzda toplanacak yeni etkinlikler tanımlamak için:
    1. Google Play Console'da oyununuzun Etkinlikler sayfasına gidin.
    2. Yeni etkinlik ekle düğmesini tıklayın ve etkinlik özelliklerini yapılandırın.
    3. Oyununuzda yaptığınız değişiklikleri yayınlama bölümünde açıklanan adımları uygulayarak etkinlik tanımlarınızı yayınlayın.

  2. Etkinlik API'lerini kullanarak etkinlik yakalama özelliğini oyununuza uygulayın. Örneğin, Android kodunuzda, oyununuz ilgilendiği bir etkinliğin tetiklendiğini her algıladığında increment yöntemini çağırın.

  3. Etkinlik verilerini görüntüleme Yakalanan etkinliklerin istatistiklerini görüntülemek için Google Play Console'da oyununuzun Etkinlikler sayfasına gidin.

Etkinliklerle ilgili temel bilgiler

Etkinlik API'leri, ilginç oyun metriklerini tanımlayıp toplamanıza ve bu metrikleri Play Games SDK'ya yüklemenize olanak tanır.

Bir Play Games SDK etkinliğinde şu temel özellikler bulunur:

Özellik Açıklama
ID Google Play Console tarafından bu etkinlik için oluşturulan benzersiz dize. Oyun istemcilerinizde etkinliğe referans vermek için bu benzersiz kimliği kullanın.
Ad Etkinlik için belirlediğiniz kısa bir ad. Ad en fazla 100 karakter uzunluğunda olabilir. Bu değer Google Play Console tarafından kullanılır ve oyununuzda gösterilebilir.

Örnekler:

  • "Öldürülen Zombi Sayısı"
  • "Toplanan Kırmızı Mücevher Sayısı"
Açıklama Etkinliğin daha uzun bir açıklaması (örneğin, "Bir oyuncunun öldürdüğü zombi sayısı" veya "Oyuncunun yok ettiği ve eşleştirdiği toplam kırmızı mücevher sayısı"). Açıklama en fazla 500 karakter uzunluğunda olabilir. Bu değer Google Play Console tarafından kullanılır ve oyununuzda gösterilebilir.
Etkinlik türü

Etkinliğin izlediği veri türünü bildiren bir alan. Bu değer, Google Play Console tarafından Oyuncu Analizi raporlarında kullanılır.

İki etkinlik türü desteklenir:

Premium para birimi kaynağı
Premium para birimi kaynaklarını izleyen etkinlikler için bu türü seçin. Örneğin:
  • "Kazanılan altın para miktarı"
  • "Satın alınan zümrüt sayısı"
Premium para birimi havuzu
Premium para birimi havuzlarını veya tüketimini izleyen etkinlikler için bu türü seçin. Örneğin:
  • "Harcanan altın para miktarı"
  • "Kullanılan zümrüt sayısı"
Simge Etkinliğinizle ilişkilendirilecek kare bir simge.

Etkinlik oluşturma

Oyununuza eklenecek yeni bir etkinlik oluşturmak için aşağıdaki adımları uygulayın:

  1. Google Play Console'da, soldaki Oyun hizmetleri simgesini tıklayın ve oyununuzun girişini seçin.
  2. Solda Etkinlikler sekmesini seçin ve Etkinlik ekle düğmesini tıklayın.
  3. Oluşturmak istediğiniz etkinliğin ayrıntılarını girin.
  4. Kaydet'i tıklayın. Hata yoksa etkinliğiniz "Yayınlanmaya hazır" durumuna getirilir. Artık oyunda yaptığınız değişiklikleri yayınlamaya devam edebilirsiniz.

Etkinlikleri düzenleme

Oluşturduğunuz bir etkinliği düzenlemek için:

  1. Google Play Console'da Etkinlikler sekmesini açıp düzenlemek istediğiniz etkinliğin girişini seçin. Etkinliği oluştururken kullandığınız formu göreceksiniz.
  2. Gerekli değişiklikleri yapın.
  3. Etkinliği düzenlemeyi bitirdiğinizde Kaydet düğmesini tıklayın.
  4. Değiştirilen etkinliğin doğru şekilde uygulandığından emin olmak için oyununuzu test edin. Düzgün çalışıyorsa oyunda yaptığınız değişiklikleri yayınlayın.

Etkinlik silme

Taslak durumunda olan veya yayınlanmış etkinlikleri silebilirsiniz. Google Play Console'da bir etkinliği silmek için ilgili etkinlik formunun alt kısmındaki Sil düğmesini tıklayın.

Etkinlik verilerini sıfırlama

Etkinliklerinizin test kullanıcılarına ait oyuncu ilerleme verilerini sıfırlayabilirsiniz.

  • Google Play Console'da taslak etkinlikleri sıfırlamak için ilgili etkinlik formunun alt kısmındaki Etkinlik ilerleme durumunu sıfırla düğmesini tıklayın.
  • Etkinlik verilerini programatik olarak sıfırlamak için Management API Events yöntemlerini çağırın.

İstemci uygulamaları

Platformunuzda etkinlikleri nasıl uygulayacağınızı öğrenmek için aşağıdaki kaynaklara göz atabilirsiniz: