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:
- Etkinlikleri tanımlama. Oyununuzda yakalayacağınız yeni etkinlikleri tanımlamak için:
- Google Play Console'da oyununuzun Etkinlikler sayfasına gidin.
- Yeni etkinlik ekle düğmesini tıklayın ve etkinlik özelliklerini yapılandırın.
- Oyun değişikliklerinizi yayınlama bölümünde açıklanan adımları uygulayarak etkinlik tanımlarınızı yayınlayın.
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
incrementyöntemini çağırın.
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:
|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:
|Simge||Etkinliğinizle ilişkilendirilecek kare simge.|
Etkinlik oluşturma
Oyununuz için yeni bir etkinlik oluşturmak üzere şu adımları uygulayın:
- Henüz yapmadıysanız oyununuzu Google Play Console'a ekleyin.
- Google Play Console'da soldaki Oyun hizmetleri simgesini tıklayın ve oyununuzun girişini seçin.
- Soldaki Etkinlikler sekmesini seçin ve Etkinlik ekle düğmesini tıklayın.
- Oluşturmak istediğiniz etkinliğin ayrıntılarını girin.
- 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:
- 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.
- Düzenlemeyle ilgili değişikliklerinizi yapın.
- Etkinliği düzenleme işlemini tamamladığınızda Kaydet düğmesini tıklayın.
- 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
Eventsyöntemlerini çağırın.
İstemci uygulamaları
Platformunuza nasıl etkinlik uygulayacağınızı öğrenmek için aşağıdaki kaynakları inceleyin: