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, kode native, atau Unreal Engine.

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 dapat memeriksa status permintaan menggunakan ReviewErrorCode.

Menyiapkan lingkungan pengembangan

OpenUPM-CLI

Jika telah menginstal OpenUPM CLI, Anda dapat menginstal registry OpenUPM dengan perintah berikut:

openupm add com.google.play.review

OpenUPM

  1. Buka setelan pengelola paket dengan memilih opsi menu Unity Edit > Project Settings > Package Manager.

  2. Tambahkan OpenUPM sebagai registry cakupan ke jendela Package Manager:

    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. Buka menu pengelola paket dengan memilih opsi menu Unity Window > Package Manager.

  4. Tetapkan drop-down cakupan pengelola untuk memilih Registry Saya.

  5. Pilih paket plugin Google Play Integrity untuk Unity dari daftar paket, lalu tekan Instal.

Mengimpor dari GitHub

  1. Download rilis .unitypackage terbaru dari GitHub.

  2. Impor file .unitypackage dengan memilih opsi menu Unity Assets > Import package > Custom Package, lalu mengimpor semua item.

Membuat ReviewManager

Buat instance ReviewManager yang menangani komunikasi antara aplikasi Anda dan Google Play 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 momen tepat dalam alur penggunaan aplikasi 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 peninjauan dalam aplikasi aplikasi Anda untuk memverifikasi bahwa integrasi Anda berfungsi dengan benar.