Uygulama içi yorumları entegre edin (Unity)

Bu kılavuzda, Unity kullanarak uygulamanıza uygulama içi yorumları nasıl entegre edeceğiniz açıklanmaktadır. Kotlin veya Java, yerel kod ya da Unreal Engine kullanıyorsanız ayrı entegrasyon kılavuzları vardır.

Unity SDK'ya genel bakış

Play Uygulama İçi İnceleme API'si, Play Core SDK ailesinin bir parçasıdır. Unity API'si, 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 yöntemini kullanarak isteğin durumunu kontrol edebilir.

Geliştirme ortamınızı ayarlama

OpenUPM-CLI

OpenUPM CLI yüklüyse OpenUPM kayıt defterini aşağıdaki komutla yükleyebilirsiniz:

openupm add com.google.play.review

OpenUPM

  1. Edit > Project Settings > Package Manager (Düzenle > Proje Ayarları > Paket Yöneticisi) Unity menü seçeneğini belirleyerek paket yöneticisi ayarlarını açın.

  2. OpenUPM'yi Package Manager penceresine kapsamlı kayıt defteri olarak ekleyin:

    Name: package.openupm.com
URL: https://package.openupm.com
Scopes: com.google.external-dependency-manager
  com.google.play.common
  com.google.play.core
  com.google.play.review

  3. Unity menü seçeneği Window > Package Manager'ı (Pencere > Paket Yöneticisi) belirleyerek paket yöneticisi menüsünü açın.

  4. Yönetici kapsamı açılır menüsünü Kayıt Defterlerim'i seçecek şekilde ayarlayın.

  5. Paket listesinden Unity için Google Play Integrity eklentisi paketini seçip Yükle'ye basın.

GitHub'dan içe aktarma

  1. GitHub'dan en son .unitypackage sürümünü indirin.

  2. Öğeler > Paketi içe aktar > Özel Paket Unity menü seçeneğini belirleyip tüm öğeleri içe aktararak .unitypackage dosyasını içe aktarın.

ReviewManager'ı oluşturma

Uygulamanız ile Google Play API arasındaki iletişimi yöneten bir ReviewManager örneği oluşturun.

using Google.Play.Review;

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

ReviewInfo nesnesi isteme

Uygulamanızın kullanıcı işlemleri akışında kullanıcıdan yorum istemek için uygun noktaları (ör. kullanıcı bir oyunda seviye sonundaki özet ekranını kapattıktan sonra) belirlemek üzere uygulama içi yorumların ne zaman isteneceği ile ilgili yönergeleri uygulayın. 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 yorum akışını başlatması için gereken PlayReviewInfo nesnesini döndürür. Örnekte, eşzamansız işlemi gerçekleştirmek için çağrı bir eş yordam içinde yapılır (bu, ana iş parçacığını engellemez). Çağrı eşzamansız olarak yapıldığından birkaç saniye sürebilir. Bu nedenle uygulamanız, kullanıcı işlemleri akışında uygulama içi yorumu göstermek istediğiniz noktaya ulaşmadan önce çağrıyı yapmalıdır.

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

Uygulamanız PlayReviewInfo örneğini aldıktan sonra uygulama içi yorum akışını başlatabilir. PlayReviewInfo nesnesi yalnızca sınırlı bir süre için geçerlidir. Bu nedenle, uygulamanız akışı başlatmadan önce çok uzun süre beklememelidir.

var launchFlowOperation = _reviewManager.LaunchReviewFlow(_playReviewInfo);
yield return launchFlowOperation;
_playReviewInfo = null; // Reset the object
if (launchFlowOperation.Error != ReviewErrorCode.NoError)
{
    // Log error. For example, using launchFlowOperation.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 şekilde çalıştığını doğrulamak için uygulamanızın uygulama içi yorum akışını test edin.