Mengintegrasikan ulasan dalam aplikasi (Kotlin atau Java)

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

Menyiapkan lingkungan pengembangan

In-App Review API adalah bagian dari Play Core SDK. Untuk menyiapkan lingkungan pengembangan, ikuti petunjuk penyiapan di bagian Java atau Kotlin di panduan library Play Core.

Membuat ReviewManager

ReviewManager adalah antarmuka yang memungkinkan aplikasi Anda memulai alur ulasan dalam aplikasi. Dapatkan dengan membuat instance menggunakan ReviewManagerFactory.

val manager = ReviewManagerFactory.create(context)

ReviewManager manager = ReviewManagerFactory.create(context)

Meminta objek ReviewInfo

Ikuti panduan tentang kapan harus meminta ulasan dalam aplikasi. Panduan ini menentukan momen yang tepat untuk meminta pengguna memberikan ulasan dalam alur penggunaan aplikasi (misalnya, saat pengguna menyelesaikan level dalam sebuah game). Setelah aplikasi mencapai salah satu momen tersebut, gunakan instance ReviewManager untuk membuat tugas permintaan. Jika berhasil, API akan mengembalikan objek ReviewInfo yang diperlukan untuk memulai alur ulasan dalam aplikasi.

val request = manager.requestReviewFlow()
request.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // We got the ReviewInfo object
        val reviewInfo = task.result
    } else {
        // There was some problem, log or handle the error code.
        @ReviewErrorCode val reviewErrorCode = (task.getException() as TaskException).errorCode
    }
}

ReviewManager manager = ReviewManagerFactory.create(this);
Task<ReviewInfo> request = manager.requestReviewFlow();
request.addOnCompleteListener(task -> {
    if (task.isSuccessful()) {
        // We can get the ReviewInfo object
        ReviewInfo reviewInfo = task.getResult();
    } else {
        // There was some problem, log or handle the error code.
        @ReviewErrorCode int reviewErrorCode = ((TaskException) task.getException()).getErrorCode();
    }
});

Meluncurkan alur ulasan dalam aplikasi

Gunakan instance ReviewInfo untuk meluncurkan alur ulasan dalam aplikasi. Tunggu hingga pengguna menyelesaikan alur ulasan dalam aplikasi sebelum aplikasi Anda melanjutkan alur pengguna normalnya (seperti mendorong ke level berikutnya).

val flow = manager.launchReviewFlow(activity, reviewInfo)
flow.addOnCompleteListener { _ ->
    // 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.
}

Task<Void> flow = manager.launchReviewFlow(activity, reviewInfo);
flow.addOnCompleteListener(task -> {
    // 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.