Etkinlikler

Google Play Games etkinlikleri hizmeti, oyun sırasında oyuncularınız tarafından oluşturulan kümülatif verileri toplamanıza ve bunları oyun analizleri için Google'ın sunucularında depolamanıza olanak tanır. Oyununuzun hangi oyuncu verilerini toplaması gerektiğini esnek bir şekilde tanımlayabilirsiniz. Bu verilere ne sıklıkla ve ne sıklıkla

  • Oyuncular belirli bir öğeyi kullanır
  • Oyuncular belirli bir seviyeye ulaşır
  • Oyuncular oyunda belirli bir işlem gerçekleştirir

Etkinlik verilerini, oyununuzu nasıl iyileştireceğiniz konusunda geri bildirim olarak kullanabilirsiniz. Örneğin, oyununuzda oyuncuların tamamlamakta zorlandıkları belirli seviyelerin zorluk seviyesini ayarlayabilirsiniz.

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

Etkinlikleri oyununuza entegre etme

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

  1. Etkinlikleri tanımlama. 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 bölümünde açıklanan adımları uygulayarak etkinlik tanımlarınızı yayınlayın.
  2. Etkinlik API'lerini kullanarak oyununuzda etkinlik yakalamayı uygulayın. Örneğin, Android kodunuzda, oyununuz önemsediğ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'leri, ilgi çekici oyun metriklerini tanımlayıp toplamanız ve bu metrikleri Play Games SDK'sına yüklemeniz için bir yol sağlar.

Play Games SDK'sı etkinlikleri şu temel özellikleri içerir:

Özellik Açıklama
ID Google Play Console tarafından bu etkinlik için oluşturulan benzersiz bir dizedir. 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:

  • "Zombiler Öldürüldü"
  • "Toplanan Kırmızı Mücevherler"
Description Etkinliğin daha uzun bir açıklaması (örneğin, "Bir oyuncunun bir zombiyi kaç kez öldürdüğü" veya "Oyuncunun eleyip 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 alan. Bu değer, Google Play Console tarafından Oyuncu Analizleri 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 para"
  • "Zümrüt satın alındı"
Premium para birimi havuzu
Premium para biriminin harcamalarını veya tüketimini izleyen etkinlikler için bu türü seçin. Örneğin:
  • "Harcanan altın para"
  • "Zümrüt kullanıldı"

Simge Etkinliğinizle ilişkilendirilecek kare şeklinde bir simge.

Etkinlik oluşturma

Oyununuz için yeni bir etkinlik oluşturmak üzere aşağıdaki 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 oyununuza ait girişi seçin.
  3. Soldaki Etkinlikler sekmesini seçin ve Etkinlik ekle düğmesini tıklayın.
  4. Oluşturmak istediğiniz etkinlikle ilgili ayrıntıları 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ınlama aşamasına geçebilirsiniz.

Bir 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 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 durumunda olan veya yayınlanmış etkinlikleri silebilirsiniz. Google Play Console'da bir etkinliği silmek için söz konusu etkinliğe ait formun alt kısmındaki Sil etiketli düğmeyi tıklayın.

Etkinlik verilerini sıfırla

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 söz konusu etkinliğe ait formun alt kısmındaki Etkinlik ilerleme durumunu sıfırla etiketli düğmeyi tıklayın.
  • Etkinlik verilerini programatik olarak sıfırlamak için Management API'si Events yöntemlerini çağırın.

İstemci uygulamaları

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