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:
- Etkinlikleri tanımlama. Oyununuzda yakalanacak yeni etkinlikler 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.
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.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:
|
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:
|
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:
- Henüz yapmadıysanız oyununuzu Google Play Console'a ekleyin.
- Google Play Console'da soldaki Oyun hizmetleri simgesini tıklayın ve oyununuza ait girişi seçin.
- Soldaki Etkinlikler sekmesini seçin ve Etkinlik ekle düğmesini tıklayın.
- Oluşturmak istediğiniz etkinlikle ilgili ayrıntıları 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ınlama aşamasına geçebilirsiniz.
Bir 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 formu görürsünüz.
- Düzenleme değişikliklerinizi yapın.
- Etkinliği düzenlemeyi tamamladığınızda Kaydet düğmesini tıklayın.
- 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: