Uygulama içi yorumları entegre edin (Unity)

Bu kılavuzda, Unity kullanarak uygulama içi yorumları uygulamanıza nasıl entegre edeceğiniz açıklanmaktadır. Kotlin veya Java veya yerel kod.

Unity SDK'ya genel bakış

Play In-App Review API, Play Core'un bir parçasıdır. SDK ailesi. API Unity, bir ReviewManager sunuyor kullanarak akışı başlatmak ve istekte bulunmak için RequestReviewFlow ve LaunchReviewFlow yöntemlerine göz atın. İstek yapıldıktan sonra uygulamanız isteğin durumunu kontrol edebilir ReviewErrorCode kullanılıyor.

Geliştirme ortamınızı ayarlama

Play In-App Review Unity Eklentisinin en son sürümünü şunun için Google paketlerinden indirin: Unity'yi tıklayın.

İnceleme Yöneticisi'ni oluşturma

ReviewManager örneği oluşturma Google Analytics 4'te tarama yapar.

// Create instance of ReviewManager
private ReviewManager _reviewManager;
// ...
_reviewManager = new ReviewManager();

ReviewInfo nesnesi isteme

Ne zaman uygulama içi istekte bulunacağınızla ilgili talimatları uygulayın. incelemeden yararlanarak iyi puanları kullanıcının inceleme yapmasını istemek için (örneğin, Kullanıcı oyunda bir seviyenin sonunda özet ekranını kapatır. bu noktalardan birine yaklaştığında ReviewManager aşağıdaki örnekte gösterildiği gibi eş zamansız bir işlem oluşturun:

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, PlayReviewInfo değerini döndürür. nesne eklemeniz gerekir. Örnekte, çağrı, bir eş yordam içinde yapılır (eş zamansız işlemi gerçekleştirmek için) (Ana iş parçacığını engellemez). Çünkü çağrı eşzamansız olarak yapılır, bu işlem birkaç saniye sürebilir. Dolayısıyla, uygulamanız, çağrıyı kullanıcınızın ana noktasına ulaşmadan önce yapmalıdır uygulama içi incelemeyi göstermek istediğiniz yere gidin.

Uygulama içi inceleme akışını başlatma

Uygulamanız PlayReviewInfo aldıktan sonra uygulama içi inceleme akışını başlatabilir. PlayReviewInfo nesne yalnızca sınırlı bir süre için geçerli olduğundan uygulamanız beklememelidir çok uzun sürer.

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

Uygulamanızın uygulama içi inceleme akışını test ederek entegrasyonunuzun düzgün çalıştığını doğrulayın.