API Bài đánh giá trong ứng dụng trên Google Play cho phép bạn nhắc người dùng gửi xếp hạng và bài đánh giá trên Cửa hàng Play mà không cần rời khỏi ứng dụng hoặc trò chơi của bạn.
Nhìn chung, luồng bài đánh giá trong ứng dụng (xem hình 1) có thể được kích hoạt bất cứ lúc nào trong suốt hành trình của người dùng ứng dụng. Trong luồng, người dùng có thể xếp hạng ứng dụng của bạn bằng hệ thống xếp hạng 1 đến 5 sao và thêm nhận xét tùy ý. Sau khi gửi, bài đánh giá sẽ được đưa lên Cửa hàng Play và cuối cùng sẽ được hiển thị.
Để bảo vệ quyền riêng tư của người dùng và tránh việc sử dụng sai API, ứng dụng của bạn phải tuân thủ các nguyên tắc nghiêm ngặt về thời điểm yêu cầu bài đánh giá trong ứng dụng và thiết kế của lời nhắc đánh giá.
Hình 1. Luồng bài đánh giá trong ứng dụng cho người dùng
Yêu cầu về thiết bị
Bài đánh giá trong ứng dụng chỉ hoạt động trên những thiết bị sau:
- Thiết bị Android (điện thoại và máy tính bảng) chạy Android 5.0 (API cấp 21) trở lên đã cài đặt Cửa hàng Google Play.
- Thiết bị ChromeOS đã cài đặt Cửa hàng Google Play.
Các yêu cầu về thư viện Play Core
Để tích hợp các bài đánh giá trong ứng dụng, ứng dụng của bạn phải sử dụng Thư viện Play Core phiên bản 1.8.0 trở lên.
Khi nào yêu cầu bài đánh giá trong ứng dụng
Hãy làm theo các nguyên tắc sau để giúp bạn quyết định thời điểm yêu cầu người dùng đánh giá trong ứng dụng:
- Kích hoạt luồng bài đánh giá trong ứng dụng sau khi người dùng đã trải nghiệm đủ ứng dụng hoặc trò chơi của bạn để đưa ra ý kiến phản hồi hữu ích.
- Đừng nhắc người dùng đánh giá quá nhiều. Phương pháp này giúp giảm thiểu sự khó chịu của người dùng và hạn chế việc sử dụng API (xem phần về hạn mức).
- Ứng dụng của bạn không được hỏi người dùng bất kỳ câu hỏi nào trước hoặc trong khi hiển thị nút hoặc thẻ xếp hạng, bao gồm cả câu hỏi về ý kiến của họ (chẳng hạn như "Bạn có thích ứng dụng này không?") hoặc câu hỏi dự đoán (chẳng hạn như "Bạn có đánh giá ứng dụng này 5 sao không?").
Hướng dẫn thiết kế
Hãy thực hiện theo các hướng dẫn này khi bạn xác định cách tích hợp các đánh giá trong ứng dụng vào ứng dụng của mình:
- Hiển thị thẻ nguyên trạng, không can thiệp hoặc sửa đổi thiết kế hiện có theo bất kỳ cách nào, bao gồm cả kích thước, độ mờ, hình dạng hoặc các thuộc tính khác.
- Không thêm bất kỳ lớp phủ nào lên trên hoặc xung quanh thẻ.
- Thẻ và nền của thẻ phải ở lớp trên cùng. Khi thẻ xuất hiện, không được loại bỏ thẻ bằng lập trình. Thẻ sẽ tự động bị xoá dựa trên hành động rõ ràng của người dùng hoặc cơ chế nội bộ của Cửa hàng Play.
Hạn mức
Để cung cấp trải nghiệm tuyệt vời cho người dùng, Google Play thực thi hạn mức giới hạn thời gian đối với tần suất hiển thị hộp thoại đánh giá cho người dùng. Do hạn mức này, việc gọi phương thức launchReviewFlow nhiều lần trong một khoảng thời gian ngắn (ví dụ: dưới một tháng) không phải lúc nào cũng hiển thị hộp thoại.
Do hạn mức có thể thay đổi, nên điều quan trọng là phải đưa logic của riêng bạn và nhắm mục tiêu thời điểm yêu cầu đánh giá tốt nhất có thể. Ví dụ: bạn không nên có tuỳ chọn lời kêu gọi hành động (chẳng hạn như nút) để kích hoạt API, vì người dùng có thể đã đạt đến hạn mức và quy trình sẽ không hiển thị, mang lại trải nghiệm không tốt cho người dùng. Đối với trường hợp sử dụng này, hãy chuyển hướng người dùng đến Cửa hàng Play.
Tích hợp các bài đánh giá trong ứng dụng của bạn
Tìm hiểu cách tích hợp bài đánh giá trong ứng dụng vào ứng dụng của bạn, tùy thuộc vào môi trường phát triển:
Điều khoản dịch vụ và an toàn dữ liệu
Bằng cách truy cập hoặc sử dụng Thư viện bài đánh giá trong ứng dụng của Play, bạn đồng ý với Điều khoản dịch vụ của Bộ phát triển phần mềm Play Core. Hãy đọc và hiểu tất cả điều khoản cũng như chính sách hiện hành trước khi truy cập thư viện.
An toàn dữ liệu
Thư viện Play Core là giao diện thời gian chạy của ứng dụng với Cửa hàng Google Play. Do đó, khi bạn sử dụng Play Core trong ứng dụng, Cửa hàng Play sẽ chạy các quy trình riêng, bao gồm cả việc xử lý dữ liệu theo Điều khoản dịch vụ của Google Play. Thông tin sau đây mô tả cách các thư viện Play Core xử lý dữ liệu để giải quyết các yêu cầu cụ thể của ứng dụng.
Bài đánh giá trong ứng dụng
| Dữ liệu thu được về mức sử dụng | Dữ liệu do người dùng nhập (xếp hạng và đánh giá ở dạng văn bản tự do) |
| Mục đích của việc thu thập dữ liệu | Dữ liệu đã thu thập được dùng để lại bài đánh giá trên Cửa hàng Play. |
| Mã hóa dữ liệu | Dữ liệu đã được mã hoá |
| Chia sẻ dữ liệu | Dữ liệu thu thập được sẽ dùng trong đánh giá công khai trên Cửa hàng Play hoặc nếu ứng dụng của bạn đang trong quá trình thử nghiệm khép kín, thì dữ liệu đã thu thập sẽ được chia sẻ riêng tư với nhà phát triển ứng dụng. |
| Xóa dữ liệu | Người dùng có thể xóa bài đánh giá của họ trong tài khoản Cửa hàng Google Play hoặc Tài khoản Google. |
Mặc dù chúng tôi luôn cố gắng minh bạch nhất có thể nhưng bạn hoàn toàn chịu trách nhiệm đối với việc đưa ra quyết định về cách phản hồi biểu mẫu trong mục an toàn dữ liệu của Google Play liên quan đến hoạt động thu thập, chia sẻ dữ liệu người dùng trong ứng dụng của bạn và các biện pháp bảo mật.