Android SDK
Google Play In-App Review API로 구현하는 Android 인앱 리뷰
Android용 PromptSurge는 브랜드에 맞춘 짧은 사전 프롬프트를 보여준 뒤, 사용자가 확인하면 Google Play의 In-App Review 흐름을 실행하는 Kotlin 라이브러리입니다. 코드에는 호출 두 개만 넣으면 되고, 문구, 테마, 헤더 이미지, 언어는 서버에서 제공됩니다.
무료 플랜 · minSdk 24 · JitPack
1 · 나만의 사전 프롬프트
작은 부탁이 있습니다
오프라인 동기화에 공을 많이 들였습니다. 짧은 리뷰가 다른 사람들이 이 앱을 발견하는 데 도움이 됩니다.
2 · 네이티브 평점 시트
App Store 또는 Google Play
Apple 또는 Google의 시트가 변경 없이 그대로 표시됩니다
Android SDK가 해주는 일
Play 자체 리뷰 카드
확인을 탭하면 SDK가 ReviewManager의 requestReviewFlow()와 launchReviewFlow()를 실행합니다. 카드는 Google의 것이며 그대로 표시됩니다. 사전 프롬프트는 이미 닫혀 있고, 카드를 표시할지는 Play 자체의 할당량이 결정합니다.
어떤 앱 테마에도 맞음
다이얼로그는 Material 3입니다. Material 테마에서는 앱의 스타일을 이어받고, AppCompat, 플랫폼 또는 커스텀 게임 테마에서는 크래시 대신 자체 내장 테마로 대체됩니다. 대시보드 색상은 그 위에 적용됩니다.
프로덕션 앱에서도 안전
minSdk 24, 런타임 권한 없음, 매니페스트에 추가되는 항목 없음, AAR에 R8 규칙 포함. 액티비티가 종료 중이거나, 상태가 이미 저장되었거나, 다이얼로그가 이미 떠 있으면 requestReview()는 아무 작업도 하지 않습니다.
모든 표시 조건 검사 내장
옵트아웃, 기기당 90일 쿨다운, 10% 대조군, 기기 50대 워밍업, 플랜의 월간 한도를 먼저 검사합니다. 워밍업, 대조군, 한도 소진 때문에 사전 프롬프트를 보류하더라도 Play의 리뷰 흐름은 그대로 실행되므로 그 순간을 놓치지 않습니다.
Data Safety 답변 포함
유일한 식별자는 ANDROID_ID와 패키지 이름의 SHA-256이며, 원본 ID는 절대 사용하지 않고 광고 ID도 사용하지 않습니다. README에 Play Data Safety 양식에 신고할 내용이 정확히 나와 있습니다.
통합 방법
JitPack과 Gradle 의존성 하나를 추가하고(좌표와 최신 버전은 문서에 있습니다), Application에서 초기화한 뒤 원하는 순간에 requestReview()를 호출하세요.
Application.onCreate()
import com.promptsurge.sdk.PromptSurge
class MyApp : Application() {
override fun onCreate() {
super.onCreate()
PromptSurge.initialize(this, "ps_live_your_key_here")
}
}원하는 순간에
// In an Activity (AppCompatActivity works)
PromptSurge.requestReview(this)
// Or from a Fragment
PromptSurge.requestReview(requireActivity())통합하는 동안 PromptSurge.setLogLevel(PromptSurge.LogLevel.INFO)를 켜면 판단마다 한 줄씩 출력됩니다. Play의 카드는 할당량 제한이 있어 디버그 빌드에서는 아무것도 표시되지 않는 경우가 많으므로, 그곳에서 카드가 보이지 않는 것은 정상입니다.
사용자가 보게 되는 것, 3단계
같은 사용자, 같은 순간입니다. 차이는 먼저 앱에 대한 말로 부탁한다는 점입니다.
여행이 저장되었습니다
오프라인에서 사용 가능
requestReview()
1단계
순간은 당신의 코드가 정합니다
여행 저장이나 레벨 완료처럼 무언가 잘된 직후에 requestReview()를 호출하세요.
작은 부탁이 있어요
오프라인 지도에 공을 많이 들였습니다. 짧은 리뷰 하나가 다른 여행자들이 이 앱을 찾는 데 도움이 됩니다.
나중에좋아요2단계
프리프롬프트가 당신의 말로 부탁합니다
앱이 무엇을 하는지 짚어 주는 짧은 메시지입니다. 나중에를 누르면 닫히고 그 밖의 일은 일어나지 않습니다.
이 앱 평가하기
별을 눌러 평가하세요
기능을 언급한 리뷰
오프라인 지도 덕분에 여행을 망치지 않았어요. 신호가 없어도 됩니다.
3단계
스토어의 평가 창 그대로
좋아요를 누르면 스토어의 창이 그대로 열립니다. 방금 읽은 메시지가 구체적으로 쓸 거리를 줍니다.
무엇을 위해 만들었나
같은 사용자에게서 더 많은 리뷰
당신이 고른 순간에, 답할 이유와 함께 부탁합니다.
글로 쓴 리뷰가 늘어납니다
기능에 대한 메시지는 별점만이 아니라 글을 이끌어 냅니다.
당신의 키워드가 사용자의 말로
앱이 무엇을 하는지 언급한 리뷰는 다음 방문자에게 누구를 위한 앱인지 알려 줍니다.
스토어가 읽는 신호
Apple과 Google 모두 평점과 리뷰가 검색에서 앱 순위에 반영된다고 밝히고 있습니다.
대시보드에서 당신의 앱에 생긴 변화를 볼 수 있습니다. 하루 작성 리뷰 수, 별점, 키워드 언급을 프리프롬프트 이전과 이후로 비교합니다.
작동 방식
SDK 추가
iOS, Android 또는 Unity 패키지를 설치하고 앱 실행 시 initialize()를 한 번 호출하세요. 그런 다음 레벨 완료, 프로젝트 저장, 주문 완료처럼 원하는 순간에 requestReview()를 호출하세요.
나만의 사전 프롬프트 만들기
대시보드에서 제목, 메시지, 두 개의 버튼 레이블을 작성하거나, 내장 AI가 기존 리뷰를 바탕으로 초안을 작성하게 하세요. 테마를 고르고, Startup 이상이라면 헤더 이미지를 추가한 뒤 수락하세요. 문구가 10개 언어로 번역되어 앱 업데이트 없이 기기에 전달됩니다.
대조군과 비교
기기의 10%는 사전 프롬프트를 보지 않고 같은 순간에 네이티브 시트를 바로 받습니다. 대시보드는 두 그룹을 나란히 보여주고, 스토어 평점과 평점 수를 매일 기록합니다.
추정이 아니라 대조군과 비교해 측정합니다
모든 앱에는 대조군(홀드아웃 그룹)이 있습니다. 기기의 10%가 평생 대조군에 배정되어 사전 프롬프트를 보지 않습니다. 이 기기들이 선택한 순간에 도달하면, PromptSurge가 없을 때처럼 네이티브 시트가 바로 실행됩니다. 새 앱은 또한 네이티브 시트만 사용하는 기기 50대의 워밍업으로 시작하므로, 첫 사전 프롬프트가 표시되기 전에 기준선이 마련됩니다.
대시보드는 리뷰 요청 시점에 도달한 모든 기기를 대상으로 두 그룹을 비교합니다. 사전 프롬프트를 본 기기 수, 탭스루한 기기 수, 요청된 네이티브 시트 수입니다. 양쪽 모두 기기가 최소 50대가 될 때까지는 결론을 내리지 않습니다.
정직하게 밝혀 둘 한계가 하나 있습니다. Apple과 Google은 사용자가 평가했는지, 무엇을 썼는지 앱에 절대 알려주지 않습니다. 그래서 PromptSurge는 퍼널 옆에 스토어 평점과 평점 수를 하루에 한 번 기록하고 그 변화를 보여줍니다. 이는 스토어 전체 수치이며 특정 프롬프트의 성과로 귀속되지 않고, 대시보드에도 그렇게 표시됩니다.
10% 대조군
기기 단위로 평생 배정됩니다. 같은 순간에 네이티브 시트가 바로 실행됩니다.
기기 50대 워밍업
새 앱은 네이티브 시트만으로 시작하므로 기준선이 먼저 만들어집니다.
일별 스토어 스냅샷
스토어 링크가 있는 앱의 경우, 각 스토어의 평균 평점과 평점 수를 하루에 한 번 기록합니다.
자주 묻는 질문
지원하는 Android 버전은 무엇인가요?
minSdk 24(Android 7.0) 이상, Kotlin 1.9 이상이며 JitPack으로 배포됩니다. 다이얼로그에는 androidx.fragment가 필요하며, appcompat에 이미 포함되어 있습니다.
사전 프롬프트는 Google Play의 인앱 리뷰 가이드라인과 어떤 관계가 있나요?
Google은 앱이 리뷰 카드를 변경 없이, 그 위에 아무것도 올리지 않은 채 표시하고, 카드를 표시하기 전이나 표시하는 동안 사용자에게 어떤 질문도 하지 말 것을 요청하며, 그 예로 의견 질문('앱이 마음에 드시나요?')과 예측 질문('이 앱에 별 5개를 주시겠어요?')을 듭니다. PromptSurge는 Play의 카드를 변경하거나 그 위에 무언가를 겹쳐 표시하지 않으며, 카드가 열리기 전에 자체 다이얼로그는 이미 닫혀 있고, 기본 문구와 생성된 문구는 질문이 아니라 리뷰를 요청하는 평서문입니다. Google 가이드는 또한 할당량 때문에 카드가 표시되지 않을 수 있으므로 리뷰 흐름을 트리거하는 행동 유도(CTA) 버튼을 제공해서는 안 된다고 말합니다. 사전 프롬프트의 확인 버튼이 바로 그런 버튼이므로, 이 지침을 앱에 맞게 따져 보세요. 현재 SDK 버전에서는 Play 카드를 마지막으로 요청한 지 30일이 지나지 않은 기기에서는 사전 프롬프트를 건너뜁니다. 이렇게 하면 위험이 줄어들지만, Google이 할당량을 공개하지 않으므로 없앨 수는 없습니다. 직접 문구를 작성한다면 이 페이지의 예시처럼 제목을 평서문으로 쓰세요. 질문이 있으면 대시보드가 경고합니다.
스토어가 말하는 내용과 App Review용 메모(영문 문서) →'나중에'를 누르면 Play의 할당량이 소모되나요?
아니요. '나중에'는 리뷰 흐름을 전혀 실행하지 않습니다. In-App Review API를 호출하는 것은 확인, 그리고 워밍업, 대조군, 플랜 한도 소진 시의 네이티브 전용 경로뿐입니다.
테스트 기기에 아무것도 표시되지 않는 이유는 무엇인가요?
대개 워밍업 때문입니다. 새 앱은 서로 다른 기기 50대가 리뷰 요청 시점에 도달할 때까지 Play의 카드만 사용합니다. 테스트하는 동안 대시보드에서 해당 앱의 워밍업을 끄세요. Play 자체 카드도 할당량 제한이 있어 디버그 빌드에서는 표시되지 않는 경우가 많습니다.
Data Safety에는 무엇을 신고해야 하나요?
앱의 나머지 부분이 수집하는 항목에 더해, Device or other IDs와 App activity > App interactions를 수집됨, 공유되지 않음, 분석 목적, 사용자와 연결되지 않음으로 신고합니다. README에 각 답변이 설명되어 있습니다.
관련 페이지
무료로 시작하기
Indie 플랜은 영구 무료입니다. 앱 1개, 월 500회 사전 프롬프트 노출, 신용카드 불필요. 맞춤 헤더 이미지는 앱당 월 €39인 Startup부터 제공됩니다. 가격은 EUR 기준이며 부가세가 포함되어 있습니다.
Android 앱에는 호출 두 개, 나머지는 대시보드에서
무료 플랜, 신용카드 불필요. 앱을 만들고 API 키를 복사해 출시하세요.
무료 계정 만들기 →이미 계정이 있으신가요? 로그인