Tích hợp các bài đánh giá trong ứng dụng (Unity)

Hướng dẫn này mô tả cách tích hợp bài đánh giá trong ứng dụng vào ứng dụng của bạn bằng cách sử dụng tính năng Unity. Có các hướng dẫn tích hợp riêng nếu bạn đang sử dụng Kotlin hoặc Java, mã gốc hoặc Unreal Engine.

Tổng quan về SDK Unity

API bài đánh giá trong ứng dụng của Play thuộc nhóm Play Core SDK. API dành cho Unity cung cấp một lớp ReviewManager để yêu cầu và khởi chạy quy trình này bằng cách sử dụng RequestReviewFlow và LaunchReviewFlow. Sau khi đưa ra yêu cầu, ứng dụng có thể kiểm tra trạng thái của yêu cầu bằng cách sử dụng ReviewErrorCode.

Thiết lập môi trường phát triển

OpenUPM-CLI

Nếu đã cài đặt OpenUPM CLI, bạn có thể cài đặt sổ đăng ký OpenUPM bằng lệnh sau:

openupm add com.google.play.review

OpenUPM

  1. Mở package manager settings (cài đặt trình quản lý gói) bằng cách chọn mục Edit > Project Settings > Package Manager (Chỉnh sửa > Cài đặt dự án > Trình quản lý gói) trong trình đơn Unity.

  2. Thêm OpenUPM làm sổ đăng ký trong phạm vi vào cửa sổ Trình quản lý gói:

    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. Mở trình đơn trình quản lý gói bằng cách chọn mục Window > Package Manager (Cửa sổ > Trình quản lý gói) trong trình đơn Unity.

  4. Đặt trình đơn thả xuống phạm vi của trình quản lý để chọn Sổ đăng ký của tôi.

  5. Chọn gói Trình bổ trợ Google Play Integrity cho Unity trong danh sách gói rồi nhấn vào Cài đặt.

Nhập từ GitHub

  1. Tải bản phát hành .unitypackage mới nhất xuống từ GitHub.

  2. Nhập tệp .unitypackage bằng cách chọn mục trong trình đơn Unity Assets > Import package > Custom Package (Nội dung > Nhập gói > Tuỳ chỉnh gói) rồi nhập tất cả các mục.

Tạo ReviewManager

Tạo một bản sao của ReviewManager để xử lý việc giao tiếp giữa ứng dụng và API Google Play.

using Google.Play.Review;

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

Yêu cầu đối tượng ReviewInfo

Làm theo hướng dẫn về thời điểm yêu cầu đánh giá trong ứng dụng để xác định điểm tốt trong luồng người dùng ứng dụng nhằm nhắc họ đánh giá (ví dụ: sau khi người dùng đóng màn hình tóm tắt ở cuối màn chơi trong trò chơi). Khi ứng dụng đến gần một trong các điểm sau, hãy sử dụng bản sao ReviewManager để tạo một hoạt động không đồng bộ, như minh hoạ trong ví dụ sau:

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

Nếu lệnh gọi thành công, API sẽ trả về đối tượng PlayReviewInfo mà ứng dụng cần để chạy quy trình đánh giá trong ứng dụng. Ở ví dụ này, lệnh gọi được thực hiện bên trong một coroutine để thực hiện thao tác không đồng bộ (việc này không chặn Luồng chính). Do lệnh gọi được thực hiện không đồng bộ có thể mất vài giây, vì vậy, ứng dụng nên thực hiện lệnh gọi trước khi quét đến điểm trong luồng người dùng mà bạn muốn hiện bài đánh giá trong ứng dụng.

Chạy luồng bài đánh giá trong ứng dụng

Sau khi nhận được bản sao PlayReviewInfo, ứng dụng có thể bắt đầu quy trình đánh giá. Đối tượng PlayReviewInfo chỉ hợp lệ trong một khoảng thời gian có hạn, vì vậy bạn không nên đợi ứng dụng quá lâu trước khi chạy quy trình.

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.

Các bước tiếp theo

Kiểm thử quy trình đánh giá trong ứng dụng để xác nhận rằng việc tích hợp của bạn hoạt động chính xác.