Etkinlikler

Google Play Games etkinlik hizmeti, oyun sırasında oyuncularınız tarafından oluşturulan kümülatif verileri toplamanıza ve oyun analizleri için Google'ın sunucularında depolamanıza olanak tanır. Oyununuzun toplaması gereken oyuncu verilerini esnek bir şekilde tanımlayabilirsiniz. Bu metrik, aşağıdaki gibi metrikleri içerebilir:

  • Oyuncular belirli bir öğeyi kullanır
  • Oyuncular belirli bir seviyeye ulaşır
  • Oyuncular belirli bir oyun işlemi gerçekleştirirler

Oyununuzu nasıl iyileştireceğinizle ilgili geri bildirim olarak etkinlik verilerini kullanabilirsiniz. Örneğin, oyununuzda oyuncuların tamamlamakta zorlandığı belirli seviyelerin zorluk seviyesini ayarlayabilirsiniz.

Platformunuza nasıl etkinlik uygulayacağınızı öğrenmek için İstemci uygulamaları bölümünü inceleyin.

Oyununuza etkinlikleri entegre etme

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

  1. Etkinlikleri tanımlama. Oyununuzda yakalayacağınız yeni etkinlikleri 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. Oyun değişikliklerinizi yayınlama bölümünde açıklanan adımları uygulayarak etkinlik tanımlarınızı yayınlayın.
  2. Olay API'lerini kullanarak oyununuzda etkinlik yakalamayı uygulayın. Örneğin, Android kodunuzda oyun, önem verdiği bir etkinliğin tetiklendiğini algıladığında etkinlikler increment yöntemini çağırın.

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

Etkinlikle ilgili temel bilgiler

Etkinlik API'ları, ilginç oynanabilirlik metriklerini tanımlayıp toplamanın ve bu metrikleri Google Play oyun hizmetlerine yüklemenin bir yolunu sunar.

Google Play oyun hizmetleri etkinliği aşağıdaki önemli özellikleri içerir:

Özellik Açıklama
Kimlik Bu etkinlik için Google Play Console tarafından oluşturulan benzersiz bir dizedir. Oyun istemcinizdeki etkinliğe atıfta bulunmak için bu benzersiz kimliği kullanın.
Ad Etkinliğin kısa adı. Ad en fazla 100 karakter olabilir. Bu değer Google Play Console tarafından kullanılır ve oyununuzda gösterilebilir.

Örnekler:

  • "Zombiler Öldürüldü"
  • "Toplanan Kırmızı Değerli Taşlar"
Açıklama Etkinliğin daha uzun bir açıklaması (örneğin, "Bir oyuncunun zombiyi kaç kez öldürdüğü" veya "Oyuncunun ortadan kaldırıp 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ü belirten bir alandır. Bu değer, Google Play Console tarafından Oyuncu Analizi raporlamasını desteklemek için 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"
  • "Zümrüt satın alındı"
Premium para birimi havuzu
Premium para biriminde harcama veya tüketimi izleyen etkinlikler için bu türü seçin. Örneğin:
  • "Harcanan altın paralar"
  • "Zümrüt kullanıldı"

Simge Etkinliğinizle ilişkilendirilecek kare simge.

Etkinlik oluşturma

Oyununuz için yeni bir etkinlik oluşturmak üzere şu adımları uygulayın:

  1. Henüz yapmadıysanız oyununuzu Google Play Console'a ekleyin.
  2. Google Play Console'da soldaki Oyun hizmetleri simgesini tıklayın ve oyununuzun girişini seçin.
  3. Soldaki Etkinlikler sekmesini seçin ve Etkinlik ekle düğmesini tıklayın.
  4. Oluşturmak istediğiniz etkinliğin ayrıntılarını girin.
  5. Kaydet'i tıklayın. Herhangi bir hata yoksa etkinliğiniz "Yayınlanmaya hazır" durumuna alınır. Artık oyun değişikliklerinizi yayınlayabilirsiniz.

Etkinliği düzenleme

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

  1. Google Play Console'da Etkinlikler sekmesini açın ve düzenlemek istediğiniz etkinliğin girişini seçin. Etkinliği oluştururken kullandığınız formun aynısını görmeniz gerekir.
  2. Düzenlemeyle ilgili değişikliklerinizi yapın.
  3. Etkinliği düzenleme işlemini tamamladığınızda Kaydet düğmesini tıklayın.
  4. Değiştirilen etkinliği doğrulamak için oyununuzu test edin. Doğru çalışıyorsa oyun değişikliklerinizi yeniden yayınlayın.

Etkinliği silme

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

Etkinlik verilerini sıfırlama

Etkinliklerinizin test kullanıcıları için oyuncu ilerleme durumu verilerini sıfırlayabilirsiniz.

  • Google Play Console'da taslak etkinlikleri sıfırlamak için ilgili etkinliğin 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'si Events yöntemlerini çağırın.

İstemci uygulamaları

Platformunuza nasıl etkinlik uygulayacağınızı öğrenmek için aşağıdaki kaynakları inceleyin: