PromptSurge

iOS SDK

SKStoreReviewController와 requestReview를 위한 iOS 리뷰 요청 프롬프트

iOS용 PromptSurge는 브랜드에 맞춘 짧은 사전 프롬프트를 보여준 뒤, 사용자가 확인하면 StoreKit의 리뷰 요청을 호출하는 Swift 패키지입니다. 코드에는 호출 두 개만 넣으면 되고, 문구, 테마, 헤더 이미지, 언어는 서버에서 제공됩니다.

무료 플랜 · iOS 14+ · Swift Package Manager

1 · 나만의 사전 프롬프트

나만의 헤더 이미지

작은 부탁이 있습니다

오프라인 동기화에 공을 많이 들였습니다. 짧은 리뷰가 다른 사람들이 이 앱을 발견하는 데 도움이 됩니다.

나중에리뷰 남기기

2 · 네이티브 평점 시트

App Store 또는 Google Play

Apple 또는 Google의 시트가 변경 없이 그대로 표시됩니다

'나중에'를 누르면 다이얼로그가 닫히고 그 외에는 아무것도 표시되지 않습니다.

iOS SDK가 해주는 일

StoreKit 자체 리뷰 시트

확인을 탭하면 SDK가 window scene과 함께 StoreKit에 리뷰 시트를 요청합니다. 현재 SDK 버전은 iOS 16 이상에서 AppStore.requestReview(in:)를, 그 이전 버전에서는 SKStoreReviewController.requestReview(in:)를 호출합니다. 시트를 표시할지는 iOS가 결정하며(기기당 1년에 최대 세 번), SDK는 별을 그리거나 직접 평점을 수집하지 않습니다.

UIKit과 SwiftUI

표시를 담당할 뷰 컨트롤러를 아무거나 전달하세요. SwiftUI에서는 루트 뷰 컨트롤러를 넘기면 됩니다. 다이얼로그는 코드로 만든 UIKit 카드로, safe area를 지키고 긴 문구는 스크롤됩니다.

모든 표시 조건 검사 내장

옵트아웃, 기기당 90일 쿨다운, 10% 대조군, 기기 50대 워밍업, 플랜의 월간 한도를 무언가 표시되기 전에 검사합니다. 워밍업, 대조군, 한도 소진 때문에 사전 프롬프트를 보류하더라도 네이티브 요청은 그대로 실행되므로 그 순간을 놓치지 않습니다.

ATT 프롬프트 없음, 개인정보 매니페스트 포함

유일한 식별자는 identifierForVendor와 번들 ID를 솔트 처리한 SHA-256 해시입니다. IDFA도, App Tracking Transparency 프롬프트도 없습니다. PrivacyInfo.xcprivacy가 패키지에 포함되어 있고, README에 App Privacy 답변이 정리되어 있습니다.

기다림 없이 표시

앱 실행 시 prefetch()를 호출하면 문구가 기기에 캐시되므로, requestReview(in:)가 네트워크 왕복 없이 다이얼로그를 표시할 수 있습니다.

통합 방법

Xcode에서 패키지를 추가하세요(File > Add Package Dependencies에서 아래 URL을 붙여넣고 PromptSurge 제품을 선택). 한 번 초기화한 뒤 원하는 순간에 requestReview(in:)를 호출하면 됩니다. Package.swift를 포함한 전체 단계는 문서에 있습니다.

패키지 URL

https://github.com/PromptSurge-SDK/sdk-ios

앱 진입점 (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() }
    }
}

원하는 순간에 (UIKit)

import PromptSurge

class CheckoutViewController: UIViewController {
    private func onPurchaseSuccess() {
        PromptSurge.requestReview(in: self)
    }
}

통합하는 동안 PromptSurge.setLogLevel(.info)를 켜면 판단마다 한 줄씩 출력됩니다. 새 앱을 처음 기기 50대 동안 네이티브 시트로만 유지하는 워밍업도 여기에 표시됩니다.

통합 문서 보기 →

휴대폰 화면에서

사용자가 보게 되는 것, 3단계

같은 사용자, 같은 순간입니다. 차이는 먼저 앱에 대한 말로 부탁한다는 점입니다.

  1. 여행이 저장되었습니다

    오프라인에서 사용 가능

    requestReview()

    1단계

    순간은 당신의 코드가 정합니다

    여행 저장이나 레벨 완료처럼 무언가 잘된 직후에 requestReview()를 호출하세요.

  2. 작은 부탁이 있어요

    오프라인 지도에 공을 많이 들였습니다. 짧은 리뷰 하나가 다른 여행자들이 이 앱을 찾는 데 도움이 됩니다.

    나중에좋아요

    2단계

    프리프롬프트가 당신의 말로 부탁합니다

    앱이 무엇을 하는지 짚어 주는 짧은 메시지입니다. 나중에를 누르면 닫히고 그 밖의 일은 일어나지 않습니다.

  3. 이 앱 평가하기

    별을 눌러 평가하세요

    기능을 언급한 리뷰

    오프라인 지도 덕분에 여행을 망치지 않았어요. 신호가 없어도 됩니다.

    3단계

    스토어의 평가 창 그대로

    좋아요를 누르면 스토어의 창이 그대로 열립니다. 방금 읽은 메시지가 구체적으로 쓸 거리를 줍니다.

무엇을 위해 만들었나

  1. 같은 사용자에게서 더 많은 리뷰

    당신이 고른 순간에, 답할 이유와 함께 부탁합니다.

  2. 글로 쓴 리뷰가 늘어납니다

    기능에 대한 메시지는 별점만이 아니라 글을 이끌어 냅니다.

  3. 당신의 키워드가 사용자의 말로

    앱이 무엇을 하는지 언급한 리뷰는 다음 방문자에게 누구를 위한 앱인지 알려 줍니다.

  4. 스토어가 읽는 신호

    Apple과 Google 모두 평점과 리뷰가 검색에서 앱 순위에 반영된다고 밝히고 있습니다.

대시보드에서 당신의 앱에 생긴 변화를 볼 수 있습니다. 하루 작성 리뷰 수, 별점, 키워드 언급을 프리프롬프트 이전과 이후로 비교합니다.

출처: Apple: App Store 검색 · Google Play: 앱 검색 노출 및 순위

작동 방식

  1. SDK 추가

    iOS, Android 또는 Unity 패키지를 설치하고 앱 실행 시 initialize()를 한 번 호출하세요. 그런 다음 레벨 완료, 프로젝트 저장, 주문 완료처럼 원하는 순간에 requestReview()를 호출하세요.

  2. 나만의 사전 프롬프트 만들기

    대시보드에서 제목, 메시지, 두 개의 버튼 레이블을 작성하거나, 내장 AI가 기존 리뷰를 바탕으로 초안을 작성하게 하세요. 테마를 고르고, Startup 이상이라면 헤더 이미지를 추가한 뒤 수락하세요. 문구가 10개 언어로 번역되어 앱 업데이트 없이 기기에 전달됩니다.

  3. 대조군과 비교

    기기의 10%는 사전 프롬프트를 보지 않고 같은 순간에 네이티브 시트를 바로 받습니다. 대시보드는 두 그룹을 나란히 보여주고, 스토어 평점과 평점 수를 매일 기록합니다.

추정이 아니라 대조군과 비교해 측정합니다

모든 앱에는 대조군(홀드아웃 그룹)이 있습니다. 기기의 10%가 평생 대조군에 배정되어 사전 프롬프트를 보지 않습니다. 이 기기들이 선택한 순간에 도달하면, PromptSurge가 없을 때처럼 네이티브 시트가 바로 실행됩니다. 새 앱은 또한 네이티브 시트만 사용하는 기기 50대의 워밍업으로 시작하므로, 첫 사전 프롬프트가 표시되기 전에 기준선이 마련됩니다.

대시보드는 리뷰 요청 시점에 도달한 모든 기기를 대상으로 두 그룹을 비교합니다. 사전 프롬프트를 본 기기 수, 탭스루한 기기 수, 요청된 네이티브 시트 수입니다. 양쪽 모두 기기가 최소 50대가 될 때까지는 결론을 내리지 않습니다.

정직하게 밝혀 둘 한계가 하나 있습니다. Apple과 Google은 사용자가 평가했는지, 무엇을 썼는지 앱에 절대 알려주지 않습니다. 그래서 PromptSurge는 퍼널 옆에 스토어 평점과 평점 수를 하루에 한 번 기록하고 그 변화를 보여줍니다. 이는 스토어 전체 수치이며 특정 프롬프트의 성과로 귀속되지 않고, 대시보드에도 그렇게 표시됩니다.

10% 대조군

기기 단위로 평생 배정됩니다. 같은 순간에 네이티브 시트가 바로 실행됩니다.

기기 50대 워밍업

새 앱은 네이티브 시트만으로 시작하므로 기준선이 먼저 만들어집니다.

일별 스토어 스냅샷

스토어 링크가 있는 앱의 경우, 각 스토어의 평균 평점과 평점 수를 하루에 한 번 기록합니다.

자주 묻는 질문

지원하는 iOS 버전은 무엇인가요?

iOS 14 이상이며, Xcode 14 이상으로 빌드하고 Swift Package Manager로 설치합니다.

App Store 가이드라인 5.6.1에서 사전 프롬프트가 허용되나요?

가이드라인 5.6.1은 리뷰를 요청할 때 Apple의 API를 사용하라고 하며, Apple이 커스텀 리뷰 프롬프트를 허용하지 않는다고 말합니다. PromptSurge는 평점을 직접 수집하지 않습니다. 별점과 리뷰 텍스트는 항상 StoreKit을 통해 요청되는 Apple의 시트 안에서 이루어집니다. 그 앞의 다이얼로그는 사용자의 기분을 절대 묻지 않는 짧은 요청입니다. Apple의 StoreKit 문서는 또한 시스템이 시트를 표시하지 않을 수 있으므로 버튼 탭에 대한 응답으로 requestReview를 호출하지 말라고 합니다. 사전 프롬프트를 사용하면 사용자가 확인을 탭하는 동작이 바로 시트를 요청합니다. 현재 SDK 버전에서는 한 기기에서 Apple의 시트를 365일 동안 세 번 요청하면(Apple 자체의 한도입니다) 그 기기에서는 더 이상 사전 프롬프트를 표시하지 않으므로, '예'가 아무 반응 없이 끝나는 일이 줄어듭니다. 특정 앱을 Apple이 어떻게 심사할지는 Apple이 결정하므로, 직접 작성하는 문구는 단순한 평서문으로 유지하고 App Review용 메모에 사전 프롬프트를 설명하는 것도 고려해 보세요. 문구에 질문이 있으면 대시보드가 경고합니다.

스토어가 말하는 내용과 App Review용 메모(영문 문서) →

확인 후 항상 네이티브 시트가 표시되나요?

아니요, iOS가 결정합니다. StoreKit은 기기당 365일 동안 최대 세 번 요청을 표시하며, 이미 평가한 사용자에게는 1년이 지난 뒤 새 버전에 대해서만 표시합니다. 현재 SDK 버전에서는 SDK가 한 기기에서 365일 동안 시트를 세 번 요청하면 그 기기에서는 더 이상 사전 프롬프트를 표시하지 않습니다. SDK를 포함해 어떤 코드도 시트가 표시되었는지, 사용자가 평가했는지 알 수 없습니다.

테스트 기기에 아무것도 표시되지 않는 이유는 무엇인가요?

거의 항상 워밍업 때문입니다. 새 앱은 서로 다른 기기 50대가 리뷰 요청 시점에 도달할 때까지 네이티브 시트만 사용합니다. 테스트하는 동안 대시보드에서 해당 앱의 워밍업을 끄고, setLogLevel(.info)를 켜서 각 판단을 확인하세요.

App Privacy에는 무엇을 신고해야 하나요?

앱의 나머지 부분이 수집하는 항목에 더해, Identifiers > Device ID와 Usage Data > Product Interaction을 신고합니다. 둘 다 분석 목적이며, 사용자 신원에 연결되지 않고 추적에 사용되지 않습니다. 표는 README에 있습니다.

iOS 앱에는 호출 두 개, 나머지는 대시보드에서

무료 플랜, 신용카드 불필요. 앱을 만들고 API 키를 복사해 출시하세요.

무료 계정 만들기 →

이미 계정이 있으신가요? 로그인