Etkinlikler

Google Play Games etkinlikleri hizmeti, oyun sırasında oyuncularınızın oluşturduğu kümülatif verileri toplamanıza ve oyun analizleri için Google'ın sunucularında depolamanıza olanak tanır. Oyununuzun hangi oyuncu verilerini topladığını esnek bir şekilde tanımlayabilirsiniz. Bu veriler arasında aşağıdakiler gibi metrikler bulunabilir:

  • Oyuncuların belirli bir öğeyi kullanması
  • Oyuncular belirli bir seviyeye ulaştığında
  • Oyuncuların belirli oyun işlemlerini gerçekleştirmesi

Etkinlik verilerini, oyununuzu nasıl iyileştireceğinizle ilgili geri bildirim olarak kullanabilirsiniz. Örneğin, oyununuzdaki oyuncuların tamamlamakta zorlandığı belirli seviyelerin zorluk derecesini düzenleyebilirsiniz.

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

Etkinlikleri oyununuza entegre etme

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

  1. Etkinlikleri tanımlayın. Oyununuzda yakalanacak 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. Oyun değişikliklerinizi yayınlama başlıklı makalede açıklanan adımları uygulayarak etkinlik tanımlarınızı yayınlayın.

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

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

Etkinliklerle ilgili temel bilgiler

Etkinlik API'leri, ilgi çekici oyun içi metrikleri tanımlayıp toplamanızı ve bu metrikleri Play Games SDK'sına yüklemenizi sağlar.

Play Games SDK etkinliği aşağıdaki temel özellikleri içerir:

Özellik Açıklama
ID Bu etkinlik için Google Play Console tarafından oluşturulan benzersiz bir dize. Oyun istemcilerinizdeki etkinliğe referans vermek için bu benzersiz kimliği kullanın.
Ad Etkinliğin kısa adı. Ad en fazla 100 karakterden oluşabilir. 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, "Oyuncunun bir zombiyi öldürme 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 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 alan. Bu değer, Google Play Console tarafından Player Analytics raporlamasını desteklemek için kullanılır.

İki etkinlik türü desteklenir:

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

Etkinlik oluşturma

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

  1. Google Play Console'da, sol taraftaki Oyun hizmetleri simgesini tıklayın ve oyununuzun girişini seçin.
  2. Soldaki 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 alınır. Artık oyun değişikliklerinizi yayınlamaya devam edebilirsiniz.

Bir etkinliği 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örürsünüz.
  2. Düzenleme değişikliklerinizi yapın.
  3. Etkinliği düzenlemeyi tamamladığınızda Kaydet düğmesini tıklayın.
  4. Değiştirilen etkinliği doğrulamak için oyununuzu test edin. Düzgün çalışıyorsa oyun değişikliklerinizi yeniden yayınlayın.

Etkinlik silme

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

Etkinlik verilerini sıfırlama

Etkinliklerinizin test kullanıcılarının oyuncu ilerleme 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 Events yöntemlerini çağırın.

İstemci uygulamaları

Platformunuz için etkinlikleri nasıl uygulayacağınızı öğrenmek üzere aşağıdaki kaynaklara göz atın: