Uygulama içi yorumları entegre edin (Unity)

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.