Google Play In-App Review API를 사용하면 앱 또는 게임을 종료하는 불편함 없이 Play 스토어 평점 및 리뷰를 제출하도록 요청하는 메시지를 사용자에게 표시할 수 있습니다.
일반적으로 인앱 리뷰 흐름(그림 1 참고)은 사용자가 앱을 사용하는 동안 언제든지 트리거될 수 있습니다. 흐름 도중 사용자는 1~5점의 별점 시스템을 사용하여 앱을 평가하고 선택적으로 댓글을 추가할 수 있습니다. 제출이 완료되면 리뷰가 Play 스토어로 전송되며 결과적으로는 표시됩니다.
그림 1. 사용자의 인앱 리뷰 흐름
기기 요구사항
인앱 리뷰는 다음 기기에서만 작동합니다.
Google Play 스토어가 설치되었으며 Android 5.0 (API 수준 21) 이상을 실행하는 Android 기기(스마트폰, 태블릿, Google TV가 탑재된 TV)
다음 가이드라인을 따르면 사용자에게 인앱 리뷰를 요청할 시기를 결정하는 데 도움이 됩니다.
사용자가 유용한 의견을 제공할 수 있을 정도로 충분히 앱 또는 게임을 사용한 이후에 인앱 리뷰 흐름을 트리거합니다.
사용자에게 리뷰를 요청하는 메시지를 과도하게 표시해서는 안 됩니다. 이 접근 방식을 통해 사용자의 불만을 최소화하고 API 사용을 제한할 수 있습니다 (할당량 섹션 참고).
앱은 사용자에게 평점 버튼 또는 카드를 표시하기 전이나 표시하는 동안 사용자 의견 관련 질문 (예: '앱이 마음에 드십니까?') 또는 예측 질문 (예: '이 앱을 별 5개로 평가하시겠습니까?')을 포함하여 어떤 질문도 해서는 안 됩니다.
디자인 가이드라인
앱에 인앱 리뷰를 통합하는 방법을 결정할 때 다음 가이드라인을 따르세요.
크기, 불투명도, 모양 또는 기타 속성을 비롯하여 기존 디자인을 어떠한 방식으로든 변조하거나 수정하지 않고 카드를 있는 그대로 표시합니다.
카드 상단 또는 카드 주변에 오버레이를 추가해서는 안 됩니다.
카드와 카드의 배경은 최상위 레이어에 있어야 합니다. 카드가 표시되면 프로그래매틱 방식으로 카드를 삭제해서는 안 됩니다. 카드는 사용자의 명시적 작업 또는 내부 Play 스토어 메커니즘에 따라 자동으로 삭제됩니다.
할당량
우수한 사용자 환경을 제공하기 위해 Google Play는 사용자에게 리뷰 대화상자를 표시할 수 있는 빈도에 관한 시간제한 할당량을 적용합니다. 이 할당량으로 인해 짧은 기간(예: 1개월 미만) launchReviewFlow 메서드를 두 번 이상 호출할 경우 대화상자가 표시되지 않을 수도 있습니다.
할당량은 변경될 수 있으므로 자체 로직을 적용하고 리뷰를 요청하는 최적의 순간을 타겟팅하는 것이 중요합니다. 예를 들어 사용자가 이미 할당량에 도달하고 흐름이 표시되지 않아 사용자에게 단절된 경험을 제공할 수 있으므로 API를 트리거하는 클릭 유도문안 옵션 (예: 버튼)이 있어서는 안 됩니다. 이 사용 사례의 경우 사용자를 대신 Play 스토어로 리디렉션합니다.
Play In-App Review 라이브러리에 액세스하거나 이를 사용하면 Play Core 소프트웨어 개발 키트 서비스 약관에 동의하는 것으로 간주됩니다. 라이브러리에 액세스하기 전에 모든 관련 약관 및 정책을 자세히 읽고 숙지하세요.
데이터 보안
Play Core 라이브러리는 Google Play 스토어와 연결하는 앱의 런타임 인터페이스입니다. 따라서 앱에서 Play Core를 사용할 때 Play 스토어는 Google Play 서비스 약관에 따라 데이터를 처리하는 등 자체 프로세스를 실행합니다. 다음 정보는 Play Core 라이브러리가 앱의 특정 요청을 처리하기 위해 데이터를 처리하는 방법을 설명합니다.
인앱 리뷰
사용 시 수집되는 데이터
사용자 입력 데이터(평점 및 자유 텍스트 리뷰)
데이터 수집 목적
수집된 데이터는 Play 스토어에 리뷰를 남기는 데 사용됩니다.
데이터 암호화
데이터가 암호화됩니다.
데이터 공유
수집된 데이터는 Play 스토어의 공개 리뷰에 사용되거나 앱 개발자와 비공개로 공유됩니다(앱이 비공개 테스트 트랙에 있는 경우).
데이터 삭제
사용자는 자신의 Google Play 스토어 계정 또는 Google 계정의 리뷰를 삭제할 수 있습니다.
Google은 최대한 투명하게 공개하는 것을 목표로 하지만, 앱의 사용자 데이터 수집, 공유 및 보안 관행과 관련하여 Google Play의 데이터 보안 섹션 양식에 응답하는 방법을 결정할 책임은 전적으로 개발자에게 있습니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-08-08(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-08(UTC)"],[],[],null,["# Google Play In-App Reviews API\n\nThe Google Play In-App Review API lets you prompt users to submit Play Store\nratings and reviews without the inconvenience of leaving your app or game.\n\nGenerally, the in-app review flow (see figure 1) can be triggered at any time\nthroughout the user journey of your app. During the flow, the user has the\nability to rate your app using the 1 to 5 star system and to add an optional\ncomment. Once submitted, the review is sent to the Play Store and eventually\ndisplayed.\n| **Note:** To protect user privacy and avoid API misuse, there are strict guidelines that your app should follow about [when to request in-app reviews](#when-to-request) and the [design of the review prompt](#design-guidelines).\n\n\n**Figure 1.** In-app review flow for a user\n\n\u003cbr /\u003e\n\nDevice requirements\n-------------------\n\nIn-app reviews only work on the following devices:\n\n- Android devices (phones, tablets, and TVs with Google TV) running Android 5.0 (API level 21) or higher that have the Google Play Store installed.\n- ChromeOS devices that have the Google Play Store installed.\n\nPlay Core library requirements\n------------------------------\n\nTo integrate in-app reviews in your app, your app must use version 1.8.0 or\nhigher of the [Play Core library](/guide/playcore).\n\nWhen to request an in-app review\n--------------------------------\n\nFollow these guidelines to help you decide when to request in-app reviews from\nusers:\n\n- Trigger the in-app review flow after a user has experienced enough of your app or game to provide useful feedback.\n- Don't prompt the user excessively for a review. This approach helps minimize user frustration and limit API usage (see the [section on quotas](#quotas)).\n- Your app shouldn't ask the user any questions before or while presenting the rating button or card, including questions about their opinion (such as \"Do you like the app?\") or predictive questions (such as \"Would you rate this app 5 stars\").\n\nDesign guidelines\n-----------------\n\nFollow these guidelines as you determine how to integrate in-app reviews in your\napp:\n\n- Surface the card as-is, without tampering or modifying the existing design in any way, including size, opacity, shape, or other properties.\n- Don't add any overlay on top of the card or around the card.\n- The card and the card's background should be on the topmost layer. Once the card has surfaced, don't programmatically remove the card. The card is removed automatically based on either the user's explicit action, or an internal Play Store mechanism.\n\nQuotas\n------\n\nTo provide a great user experience, Google Play enforces a time-bound quota on\nhow often a user can be shown the review dialog. Because of this quota, calling\nthe `launchReviewFlow` method more than once during a short period of time (for\nexample, less than a month) might not always display a dialog.\n| **Note:** The specific value of the quota is an implementation detail, and it can be changed by Google Play without any notice.\n\nBecause the quota is subject to change, it's important to apply your own logic\nand target the best possible moment to request a review. For example, **you\nshould not have a call-to-action option (such as a button) to trigger the API**,\nas a user might have already hit their quota and the flow won't be shown,\npresenting a broken experience to the user. For this use case, redirect the user\nto the Play Store instead.\n\nIntegrate in-app reviews in your app\n------------------------------------\n\nLearn how to integrate in-app reviews in your app, depending on your development\nenvironment:\n\n- [Kotlin or Java](/guide/playcore/in-app-review/kotlin-java)\n- [Native (C++)](/guide/playcore/in-app-review/native)\n- [Unity](/guide/playcore/in-app-review/unity)\n- [Unreal Engine](/guide/playcore/in-app-review/unreal-engine)\n\nTerms of service and data safety\n--------------------------------\n\nBy accessing or using the Play In-App Reviews Library, you agree to the [Play\nCore Software Development Kit Terms of Service](/guide/playcore#license). Read and understand all\napplicable terms and policies before accessing the library.\n\nData Safety\n-----------\n\nThe Play Core libraries are your app's runtime interface with the Google Play\nStore. As such, when you use Play Core in your app, the Play Store runs its own\nprocesses, which include handling data as governed by the [Google Play Terms of\nService](https://play.google.com/about/play-terms/index.html). The following information describes how the Play Core\nlibraries handle data to process specific requests from your app.\n\n### In-app Reviews\n\n|----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Data collected on usage | User-entered data (rating and free-text review) |\n| Purpose of data collection | The data collected is used to leave a review on the Play Store. |\n| Data encryption | Data is encrypted. |\n| Data sharing | The data collected is used in a public review on the Play Store or, if the app is in a closed test track, the data collected is shared privately with the app developer. |\n| Data deletion | Users can delete their reviews in their Google Play Store account or Google Account. |\n\nWhile we aim to be as transparent as possible, you are solely responsible for\ndeciding how to respond to Google Play's data safety section form regarding your\napp's user data collection, sharing, and security practices."]]
