2026년의 Google Play 인앱 리뷰와 인앱 업데이트
Play Core의 두 기능이 앱이 스토어 등록정보에서 스스로 개선을 이어갈지를 조용히 결정합니다. 인앱 리뷰 API를 사용하면 사용자가 앱을 벗어나지 않고 별점과 리뷰를 남길 수 있습니다. 인앱 업데이트를 사용하면 Play 스토어에 접속하지 않고도 활성 사용자에게 최신 빌드로 이동하도록 요청할 수 있습니다. 잘 활용하면 평점이 오르고 구버전에 머무는 사용자 비중이 줄어들지만, 부주의하게 사용하면 사용자를 불편하게 만들고 보이지 않는 할당량을 소진하며 신호 대신 지원 문의만 쌓이게 됩니다.
이 튜토리얼은 실제 구현 순서대로 두 API를 다룹니다. 요건, 요청 시점, 설계 제약, 코드 경로, 그다음 실제 기기에서의 테스트입니다. 아래 내용은 모두 Google의 문서화된 Play Core 동작을 따르며, 두 가지 규칙이 전체를 규정합니다. 심사 대화상자가 나타나도록 강제할 수 없고, 업데이트가 원하는 일정에 설치될 것이라고 약속할 수 없습니다. 둘 다 Play가 결정합니다. 여러분의 역할은 적절한 시점에 올바른 흐름 유형으로 요청하고, 답이 '아니요'일 때도 앱이 계속 작동하도록 유지하는 것입니다.
1. 각 API의 기능 — 그리고 의도적으로 하지 않는 일
앱 내 리뷰 흐름을 사용하면 앱에서 Play 스토어 평점 카드를 표시할 수 있습니다. 사용자는 별 1~5개와 선택적 코멘트를 남길 수 있고, 리뷰는 Play 스토어로 전송되어 결국 표시됩니다. 얻지 못하는 것은 요청 자체에 대한 피드백입니다. API는 사용자가 리뷰를 남겼는지, 심지어 대화상자가 표시되었는지도 알려 주지 않습니다. 분기할 값도, 읽을 별점도, 카드를 필요할 때 다시 표시할 방법도 없습니다.
인앱 업데이트는 활성 사용자에게 새 버전 설치를 유도합니다. 원격 제어 스위치가 아닙니다. 설치가 몰래 진행되는 일은 없고, 재시작이 강제되는 일도 없으며, 업데이트는 더 높은 버전 코드로만 진행됩니다. 여러분이 제어하는 것은 흐름 유형(유연 또는 즉시)과 릴리스에 붙는 업데이트 우선순위를 통해 얼마나 강하게 권장할지입니다. 나머지는 모두 Play가 결정합니다.
UI를 설계하기 전에 알아둘 점이 하나 더 있습니다. 앱이 비공개 테스트 트랙에 있으면 리뷰 흐름을 통해 수집된 평점과 댓글은 공개되지 않고 개발자인 여러분에게 비공개로 공유됩니다. 리허설에는 유용하지만 공개 평점과 같은 데이터는 아닙니다.
2. 코드 작성 전 확인할 요건
- 인앱 리뷰는 Google Play 스토어가 설치된 Android 5.0(API 레벨 21) 이상을 실행하는 Android 기기(Google TV가 설치된 휴대폰, 태블릿, TV)와 Play 스토어가 설치된 ChromeOS 기기에서 작동합니다.
- 리뷰 연동에는 Play Core 라이브러리 버전 1.8.0 이상이 필요합니다. 현재 연동 가이드에서는
com.google.android.play:review:2.0.2를 사용하며, Kotlin의 경우com.google.android.play:review-ktx:2.0.2도 함께 사용합니다. - In-app updates are supported on Android 5.0 (API level 21) or higher, and only on Android phones, Android tablets and ChromeOS. They are not compatible with apps that use APK expansion files (
.obb). - 업데이트 통합은
com.google.android.play:app-update:2.1.0을 사용하며, Kotlin용으로com.google.android.play:app-update-ktx:2.1.0도 함께 사용합니다.
여기서 두 가지 결과가 따릅니다. 앱이 확장 파일을 배포한다면 인앱 업데이트는 선택할 수 없고, 대신 스토어 등록정보를 통해 업데이트를 안내해야 합니다. 그리고 Play 스토어가 없는 기기에서는 두 API 모두 아무 동작도 하지 않습니다. 즉 조용히 실패합니다. 따라서 기능이 사용 가능하다고 가정하지 말고, 직접 호출한 요청의 결과에 따라 UI를 제어하세요.
3. 인앱 리뷰: 요청이 허용되는 순간들
Google의 가이드라인은 짧고 엄격합니다. 사용자가 앱이나 게임을 충분히 경험해 유용한 피드백을 줄 수 있는 시점, 예컨대 레벨 하나를 완료했거나, 내보내기를 마쳤거나, 첫 세션을 성공적으로 마친 뒤에 플로우를 실행하세요. 과도하게 요청하지 마세요. 불필요한 요청 하나하나가 아래에 설명된 할당량을 소모하고, 기쁘게 해주려던 사용자를 짜증나게 합니다.
엄격히 금지되는 것은 사전 질문 행위입니다. 앱은 별점 버튼이나 카드가 표시되기 전이나 표시되는 동안 사용자에게 "앱이 마음에 드시나요?"와 같은 의견 질문이나 "이 앱에 별 5개를 주시겠어요?"와 같은 예측 질문을 포함해 어떤 것도 물어서는 안 됩니다. 불만족스러운 사용자를 먼저 걸러내는 것이 바로 이 규칙이 막으려는 행위입니다. 자체 진입점을 원한다면 항상 작동하는 단순 링크인 Play 스토어 등록정보로 연결하고, API는 직접 통제할 수 있는 순간에 사용하세요.
4. 인앱 리뷰: 양보할 수 없는 디자인 규칙
이 카드는 Play의 것이지 여러분의 디자인 시스템에 속하지 않습니다. 크기, 불투명도, 모양 또는 그 밖의 어떤 속성도 변경하지 말고 그대로 노출하세요. 카드 위나 주변에 오버레이를 올리지 말고, 카드와 그 배경을 최상위 레이어에 유지하세요. 카드가 표시된 후에는 프로그래밍 방식으로 절대 제거하지 마세요. 카드는 사용자의 명시적 조작이나 Play 스토어 내부 메커니즘에 의해서만 닫힙니다.
코드에서는 앱이 정상 경로를 이어가기 전, 예를 들어 다음 레벨로 넘어가기 전에 심사 플로우가 끝날 때까지 기다리세요. 플로우 도중 오류가 발생하더라도 사용자에게 알리지 말고 플로우를 바꾸지 마세요. 완료 콜백이 호출되면 평소대로 진행하면 됩니다.
5. 할당량: launchReviewFlow가 버튼이 아닌 이유
Play는 사용자에게 리뷰 대화상자를 표시할 수 있는 빈도에 시간 기반 할당량을 적용합니다. 그래서 launchReviewFlow를 짧은 기간 내에 두 번 이상 호출하면(Google 자체 예시는 한 달 이내) 아무것도 표시되지 않을 수 있습니다. 정확한 값은 구현 세부 사항이며 예고 없이 바뀔 수 있습니다.
할당량이 변동하기 때문에 성공을 전제로 한 UI를 만들면 안 됩니다. API를 호출하는 전용 CTA 버튼은 Google가 명시적으로 지적하는 안티패턴입니다. 사용자가 이미 할당량을 소진했을 수 있고, 흐름이 아예 나타나지 않아 버튼이 고장 난 것처럼 보이기 때문입니다. 의도적인 "평가하기" 클릭에는 대신 Play 스토어로 리디렉션하세요. API는 요청이 예상되고 대화상자가 없어도 티가 나지 않는 순간에만 사용하세요.
6. 인앱 리뷰: 코드 경로 단계별 안내
세 번의 통화, 이 순서대로.
- 매니저를 생성하세요.
ReviewManagerFactory.create(context)가 흐름을 시작하는ReviewManager를 반환합니다. - 정보를 미리 캐시하세요.
requestReviewFlow()를 호출합니다. 성공하면 실행에 필요한ReviewInfo객체를 받고, 실패하면ReviewException에서ReviewErrorCode를 읽어 로그로 남기세요.ReviewInfo객체는 유효 기간이 짧으므로 미리 요청하되, 흐름이 실행될 것이 확실해진 뒤에만 요청하세요. - 출시.
launchReviewFlow(activity, reviewInfo)가 카드를 표시합니다. 완료 콜백은 흐름이 끝났다는 것만 알려줍니다. 결과와 관계없이 앱 흐름을 계속 진행하세요.
7. 인앱 업데이트: 유연 또는 즉시
두 가지 흐름이 있으며, 각각 다른 제품 질문에 답합니다. 유연한 업데이트는 백그라운드에서 다운로드되며 상태를 원활하게 모니터링하므로, 업데이트가 도착하는 동안 사용자는 계속 작업할 수 있습니다. 새 버전이 몇 분쯤 기다릴 수 있는 기능이나 성능 개선을 추가할 때 적합한 선택입니다. 즉시 업데이트는 전체 화면 흐름으로, 계속하려면 사용자가 업데이트하고 재시작해야 합니다. 핵심 기능에 중요한 업데이트에 사용합니다. 사용자가 수락하면 Play가 설치와 앱 재시작을 모두 처리합니다.
실제 문제를 해결하는 가장 작은 플로우를 선택하세요. 에스컬레이션은 정당합니다. 먼저 부드럽게 알리고 결국 업데이트를 요구할 수 있습니다. 다만 이는 구현 시점에 한 번 내리는 결정이 아니라 우선순위와 최신성 로직에 속해야 합니다.
8. 경과 일수와 업데이트 우선순위: "얼마나 심각한가"를 표현하는 방식
두 가지 신호가 앱에 업데이트 지연 정도를 알려줍니다.
clientVersionStalenessDays()는 업데이트가 Play 스토어에서 제공된 이후 경과한 일수를 반환합니다. 이것이 자연스러운 단계적 상향 기준입니다. 유연한 프롬프트 전에 며칠 기다리고, 즉시 프롬프트를 요구하기 전에 또 며칠 기다리십시오.updatePriority()는 릴리스에 지정한 우선순위를 반환합니다. 0(기본값)에서 5(최고) 사이의 정수입니다. 이 값은 Google Play Developer API의Edits.tracks.releases아래inAppUpdatePriority필드로 설정합니다. 릴리스에 새로 추가된 모든 버전은 해당 릴리스의 우선순위를 공유하며, 우선순위는 새 릴리스를 배포하는 동안에만 설정할 수 있고 나중에 변경할 수 없으므로 게시 전에 값을 정해야 합니다.
많은 사람이 놓치는 미묘한 점이 하나 있습니다. 앱이 보는 우선순위는 설치된 버전과 최신 버전 사이의 모든 버전 코드를 반영하며, 각 버전이 어떤 트랙으로 출시되었든 마찬가지입니다. 버전 1을 우선순위 없이 프로덕션에, 버전 2를 우선순위 5로 내부 테스트 트랙에, 버전 3을 우선순위 없이 프로덕션에 출시하면, 버전 1에서 3으로 업데이트하는 프로덕션 사용자는 여전히 우선순위 5를 받습니다. 버전 2가 그 사이에 있기 때문입니다.
한계도 유의하세요. 내부 앱 공유에 빌드를 업로드할 때는 inAppUpdatePriority가 지원되지 않으므로, 우선순위에 의존하는 동작을 그 방식으로 리허설할 수 없습니다.
9. 업데이트 흐름 시작 및 결과 확인
먼저 사용 가능 여부를 확인하세요. AppUpdateManagerFactory.create(context)로 AppUpdateManager를 생성하고, appUpdateInfo를 읽고, updateAvailability()가 UPDATE_AVAILABLE을 보고하는지 확인한 뒤, 사용하려는 흐름 유형이 isUpdateTypeAllowed()로 허용되는지 확인하세요. 그런 다음에야 내장 StartIntentSenderForResult 계약에 등록된 액티비티 결과 런처와 함께 startUpdateFlowForResult()를 호출하세요.
각 AppUpdateInfo 인스턴스는 업데이트를 한 번만 시작할 수 있습니다. 업데이트가 실패해 재시도하려면 새 AppUpdateInfo를 요청하고 가용성과 권한을 다시 확인하세요. 콜백은 RESULT_OK(수락됨), RESULT_CANCELED(거부됨), RESULT_IN_APP_UPDATE_FAILED(그 밖의 이유로 동의나 업데이트가 차단됨)를 반환합니다. 즉시 업데이트의 경우 제어권이 앱으로 돌아오기 전에 업데이트가 대개 완료되므로 RESULT_OK를 아예 보지 못할 수도 있습니다.
AppUpdateOptions에는 기본값이 false인 AllowAssetPackDeletion 플래그도 있어, 기기 저장 공간이 부족할 때 업데이트로 에셋 팩을 정리할 수 있습니다. 이 플래그는 에셋을 삭제하기 위해 존재하므로 신중하게 설정하세요. 먼저 플래그를 false로 둔 상태에서 업데이트가 성공하는지 확인한 뒤에만 활성화하세요.
10. 유연한 업데이트: 모니터링, 다운로드, 그다음 재시작
플로우를 시작하기 전에 InstallStateUpdatedListener를 등록하고, 업데이트가 더 이상 필요 없을 때 등록을 해제하세요. 상태가 DOWNLOADING인 동안 bytesDownloaded()와 totalBytesToDownload()를 읽어 실제 진행률을 표시할 수 있습니다. 상태가 DOWNLOADED에 도달해도 Play가 앱을 자동으로 재시작하지 않습니다. 그것이 유연한 플로우의 핵심입니다. 알림이나 스낵바를 표시하고 사용자가 확인하게 한 뒤, 확인하면 completeUpdate()를 호출하세요.
이 호출이 어디서 일어나는지가 경험을 바꿉니다. 포그라운드에서는 플랫폼이 전체 화면 UI를 표시하고 앱을 백그라운드에서 재시작하며, 백그라운드에서는 업데이트가 조용히 설치됩니다. 어느 경우든 앱으로 진입하는 모든 지점에서(보통 onResume()) 업데이트가 여전히 DOWNLOADED 상태로 남아 있는지 확인하고, 그렇다면 다시 안내하세요. 그렇지 않으면 다운로드된 바이트가 설치되지 않은 채로 사용자의 저장 공간을 계속 차지합니다.
11. 즉시 업데이트: 멈춘 플로우 재개
사용자가 즉시 업데이트를 수락하면 Play는 전체 진행 과정 동안 앱 UI 위에 진행 상황을 표시하며, 사용자가 앱을 닫거나 종료해도 다운로드와 설치는 백그라운드에서 계속됩니다. 업데이트 측면에서는 편리하지만 코드 입장에서는 까다롭습니다. 앱이 다시 포그라운드로 돌아왔을 때 해당 흐름이 공식적으로 완료되지 않은 상태일 수 있기 때문입니다.
onResume()에서 처리하세요. updateAvailability()가 DEVELOPER_TRIGGERED_UPDATE_IN_PROGRESS를 보고하면 startUpdateFlowForResult()를 다시 호출해 재개하세요. 사용자가 거부하거나 취소하면 Play UI가 닫히고 앱이 선택해야 합니다. 업데이트 없이 실행할 수 있다면 계속 이용하게 하고 나중에 다시 요청하세요. 정말로 실행할 수 없다면 흐름을 다시 시작하기 전에 쉬운 말로 그 사실을 알려, 재시작이 크래시 루프로 느껴지지 않고 이해되도록 하세요.
12. 실제 기기에서 두 API 모두 테스트하기
"작동하지 않는" 연동 사례는 대부분 테스트 과정에서 생긴 문제입니다. 인앱 업데이트의 경우 내부 앱 공유가 표준 경로입니다. 테스트 기기에 내부 앱 공유 URL로 설치한, 인앱 업데이트를 지원하는 빌드가 있는지 확인하고, 버전 코드가 더 높은 버전을 업로드한 뒤, 기기에서 새 버전의 공유 링크를 열되 나타나는 Play 페이지에서 설치하지 않고, 런처에서 앱을 실행하세요. 그러면 이제 앱에 업데이트가 제공되어야 합니다.
그래도 해결되지 않는다면 흔한 네 가지 원인을 확인하세요. 계정이 해당 앱을 소유해야 하며, 즉 Play에서 앱을 한 번 이상 다운로드한 이력이 있어야 합니다. 테스트 빌드는 Play 버전과 애플리케이션 ID 및 서명 키를 공유해야 합니다. 설치된 버전 코드가 업데이트보다 낮아야 합니다. 그리고 inAppUpdatePriority는 내부 앱 공유에서 지원되지 않으므로 우선순위 기반 흐름은 그곳에서 다르게 보입니다.
심사 측면에서 실질적인 차이는 테스터가 보는 화면입니다. 비공개 테스트 트랙에서는 수집된 평점과 댓글이 공개되지 않고 개발자에게만 비공개로 전달됩니다. 연동과 타이밍을 검증하기에는 좋지만, 실제 평점 변화를 대신하는 지표는 아닙니다.
13. 양쪽 모두 출시 후 주시할 항목
리뷰 요청은 평점 수를 서서히 늘려야 하며, 출시 시점과 겹치는 급증이 있어서는 안 됩니다. 급증은 품질 변화가 아니라 타이밍 효과이며, 흔한 원인은 세션 초반에 너무 일찍 배치된 요청입니다. 업데이트의 경우 최신 버전 코드를 사용하는 활성 사용자 비율을 주 단위로 추적하세요. 유연한 업데이트는 평균 평점에 영향을 주지 않으면서 이 수치를 끌어올려야 하고, 구버전 빌드에서 들어오는 버그 신고 수를 줄여야 합니다.
프롬프트가 앱 삭제나 분노한 별점 1점 댓글과 연관된다면, 답은 더 자주 또는 설치 주기 초반에 프롬프트를 띄우는 것이 아닙니다. 앱의 가치가 이미 입증된 사용자 여정 더 깊은 곳으로 트리거를 옮기세요.
개발자 계정을 대규모로 운영하시나요? 운영 업무를 저희가 처리합니다.
메시지를 접수했습니다. 24시간 이내에 답변드리겠습니다.
← 수정으로 돌아가기