SDK Android
Đánh giá trong ứng dụng trên Android với In-App Review API của Google Play
PromptSurge cho Android là một thư viện Kotlin hiển thị lời mời đánh giá ngắn, mang thương hiệu của bạn, rồi khởi chạy luồng In-App Review của Google Play khi người dùng xác nhận. Hai lệnh gọi trong mã của bạn; nội dung, giao diện, ảnh tiêu đề và ngôn ngữ đến từ máy chủ.
Gói miễn phí · minSdk 24 · JitPack
1 · Lời mời đánh giá của bạn
Nhờ bạn một việc nhỏ
Chúng tôi đã dồn nhiều công sức cho tính năng đồng bộ ngoại tuyến. Một đánh giá ngắn giúp người khác tìm thấy ứng dụng.
2 · Màn hình đánh giá gốc
App Store hoặc Google Play
Màn hình của chính Apple hoặc Google, hiển thị không thay đổi
SDK Android làm gì cho bạn
Thẻ đánh giá của chính Play
Khi xác nhận, SDK chạy requestReviewFlow() và launchReviewFlow() của ReviewManager. Thẻ là của Google, hiển thị nguyên trạng; lời mời đánh giá đã đóng trước đó, và hạn mức của chính Play quyết định thẻ có xuất hiện hay không.
Phù hợp với mọi giao diện ứng dụng
Hộp thoại dùng Material 3. Trên giao diện Material, nó kế thừa phong cách của bạn; trên AppCompat, giao diện nền tảng hoặc giao diện game tùy chỉnh, nó chuyển sang giao diện đi kèm của riêng nó thay vì gây lỗi. Màu từ bảng điều khiển được áp dụng lên trên.
An toàn cho ứng dụng production
minSdk 24, không cần quyền lúc chạy, không thêm gì vào manifest, quy tắc R8 được kèm trong AAR. requestReview() không làm gì nếu activity đang kết thúc, trạng thái của nó đã được lưu hoặc hộp thoại đang hiển thị.
Mọi bước kiểm tra điều kiện đều có sẵn
Trạng thái từ chối (opt-out), thời gian chờ 90 ngày trên mỗi thiết bị, nhóm kiểm soát 10%, giai đoạn khởi động 50 thiết bị và hạn mức hằng tháng của gói đều được kiểm tra trước. Khi lời mời đánh giá bị tạm giữ vì giai đoạn khởi động, nhóm kiểm soát hoặc hạn mức đã hết, luồng đánh giá của Play vẫn được khởi chạy, để thời điểm đó không bị bỏ lỡ.
Có sẵn câu trả lời cho Data Safety
Định danh duy nhất là SHA-256 của ANDROID_ID cộng với tên gói của bạn, không bao giờ là ID thô, và không dùng ID quảng cáo nào. README liệt kê chính xác những gì cần khai báo trong biểu mẫu Data Safety của Play.
Tích hợp
Thêm JitPack và một phụ thuộc Gradle (tọa độ và phiên bản hiện tại có trong tài liệu), khởi tạo trong Application, rồi gọi requestReview() vào thời điểm bạn chọn.
Application.onCreate()
import com.promptsurge.sdk.PromptSurge
class MyApp : Application() {
override fun onCreate() {
super.onCreate()
PromptSurge.initialize(this, "ps_live_your_key_here")
}
}Tại thời điểm bạn chọn
// In an Activity (AppCompatActivity works)
PromptSurge.requestReview(this)
// Or from a Fragment
PromptSurge.requestReview(requireActivity())Trong khi tích hợp, PromptSurge.setLogLevel(PromptSurge.LogLevel.INFO) in ra một dòng cho mỗi quyết định. Thẻ của Play bị giới hạn bởi hạn mức và thường không hiển thị gì trên bản dựng debug, nên việc thẻ không xuất hiện ở đó là bình thường.
Người dùng của bạn thấy gì, qua ba bước
Vẫn những người dùng đó, vẫn thời điểm đó. Điểm khác là họ được hỏi trước, bằng lời nói về ứng dụng của bạn.
Đã lưu chuyến đi
Dùng được khi ngoại tuyến
requestReview()
Bước 1
Mã của bạn chọn thời điểm
Gọi requestReview() ngay sau khi có việc gì đó suôn sẻ, như lưu xong chuyến đi hoặc qua một màn chơi.
Một việc nhỏ nhờ bạn
Chúng tôi đã dành nhiều công sức cho bản đồ ngoại tuyến. Một đánh giá ngắn giúp những người đi du lịch khác tìm thấy ứng dụng này.
Để sauĐồng ýBước 2
Pre-prompt đề nghị bằng lời của bạn
Một thông điệp ngắn nhắc đến điều ứng dụng của bạn làm được. Để sau sẽ đóng lại và không có gì khác xảy ra.
Đánh giá ứng dụng này
Chạm vào ngôi sao để đánh giá
Một đánh giá nhắc đến tính năng
Bản đồ ngoại tuyến đã cứu chuyến đi của tôi. Dùng được khi không có sóng.
Bước 3
Bảng đánh giá của chính cửa hàng
Đồng ý sẽ mở bảng đánh giá của cửa hàng, giữ nguyên như cũ. Thông điệp vừa đọc cho họ một điều cụ thể để viết.
Nó được làm ra để làm gì
Nhiều đánh giá hơn từ cùng số người dùng
Họ được đề nghị vào thời điểm bạn chọn, kèm một lý do để trả lời.
Nhiều đánh giá có chữ hơn
Thông điệp về một tính năng mời họ viết, không chỉ chấm sao.
Từ khóa của bạn trong lời của họ
Đánh giá nhắc đến điều ứng dụng làm được cho người ghé sau biết ứng dụng dành cho ai.
Tín hiệu mà cửa hàng đọc
Apple và Google đều nói rằng xếp hạng sao và đánh giá có ảnh hưởng đến thứ hạng ứng dụng trong tìm kiếm.
Bảng điều khiển cho thấy ứng dụng của bạn đã thay đổi thế nào: số đánh giá có chữ mỗi ngày, số sao và số lần nhắc từ khóa, trước khi có pre-prompt và khi có.
Nguồn: Apple: tìm kiếm trên App Store · Google Play: khám phá và xếp hạng ứng dụng
Cách hoạt động
Thêm SDK
Cài đặt gói iOS, Android hoặc Unity và gọi initialize() một lần khi khởi chạy. Sau đó gọi requestReview() vào thời điểm bạn chọn, chẳng hạn khi hoàn thành một màn chơi, lưu một dự án hoặc hoàn tất một đơn hàng.
Biến lời mời đánh giá thành của riêng bạn
Trong bảng điều khiển, viết tiêu đề, thông điệp và nhãn của hai nút, hoặc để AI tích hợp soạn chúng từ chính các đánh giá của bạn. Chọn giao diện, thêm ảnh tiêu đề từ gói Startup trở lên, rồi chấp nhận: nội dung được dịch sang 10 ngôn ngữ và đến các thiết bị mà không cần cập nhật ứng dụng.
So sánh với nhóm kiểm soát
10% thiết bị không bao giờ thấy lời mời đánh giá và nhận màn hình gốc trực tiếp vào cùng các thời điểm. Bảng điều khiển đặt hai nhóm cạnh nhau và ghi lại điểm xếp hạng cùng số lượt xếp hạng trên cửa hàng mỗi ngày.
Đo lường so với nhóm kiểm soát, không phải giả định
Mọi ứng dụng đều có một nhóm kiểm soát. 10% thiết bị được gán vào nhóm này trong suốt vòng đời và không bao giờ thấy lời mời đánh giá: khi chúng đạt tới thời điểm bạn đã chọn, màn hình gốc được kích hoạt trực tiếp, như khi không có PromptSurge. Một ứng dụng mới cũng bắt đầu với giai đoạn khởi động gồm 50 thiết bị chỉ dùng màn hình gốc, để có mức cơ sở trước khi lời mời đánh giá đầu tiên được hiển thị.
Bảng điều khiển so sánh hai nhóm trên mọi thiết bị đã đạt tới thời điểm đánh giá của bạn: bao nhiêu thiết bị thấy lời mời đánh giá, bao nhiêu lượt nhấn tiếp, bao nhiêu màn hình gốc đã được yêu cầu. Bảng điều khiển chưa đưa ra kết luận cho đến khi mỗi bên có ít nhất 50 thiết bị.
Một giới hạn cần nói thẳng: Apple và Google không bao giờ cho ứng dụng biết người dùng đã xếp hạng hay chưa, hoặc họ đã viết gì. Vì vậy, bên cạnh phễu, PromptSurge ghi lại điểm xếp hạng và số lượt xếp hạng trên cửa hàng mỗi ngày một lần và hiển thị sự thay đổi. Đó là tổng số của cửa hàng, không được quy cho bất kỳ lời nhắc riêng lẻ nào, và bảng điều khiển nói rõ điều đó.
Nhóm kiểm soát 10%
Gán theo từng thiết bị, trọn đời. Màn hình gốc được kích hoạt trực tiếp vào cùng các thời điểm.
Giai đoạn khởi động 50 thiết bị
Ứng dụng mới bắt đầu chỉ với màn hình gốc, để mức cơ sở có trước.
Số liệu cửa hàng hằng ngày
Điểm xếp hạng trung bình và số lượt xếp hạng từ mỗi cửa hàng, mỗi ngày một lần, cho các ứng dụng có liên kết cửa hàng.
Câu hỏi thường gặp
Hỗ trợ những phiên bản Android nào?
minSdk 24 (Android 7.0) trở lên, Kotlin 1.9 trở lên, phân phối qua JitPack. Hộp thoại cần androidx.fragment, thư viện mà appcompat đã kèm sẵn.
Lời mời đánh giá liên quan thế nào đến hướng dẫn đánh giá trong ứng dụng của Google Play?
Google đề nghị các ứng dụng hiển thị thẻ đánh giá của mình nguyên vẹn, không có gì đè lên trên, và không đặt bất kỳ câu hỏi nào cho người dùng trước hoặc trong khi hiển thị thẻ, trong đó nêu rõ câu hỏi về ý kiến (“Bạn có thích ứng dụng này không?”) và câu hỏi mang tính dự đoán (“Bạn có chấm ứng dụng này 5 sao không?”). PromptSurge không bao giờ thay đổi hay che phủ thẻ của Play, hộp thoại của PromptSurge đã đóng trước khi thẻ mở ra, và nội dung mặc định cũng như nội dung được tạo của nó là những câu khẳng định đề nghị để lại đánh giá, không bao giờ là câu hỏi. Hướng dẫn của Google cũng nói rằng ứng dụng không nên đặt nút kêu gọi hành động kích hoạt luồng đánh giá, vì hạn mức có thể khiến thẻ không xuất hiện; nút xác nhận của lời mời đánh giá chính là một nút như vậy, vì vậy hãy cân nhắc hướng dẫn đó cho ứng dụng của bạn. Trong các phiên bản SDK hiện tại, PromptSurge bỏ qua lời mời đánh giá trên một thiết bị trong vòng 30 ngày kể từ lần cuối yêu cầu thẻ của Play, điều này giảm rủi ro đó nhưng không thể loại bỏ, vì Google không công bố hạn mức. Nếu bạn tự viết nội dung, hãy viết tiêu đề ở dạng câu khẳng định như ví dụ trên trang này; bảng điều khiển sẽ cảnh báo bạn về mọi câu hỏi.
Các cửa hàng nói gì, và ghi chú gửi App Review (tài liệu tiếng Anh) →Nhấn “Để sau” có dùng hết hạn mức của Play không?
Không. “Để sau” hoàn toàn không khởi chạy luồng đánh giá nào. Chỉ một lần xác nhận, hoặc các trường hợp chỉ dùng màn hình gốc cho giai đoạn khởi động, nhóm kiểm soát và hạn mức gói đã hết, mới gọi In-App Review API.
Tại sao không có gì xuất hiện trên thiết bị thử nghiệm của tôi?
Thường là do giai đoạn khởi động: một ứng dụng mới chỉ dùng thẻ của Play cho đến khi 50 thiết bị khác nhau đạt tới thời điểm đánh giá. Hãy tắt giai đoạn này cho ứng dụng trong bảng điều khiển khi thử nghiệm. Bản thân thẻ của Play cũng bị giới hạn bởi hạn mức và thường bị ẩn trên bản dựng debug.
Tôi khai báo gì trong Data Safety?
Device or other IDs, và App activity > App interactions: được thu thập, không chia sẻ, cho mục đích phân tích, không liên kết với người dùng, bên cạnh những gì phần còn lại của ứng dụng thu thập. README giải thích từng câu trả lời.
Liên quan
Bắt đầu miễn phí
Gói Indie miễn phí mãi mãi: một ứng dụng, 500 lần hiển thị prompt mỗi tháng, không cần thẻ tín dụng. Ảnh tiêu đề tùy chỉnh bắt đầu từ gói Startup với giá 39 € cho mỗi ứng dụng mỗi tháng. Giá tính bằng EUR, đã bao gồm VAT.
Hai lệnh gọi trong ứng dụng Android, phần còn lại trong bảng điều khiển
Gói miễn phí, không cần thẻ tín dụng. Tạo ứng dụng, sao chép khóa API và phát hành.
Tạo tài khoản miễn phí →Đã có tài khoản? Đăng nhập