Google Play Uygulama İçi Yorumlar API'si

Google Play In-App Review API sayesinde kullanıcılardan uygulama veya oyununuzdan çıkmak zorunda kalmadan Play Store puanı vermelerini ve yorum yapmalarını isteyebilirsiniz.

Genel olarak, uygulama içi yorum akışı (Şekil 1'e bakın) uygulamanızın kullanıcı yolculuğu boyunca herhangi bir zamanda tetiklenebilir. Akış sırasında kullanıcı, 1-5 yıldız sistemini kullanarak uygulamanızı derecelendirebilir ve isteğe bağlı bir yorum ekleyebilir. Gönderilen yorum Play Store'a gönderilir ve sonunda gösterilir.

Kullanıcı için uygulama içi yorum iş akışı

1.şekil Kullanıcı için uygulama içi yorum akışı

Cihaz gereksinimleri

Uygulama içi yorumlar yalnızca aşağıdaki cihazlarda çalışır:

  • Google Play Store'un yüklü olduğu Android 5.0 (API seviyesi 21) veya sonraki sürümlerin yüklü olduğu Android cihazlar (telefonlar, tabletler ve Google TV'li TV'ler)
  • Google Play Store'un yüklü olduğu ChromeOS cihazlar.

Play Core Kitaplığı şartları

Uygulama içi yorumları uygulamanıza entegre etmek için uygulamanızın Play Core Kitaplığı'nın 1.8.0 veya daha yeni bir sürümünü kullanması gerekir.

Ne zaman uygulama içi inceleme isteğinde bulunabilirsiniz?

Kullanıcılardan uygulama içi yorum isteme zamanına karar vermenize yardımcı olacak aşağıdaki yönergeleri uygulayın:

  • Kullanıcı, uygulamanız veya oyununuz hakkında faydalı geri bildirim sağlayabilecek kadar deneyim kazandıktan sonra uygulama içi yorum akışını tetikleyin.
  • Kullanıcıdan aşırı sıklıkta yorum yapmasını istemeyin. Bu yaklaşım, kullanıcıların hayal kırıklığını en aza indirmeye ve API kullanımını sınırlamaya yardımcı olur (kotalarla ilgili bölümü inceleyin).
  • Uygulamanız, kullanıcılara derecelendirme düğmesini veya kartını göstermeden önce ya da gösterirken görüşleriyle ilgili sorular ("Uygulamayı beğendiniz mi?" gibi) veya tahmin soruları ("Bu uygulamaya 5 yıldız verir misiniz?" gibi) dahil olmak üzere herhangi bir soru sormamalıdır.

Tasarım yönergeleri

Uygulama içi yorumları uygulamanıza nasıl entegre edeceğinizi belirlerken aşağıdaki yönergeleri uygulayın:

  • Kartı, mevcut tasarımda boyut, opaklık, şekil veya diğer özellikler de dahil olmak üzere hiçbir şekilde değişiklik yapmadan veya mevcut tasarımı kurcalamadan olduğu gibi gösterin.
  • Kartın üzerine veya etrafına herhangi bir yerleşimi eklemeyin.
  • Kart ve kartın arka planı en üst katmanda olmalıdır. Kart gösterildikten sonra programatik olarak kaldırmayın. Kart, kullanıcının açıkça yaptığı işleme veya Play Store'un dahili bir mekanizmasına göre otomatik olarak kaldırılır.

Kotalar

Google Play, mükemmel bir kullanıcı deneyimi sağlamak için kullanıcılara ne sıklıkta yorum iletişim kutusu gösterilebileceği konusunda zamana bağlı bir kota uygular. Bu kota nedeniyle, kısa bir süre içinde (ör. bir aydan kısa) launchReviewFlow yöntemini birden fazla kez çağırmak her zaman bir iletişim kutusu göstermeyebilir.

Kota değişebileceğinden, kendi mantığınızı uygulamanız ve inceleme isteğinde bulunmak için mümkün olan en iyi anı hedeflemeniz önemlidir. Örneğin, API'yi tetiklemek için bir harekete geçirici mesaj seçeneği (ör. düğme) olmamalıdır. Kullanıcı kotasını aşmış olabileceğinden akış gösterilmez ve kullanıcıya bozuk bir deneyim sunulur. Bu kullanım alanında, kullanıcıyı Play Store'a yönlendirin.

Uygulama içi yorumları uygulamanıza entegre etme

Geliştirme ortamınıza bağlı olarak uygulama içi yorumları uygulamanıza nasıl entegre edeceğinizi öğrenin:

Hizmet şartları ve veri güvenliği

Play Uygulama İçi Yorumlar Kitaplığı'na erişerek veya bu kitaplığı kullanarak Play Core Yazılım Geliştirme Kiti Hizmet Şartları'nı kabul etmiş olursunuz. Kitaplığa erişmeden önce geçerli tüm şartları ve politikaları okuyup anlayın.

Veri Güvenliği

Play Core kitaplıkları, uygulamanızın Google Play Store ile çalışma zamanı arayüzüdür. Bu nedenle, uygulamanızda Play Core'u kullandığınızda Play Store, Google Play Hizmet Şartları'na göre yönetilen verilerin işlenmesi de dahil olmak üzere kendi işlemlerini yürütür. Aşağıdaki bilgilerde, Play Core kitaplıklarının uygulamanızdan gelen belirli istekleri işlemek için verileri nasıl işlediği açıklanmaktadır.

Uygulama İçi Yorumlar

Kullanımla ilgili toplanan veriler Kullanıcı tarafından girilen veriler (puan ve serbest metin yorumu)
Veri toplama amacı Toplanan veriler, Play Store'da yorum bırakmak için kullanılır.
Veri şifreleme Veriler şifrelenir.
Veri paylaşımı Toplanan veriler Play Store'da herkese açık bir incelemede kullanılır veya uygulama kapalı test kanalındaysa toplanan veriler uygulama geliştiriciyle gizli olarak paylaşılır.
Veri silme Kullanıcılar, Google Play Store hesaplarında veya Google Hesaplarında yorumlarını silebilirler.

Olabildiğince şeffaf olmayı hedeflesek de uygulamanızın kullanıcı verilerini toplama, paylaşma ve güvenlikle ilgili yaklaşımı hakkında Google Play'in Veri Güvenliği bölümü formuna nasıl yanıt vereceğinize karar vermek tamamen sizin sorumluluğunuzdadır.