Mengintegrasikan ulasan dalam aplikasi (Unity)

Panduan ini menjelaskan cara mengintegrasikan ulasan dalam aplikasi pada aplikasi Anda menggunakan Unity. Ada panduan integrasi terpisah jika Anda menggunakan Kotlin atau Java atau kode native.

Ringkasan Unity SDK

Play In-App Review API adalah bagian dari kelompok Play Core SDK. API untuk Unity menawarkan class ReviewManager untuk meminta dan meluncurkan alur menggunakan metode RequestReviewFlow dan LaunchReviewFlow. Setelah permintaan dibuat, aplikasi Anda bisa memeriksa status permintaan menggunakan ReviewErrorCode.

Menyiapkan lingkungan pengembangan

Download rilis terbaru Plugin Play In-App Review Unity dari paket Google untuk Unity.

Membuat ReviewManager

Buat instance ReviewManager yang menangani komunikasi antara aplikasi Anda dan API.

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

Meminta objek ReviewInfo

Ikuti panduan tentang kapan harus meminta ulasan dalam aplikasi untuk menentukan titik yang baik dalam alur penggunaan aplikasi Anda untuk meminta pengguna memberikan ulasan (misalnya, setelah pengguna menutup layar ringkasan di akhir level dalam game). Saat aplikasi Anda mendekati salah satu titik ini, gunakan instance ReviewManager untuk membuat operasi asinkron, seperti yang ditunjukkan dalam contoh berikut:

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();

Jika panggilan berhasil, API akan menampilkan objek PlayReviewInfo yang diperlukan aplikasi Anda untuk meluncurkan alur ulasan dalam aplikasi. Dalam contoh, panggilan dilakukan di dalam coroutine untuk menjalankan operasi asinkron (tindakan ini tidak memblokir thread Utama). Karena panggilan dibuat secara asinkron, mungkin diperlukan waktu hingga beberapa detik, sehingga aplikasi Anda harus melakukan panggilan sebelum aplikasi mencapai titik di alur pengguna tempat Anda ingin menampilkan ulasan dalam aplikasi.

Meluncurkan alur ulasan dalam aplikasi

Setelah menerima instance PlayReviewInfo, aplikasi Anda dapat meluncurkan alur ulasan dalam aplikasi. Perhatikan bahwa objek PlayReviewInfo hanya valid untuk jangka waktu terbatas, sehingga aplikasi Anda tidak perlu menunggu terlalu lama sebelum meluncurkan alur.

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.

Langkah berikutnya

Uji alur ulasan dalam aplikasi untuk memverifikasi bahwa integrasi Anda berfungsi dengan benar.