In-App Review Guide (Android)
2024.05.20 문서 작성
✅ Google In-App Review Flow
공식 가이드 문서에 의한 기능 흐름 순서도
- 사용자 의견 요청 API 호출 ( 성공 or 실패 )
- 사용자 의견 요청 팝업 표시
- 평가 및 리뷰 작성
- 완료
💭 회사에서 개발중인 앱에 사용 가능한가?
Google 공식 문서에 따른 In-App Review 개발 요구사항 스펙
인앱 리뷰는 다음 기기에서만 작동합니다.
- Google Play 스토어가 설치되었으며 Android 5.0(API 수준 21) 이상을 실행하는 Android 기기(스마트폰 및 태블릿)
- Google Play 스토어가 설치된 ChromeOS 기기
디자인 가이드라인
앱에 인앱 리뷰를 통합하는 방법을 결정할 때 다음 가이드라인
- 크기, 불투명도, 모양 또는 기타 속성을 비롯하여 기존 디자인을 어떠한 방식으로든 변조하거나 수정하지 않고 카드를 있는 그대로 표시합니다.
- 카드 상단 또는 카드 주변에 오버레이를 추가해서는 안 됩니다.
- 카드와 카드의 배경은 최상위 레이어에 있어야 합니다. 카드가 표시되면 프로그래매틱 방식으로 카드를 삭제해서는 안 됩니다. 카드는 사용자의 명시적 작업 또는 내부 Play 스토어 메커니즘에 따라 자동으로 삭제됩니다.
🕒 테스트는 어떻게 진행해야 하는가?
- 구글 플레이 콘솔에 내부 테스트로 테스트 앱을 업로드 합니다.
- 구글 플레이 콘솔에 내부 테스트 모드에 테스터 할 계정을 등록합니다.
- 테스트 진행
이슈 사항 및 버그
- In App Review API 를 요청하면 구글 플레이에서 다운로드된 앱인지, 사용자가 이미 서비스를 평가 완료 했는지, 이미 리뷰 팝업을 제공했는지를 확인 후 사용자에게 평가 화면을 제공합니다. 자주 호출할 경우 표시되지 않습니다.
- 개발이나 검증용 환경에 따라 패키지를 다르게 운영하는 경우 제약사항이 있고, 구글 플레이스토어를 통해 다운로드가 되어야만 정상 동작 확인이 가능하므로 개발 진행간 확인을 위하여 구글플레이의 내부 앱 공유 기능을 활용해야 합니다.
- 빌드(충전 선을 연결하여 로컬에서 빌드)로 테스트를 진행 할 경우 리뷰 UI는 나타나지 않으며, 단순한 완료 여부만 확인 할 수 있습니다.
- 빌드(충전 선을 연결하여 로컬에서 빌드) 를 진행할 경우 기능 동작이 원활하지 않을 수 있으며 fakeReviewManager 즉, Fake 객체를 만들어 완료 여부를 통하여 개발 진행
- 짧은기간 안에 여러번 기능(API) 를 호출 할 경우 정상적인 기능을 이용 할 수 없습니다.
👉🏻 Google 에서 제공하는 기간은 따로 명시되어있지 않습니다.짧은 기간에 대한 명확한 기준은 무엇인가?
Android의 In-App Review API를 사용 시, Google Play에서는 리뷰 요청을 짧은 기간 내에 여러 번 호출하는 것을 제한하고 있습니다. 구체적인 제한 기간은 Google Play 정책에 명확하게 명시되어 있지 않지만, 일반적으로 다음과 같은 사항을 고려해야 합니다:
- Google의 가이드라인 준수: 리뷰 요청을 너무 자주 하면 사용자의 경험을 해칠 수 있습니다. Google은 "적절한 시점"에 리뷰 요청을 하라고 권장합니다. 예를 들어, 사용자가 앱을 몇 번 사용한 후, 또는 앱에서 의미 있는 작업을 완료한 후에 요청하는 것이 좋습니다.
- API의 내부 제한: In-App Review API는 내부적으로 호출 빈도를 제한하고 있으며, 이는 앱의 버전, 사용자의 국가, 최근 리뷰 요청 여부 등에 따라 달라질 수 있습니다. Google은 내부적으로 특정 기간 동안 여러 번의 리뷰 요청을 허용하지 않으며, 이는 몇 주에서 몇 달까지 다양할 수 있습니다.
- 권장 사항: 일반적으로 리뷰 요청은 한 사용자 당 한 달에 한 번 정도가 적당하다고 여겨집니다. 너무 자주 리뷰 요청을 보내면 사용자가 불편을 느끼고 부정적인 리뷰를 남길 가능성이 높아집니다.
정확한 제한 기간을 확인하려면 Google Play Console의 정책 문서와 API 문서를 참고하는 것이 좋습니다. 또한, 사용자 피드백을 모니터링하고, 리뷰 요청이 사용자의 경험을 저해하지 않도록 주의해야 합니다.
🤔 그래서 ChatGPT 한테 물어봤습니다.
Q : 공식 문서에는 호출 빈도수와 기간 등 명확하게 명시된게 없는데 공식적으로 권고하는 기간이 있을까?
A:
구글은 In-App Review API의 호출 빈도에 대한 구체적인 기간을 공식 문서에서 공개하지 않았습니다. 대신, 구글은 리뷰 요청을 너무 자주 하지 않도록 주의하라는 일반적인 권장 사항을 제공하고 있습니다.
구글의 In-App Review API 문서에 따르면:
- 적절한 시점 선택: 구글은 사용자가 앱을 긍정적으로 평가할 가능성이 높은 시점에 리뷰 요청을 보내라고 권장합니다. 예를 들어, 사용자가 특정 기능을 성공적으로 사용했거나 앱에서 의미 있는 성과를 달성했을 때가 적절한 시점입니다.
- 빈도 제한: 구글은 내부적으로 리뷰 요청 빈도를 제한하는 메커니즘을 가지고 있습니다. 이는 개발자가 과도하게 리뷰 요청을 보내지 않도록 하기 위함입니다. 하지만, 이 제한이 어떻게 적용되는지에 대한 구체적인 기간(예: 한 달에 한 번)은 명시되어 있지 않습니다.
- 사용자 경험 고려: 개발자는 사용자 경험을 고려하여 리뷰 요청을 보내야 합니다. 리뷰 요청이 사용자에게 불편을 주지 않도록 주의해야 합니다.
결론적으로, 구글은 리뷰 요청 빈도에 대한 구체적인 기간을 공개하지 않지만, 사용자 경험을 해치지 않도록 적절한 시점에 리뷰 요청을 보내도록 권장하고 있습니다. 한 달에 한 번 정도의 빈도를 유지하는 것이 일반적으로 좋은 기준이 될 수 있습니다.
개발자는 구글의 권장 사항을 따르면서, 사용자 피드백과 앱 사용 패턴을 분석하여 최적의 리뷰 요청 시점을 결정하는 것이 좋습니다.
결론
- 즉, 통상적으로 한달에 한번 정도 사용 주기를 권장하고, 기간을 러프 하게 두는것이 가이드라인 규칙을 벗어나지 않는다는 점
- 너무 잦은 호출을 해서도 안되며, 사용자 경험을 방해하는 의도성이 판단되는 경우 해당 기능을 강제로 사용하지 못하게 조치를 취하고 있다.
- 기능과 디자인 가이드라인 규칙을 벗어날 경우 Google Play에서 예고 없이 변경 및 삭제 될 수 있습니다.
- Etc
- Google Android 공식 가이드 문서
- 기능 오류 케이스 기술 블로그
Google Play In-App Review API | Android 개발자 | Android Developers
[android studio] 인앱리뷰(In-App Review) 구현 및 실행 오류
Google Play In-App Review 를 활용하여 적극적으로 사용자 의견 요청하기
💡 **PIECE Android Dev. 회고**
물론 Google Play In-App Review를 활용한 원티드 팀 블로그를 보면 해당 앱 처럼 사용자 경험에 최대한 방해가 되지 않게, API 상 정해져있는 quotas와 별개로 불필요하게 표시되는 것을 방지하기 위해 한번 평가 요청 API를 호출한 뒤에는 일정기간을 두던가, 다시 표시하지 않는 등의 옵션을 앱 내부 DB 를 활용하고 사용자가 만족할 만한 경험을 했을 경우에 대한 시나리오가 명확하면 활용하는 것이 결과적으로 지표 상승에 도움이 되겠지만 현재 피스 App 의 경우아직 유저가 어떤 행동을 취할 때 만족할만한 경험을 얻을 지에 대한 데이터가 부족하기에 과연 사용자의 올바른 평가와 피드백을 받을지 다소 의문이 남습니다.
