Mengintegrasikan ulasan dalam aplikasi (Kotlin atau Java)

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

Menyiapkan lingkungan pengembangan

Library Play In-App Review adalah bagian dari Library Google Play Core. Sertakan dependensi Gradle berikut untuk mengintegrasikan Library Play In-App Review.

Groovy

// In your app's build.gradle file:
...
dependencies {
    // This dependency is downloaded from the Google's Maven repository.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.play:review:2.0.2'

    // For Kotlin users also add the Kotlin extensions library for Play In-App Review:
    implementation 'com.google.android.play:review-ktx:2.0.2'
    ...
}

Kotlin

// In your app's build.gradle.kts file:
...
dependencies {
    // This dependency is downloaded from the Google's Maven repository.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation("com.google.android.play:review:2.0.2")

    // For Kotlin users also import the Kotlin extensions library for Play In-App Review:
    implementation("com.google.android.play:review-ktx:2.0.2")
    ...
}

Membuat ReviewManager

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

Kotlin

val manager = ReviewManagerFactory.create(context)

Java

ReviewManager manager = ReviewManagerFactory.create(context)

Meminta objek ReviewInfo

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

Kotlin

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 ReviewException).errorCode
    }
}

Java

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 = ((ReviewException) 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 penggunaan normalnya (seperti maju ke level berikutnya).

Kotlin

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.
}

Java

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.