SDK iOS
Lời nhắc đánh giá iOS cho SKStoreReviewController và requestReview
PromptSurge cho iOS là một gói Swift hiển thị lời mời đánh giá ngắn, mang thương hiệu của bạn, rồi gọi yêu cầu đánh giá của chính StoreKit 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í · iOS 14+ · Swift Package Manager
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 iOS làm gì cho bạn
Màn hình đánh giá của chính StoreKit
Khi xác nhận, SDK yêu cầu StoreKit hiển thị màn hình đánh giá với window scene của bạn: các phiên bản SDK hiện tại gọi AppStore.requestReview(in:) trên iOS 16 trở lên và SKStoreReviewController.requestReview(in:) trên các phiên bản trước đó. iOS quyết định màn hình có xuất hiện hay không, tối đa ba lần mỗi năm trên mỗi thiết bị; SDK không bao giờ tự vẽ sao hay tự thu thập xếp hạng.
UIKit và SwiftUI
Truyền vào bất kỳ view controller nào đang hiển thị; từ SwiftUI, hãy truyền root view controller của bạn. Hộp thoại là một thẻ UIKit được tạo bằng mã, tôn trọng vùng an toàn (safe area) và cuộn được khi nội dung dài.
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 bất cứ thứ gì xuất hiện. 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, yêu cầu gốc vẫn được kích hoạt, để thời điểm đó không bị bỏ lỡ.
Không có lời nhắc ATT, có sẵn tệp kê khai quyền riêng tư
Định danh duy nhất là giá trị băm SHA-256 có thêm salt của identifierForVendor và bundle ID của bạn; không có IDFA và không có lời nhắc App Tracking Transparency. PrivacyInfo.xcprivacy được kèm trong gói, và README cung cấp cho bạn các câu trả lời App Privacy.
Hiển thị không cần chờ
Gọi prefetch() khi khởi chạy và nội dung sẽ được lưu vào bộ nhớ đệm trên thiết bị, nên requestReview(in:) có thể hiển thị hộp thoại mà không cần chờ một lượt truy vấn mạng.
Tích hợp
Thêm gói trong Xcode (File > Add Package Dependencies, sau đó dán URL bên dưới và chọn sản phẩm PromptSurge). Khởi tạo một lần, rồi gọi requestReview(in:) vào thời điểm bạn chọn. Các bước đầy đủ, bao gồm cả Package.swift, có trong tài liệu.
URL của gói
https://github.com/PromptSurge-SDK/sdk-iosĐiểm khởi đầu ứng dụng (SwiftUI)
import SwiftUI
import PromptSurge
@main
struct YourApp: App {
init() {
PromptSurge.initialize(apiKey: "ps_live_your_key_here")
PromptSurge.prefetch() // warms the cache in the background
}
var body: some Scene {
WindowGroup { ContentView() }
}
}Tại thời điểm bạn chọn (UIKit)
import PromptSurge
class CheckoutViewController: UIViewController {
private func onPurchaseSuccess() {
PromptSurge.requestReview(in: self)
}
}Trong khi tích hợp, PromptSurge.setLogLevel(.info) in ra một dòng cho mỗi quyết định, bao gồm cả giai đoạn khởi động giữ một ứng dụng mới ở màn hình gốc trong 50 thiết bị đầu tiên.
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 iOS nào?
iOS 14 trở lên, xây dựng bằng Xcode 14 trở lên, cài đặt bằng Swift Package Manager.
Lời mời đánh giá có được phép theo hướng dẫn 5.6.1 của App Store không?
Hướng dẫn 5.6.1 nói rằng cần dùng API của Apple để yêu cầu đánh giá và Apple sẽ không cho phép các lời nhắc đánh giá tùy chỉnh. PromptSurge không bao giờ tự thu thập xếp hạng: số sao và nội dung đánh giá luôn diễn ra trong màn hình của chính Apple, được yêu cầu thông qua StoreKit. Hộp thoại xuất hiện trước đó là một lời đề nghị ngắn và không bao giờ hỏi người dùng cảm thấy thế nào. Tài liệu StoreKit của Apple cũng nói không gọi requestReview để phản hồi một lần nhấn nút, vì hệ thống có thể không hiển thị màn hình đánh giá; với lời mời đánh giá, chính lần nhấn xác nhận của người dùng là điều yêu cầu màn hình đó. Trong các phiên bản SDK hiện tại, PromptSurge ngừng hiển thị lời mời đánh giá trên một thiết bị khi đã yêu cầu màn hình của Apple trên thiết bị đó ba lần trong 365 ngày, giới hạn của chính Apple, nên một lời đồng ý ít khi bị bỏ lửng hơn. Cách Apple xét duyệt một ứng dụng cụ thể là quyết định của Apple, vì vậy hãy giữ mọi nội dung bạn tự viết ở dạng một câu khẳng định đơn giản và cân nhắc mô tả lời mời đánh giá trong ghi chú gửi App Review; bảng điều khiển sẽ cảnh báo bạn khi nội dung có 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) →Màn hình gốc có luôn xuất hiện sau khi xác nhận không?
Không, iOS quyết định. StoreKit hiển thị yêu cầu tối đa ba lần trong 365 ngày trên mỗi thiết bị, và với người đã xếp hạng thì chỉ hiển thị cho một phiên bản mới sau một năm. Trong các phiên bản SDK hiện tại, lời mời đánh giá không còn hiển thị trên một thiết bị khi SDK đã yêu cầu màn hình trên thiết bị đó ba lần trong 365 ngày. Cả SDK lẫn bất kỳ mã nào khác đều không thể biết màn hình đã xuất hiện hay chưa, hoặc người dùng đã xếp hạng hay chưa.
Tại sao không có gì xuất hiện trên thiết bị thử nghiệm của tôi?
Hầu như luôn là do giai đoạn khởi động: một ứng dụng mới chỉ dùng màn hình gốc 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 khởi động cho ứng dụng trong bảng điều khiển khi thử nghiệm, và bật setLogLevel(.info) để xem từng quyết định.
Tôi khai báo gì trong App Privacy?
Identifiers > Device ID và Usage Data > Product Interaction, cả hai cho mục đích phân tích, không liên kết với danh tính và không dùng để theo dõi, bên cạnh những gì phần còn lại của ứng dụng thu thập. README có bảng chi tiết.
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 iOS, 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