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 arasında aşağıdaki gibi metrikler yer alabilir:

  • Oyuncular belirli bir öğeyi kullanırsa
  • Oyuncular belirli bir seviyeye ulaştığında
  • Oyuncular belirli bir oyun işlemini gerçekleştirir.

Etkinlik verilerini, oyununuzu nasıl iyileştireceğinizle ilgili geri bildirim olarak kullanabilirsiniz. Ö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 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 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 etkinliklerle ilgili istatistikleri 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'sına yüklemenize olanak tanır.

Play Games SDK etkinliği şu temel özellikleri içerir:

Ö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 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 Zombiler"
  • "Toplanan Kırmızı Mücevherler"
Açıklama Etkinliğin daha uzun bir açıklaması (örneğin, "Bir oyuncunun zombi ö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 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 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"
  • "Zümrüt satın alındı"
Premium para birimi havuzu
Premium para biriminin çıkışını veya tüketimini izleyen etkinlikler için bu türü seçin. Örneğin:
  • "Harcadığınız altın paralar"
  • "Kullanılan zümrütler"
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, 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 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 bitirdiğinizde 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 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ı

Platformunuz için etkinlikleri nasıl uygulayacağınızı öğrenmek istiyorsanız aşağıdaki kaynaklara bakın: