Google Play In-App Review API, kullanıcılardan uygulama veya oyununuzdan çıkmak zorunda kalmadan Play Store puanları ve yorumları göndermelerini istemenize olanak tanır.
Genellikle uygulama içi yorum akışı (bkz. Şekil 1), uygulamanızın kullanıcı yolculuğu boyunca herhangi bir zamanda tetiklenebilir. Kullanıcı, akış sırasında uygulamanızı 1 ila 5 yıldız arasında puanlayabilir ve isteğe bağlı bir yorum ekleyebilir. Gönderilen yorumlar Play Store'a gönderilir ve sonunda gösterilir.
Kullanıcı gizliliğini korumak ve API'nin kötüye kullanımını önlemek için uygulamanızın ne zaman uygulama içi yorum isteğinde bulunacağı ve yorum istemi tasarımı ile ilgili katı kurallara uyması gerekir.
Şekil 1. Bir kullanıcı için uygulama içi inceleme akışı
Cihaz gereksinimleri
Uygulama içi yorumlar yalnızca aşağıdaki cihazlarda çalışır:
- Android 5.0 (API seviyesi 21) veya sonraki sürümleri çalıştıran ve Google Play Store'un yüklü olduğu Android cihazlar (telefonlar ve tabletler).
- Google Play Store'un yüklü olduğu ChromeOS cihazlar
Play Core Library şartları
Uygulama içi yorumları uygulamanıza entegre etmek için uygulamanızın Play Core kitaplığının 1.8.0 veya sonraki bir sürümünü kullanması gerekir.
Ne zaman uygulama içi inceleme isteğinde bulunabilirsiniz?
Kullanıcılardan ne zaman uygulama içi yorum isteğinde bulunacağınıza karar vermenize yardımcı olması için aşağıdaki yönergeleri uygulayın:
- Kullanıcı, uygulamanız veya oyununuzu yeterince deneyimleyip yararlı geri bildirimde bulunabilecek duruma geldikten sonra uygulama içi yorum akışını tetikleyin.
- Kullanıcıdan çok fazla yorum isteğinde bulunmayın. Bu yaklaşım, kullanıcıların canını sıkmayı en aza indirmeye ve API kullanımını sınırlamaya yardımcı olur (kotalarla ilgili bölüme bakın).
- Uygulamanız, derecelendirme düğmesini veya kartını göstermeden önce ya da gösterirken kullanıcıya herhangi bir soru soramaz. Bu sorular arasında kullanıcının fikriyle ilgili sorular ("Uygulamayı beğendiniz mi?" gibi) veya tahmini sorular ("Bu uygulamaya 5 yıldız verir misiniz?" gibi) yer alamaz.
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 özelliklerde herhangi bir şekilde değişiklik yapmadan olduğu gibi gösterin.
- Kartın üzerine veya etrafına yer paylaşımı eklemeyin.
- Kart ve kartın arka planı en üst katmanda olmalıdır. Kart gösterildikten sonra programlı olarak kaldırmayın. Kart, kullanıcının açıkça gerçekleştirdiği işleme veya Play Store'un dahili mekanizmasına göre otomatik olarak kaldırılır.
Kotalar
Google Play, mükemmel bir kullanıcı deneyimi sunmak için kullanıcılara yorum iletişim kutusunun ne sıklıkta gösterilebileceğine dair zaman sınırı olan bir kota uygular. Bu kota nedeniyle, launchReviewFlow yönteminin kısa bir süre içinde (ör. bir aydan kısa bir süre) birden fazla kez çağrılması 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 zamanı hedeflemeniz önemlidir. Örneğin, kullanıcı kotasına ulaşmış olabileceğinden ve akış gösterilmeyeceğinden API'yi tetiklemek için bir harekete geçirici mesaj seçeneğiniz (ör. düğme) olmamalıdır. Bu durumda 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 hüküm 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 tabi olarak verileri işleme 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çi yorumlar
| Kullanımla ilgili toplanan veriler | Kullanıcı tarafından girilen veriler (puan ve serbest metin yorumu) |
| Veri toplamanın 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'daki herkese açık bir incelemede kullanılır veya uygulama kapalı test kanalındaysa toplanan veriler uygulama geliştiriciyle özel olarak paylaşılır. |
| Veri silme | Kullanıcılar, Google Play Store hesaplarından veya Google Hesaplarından yorumlarını silebilir. |
Mümkün olduğunca şeffaf olmaya çalışsak da uygulamanızın kullanıcı verisi toplama, paylaşma ve güvenlik uygulamalarıyla ilgili olarak Google Play'in Veri Güvenliği bölümü formuna nasıl yanıt vereceğinize karar vermek tamamen sizin sorumluluğunuzdadır.