Bu kılavuzda, uygulama içi yorumları Unity kullanarak uygulamanıza nasıl entegre edeceğiniz açıklanmaktadır. Kotlin veya Java ya da yerel kod kullanıyorsanız ayrı entegrasyon kılavuzları vardır.
Unity SDK'ya genel bakış
Play In-App Review API, Play Core SDK'sı ailesinin bir parçasıdır. Unity API, RequestReviewFlow
ve LaunchReviewFlow
yöntemlerini kullanarak akışı istemek ve başlatmak için bir ReviewManager
sınıfı sunar. İstek gönderildikten sonra uygulamanız, ReviewErrorCode
aracını kullanarak isteğin durumunu kontrol edebilir.
Geliştirme ortamınızı ayarlama
Unity için Google paketlerinden Play In-App Review Unity Eklentisi'nin son sürümünü indirin.
İnceleme Yöneticisi'ni oluşturma
Uygulamanız ile API arasındaki iletişimi işleyen bir ReviewManager
örneği oluşturun.
// Create instance of ReviewManager
private ReviewManager _reviewManager;
// ...
_reviewManager = new ReviewManager();
ReviewInfo nesnesi isteme
Uygulamanızın kullanıcı işlemleri akışındaki iyi noktaları belirlemek için (örneğin, bir kullanıcı oyundaki bir seviyenin sonunda özet ekranını kapattıktan sonra) ne zaman uygulama içi inceleme isteğinde bulunacağınız ile ilgili yönergeleri izleyin. Uygulamanız bu noktalardan birine yaklaştığında, aşağıdaki örnekte gösterildiği gibi, eşzamansız bir işlem oluşturmak için ReviewManager
örneğini kullanın:
var requestFlowOperation = _reviewManager.RequestReviewFlow();
yield return requestFlowOperation;
if (requestFlowOperation.Error != ReviewErrorCode.NoError)
{
// Log error. For example, using requestFlowOperation.Error.ToString().
yield break;
}
_playReviewInfo = requestFlowOperation.GetResult();
Çağrı başarılı olursa API, uygulamanızın uygulama içi inceleme akışını başlatmak için ihtiyaç duyduğu PlayReviewInfo
nesnesini döndürür. Örnekte, çağrı, eşzamansız işlemi gerçekleştirmek için bir coroutine içinde yapılmıştır (bu, Ana iş parçacığını engellemez). Çağrı eşzamansız olarak yapıldığından bu işlem birkaç saniye sürebilir. Dolayısıyla uygulamanız, kullanıcı akışınızda uygulama içi yorumu göstermek istediğiniz noktaya ulaşmadan önce çağrıyı yapmalıdır.
Uygulama içi inceleme akışını başlatın
Uygulamanız PlayReviewInfo
örneğini aldıktan sonra uygulama içi inceleme akışını başlatabilir. PlayReviewInfo
nesnesinin yalnızca sınırlı bir süre için geçerli olduğunu, bu nedenle uygulamanızın bir akışı başlatmadan önce çok uzun süre beklememesi gerektiğini unutmayın.
var launchFlowOperation = _reviewManager.LaunchReviewFlow(_playReviewInfo);
yield return launchFlowOperation;
_playReviewInfo = null; // Reset the object
if (launchFlowOperation.Error != ReviewErrorCode.NoError)
{
// Log error. For example, using requestFlowOperation.Error.ToString().
yield break;
}
// The flow has finished. The API does not indicate whether the user
// reviewed or not, or even whether the review dialog was shown. Thus, no
// matter the result, we continue our app flow.
Sonraki adımlar
Entegrasyonunuzun doğru çalıştığını doğrulamak için uygulamanızın uygulama içi inceleme akışını test edin.