메인 콘텐츠로 건너뛰기
OneSignal 인앱 메시지를 사용하여 앱을 떠나지 않고 App Store 또는 Google Play 리뷰를 요청하세요. 이 튜토리얼은 코드가 필요 없는 방법과 코드가 필요한 방법 모두를 다룹니다.
앱 평점 요청을 위한 Review Now 버튼이 포함된 인앱 메시지

​
설정

​
1. 메시지 만들기

Messages > In-App > New In-App으로 이동하거나 기존 App Store Rating 템플릿을 여세요. 리뷰 버튼에 Action ID를 추가하세요:
버튼 요소의 Custom Action ID 필드가 review로 설정된 OneSignal 인앱 메시지 편집기

​
2. 트리거 추가

트리거는 메시지가 표시되는 시기를 제어합니다. 코드가 필요 없는 방법 또는 코드 기반 방법을 사용할 수 있습니다. 코드 없는 방법: 리뷰를 받고 싶은 사용자를 대상으로 Audience를 설정하세요. 예를 들어 세션이 많고 앱을 오랫동안 사용한 사용자를 대상으로 할 수 있습니다. 코드 기반 방법: SDK의 addTrigger 메서드를 사용하여 사용자 동작에 따라 프로그래밍 방식으로 메시지를 표시하세요. 사용자가 중요한 작업을 수행하는 도중에는 프롬프트를 표시하지 마세요. 이 예시에서 In-App Trigger 키는 ask_for_review이고 값은 show입니다. 키와 값은 어떤 것이든 사용할 수 있지만 addTrigger에 전달하는 값과 일치해야 합니다: OneSignal.InAppMessages.addTrigger("ask_for_review", "show");
인앱 메시지 트리거가 ask_for_review equals show로 설정된 OneSignal 대시보드

​
3. 앱 스토어 평점 프롬프트 처리

코드가 필요 없는 방법 또는 코드 기반 방법으로 사용자에게 리뷰를 안내할 수 있습니다.
  1. 세그먼트를 업데이트하여 “Device Type is Android” 필터를 사용하세요.
  2. 인앱 메시지를 복제하고 복제된 메시지의 세그먼트를 업데이트하여 “Device Type is iOS” 필터를 사용하세요. 두 개의 별도 세그먼트를 가진 두 개의 인앱 메시지가 있어야 합니다.
  3. “Review Now” 버튼에 URL 클릭 작업을 추가하여 앱의 스토어 목록으로 연결하세요:
SDK의 InAppMessages.addClickListener 메서드를 사용하여 리뷰 버튼이 클릭된 시점을 감지하고(Action ID를 확인하여), 네이티브 iOS 또는 Android 리뷰 API를 호출하여 평점 모달을 표시하세요.
OneSignal.InAppMessages.addClickListener((event) async {
  if (event.result.actionId == 'review') {
    if (await inAppReview.isAvailable()) {
      inAppReview.requestReview();
    }
  }
});
이 예시는 in_app_review Flutter 패키지를 사용합니다. 플랫폼에 맞게 조정하세요 — iOS의 경우 RequestReviewAction, Android의 경우 Google Play 인앱 리뷰 API를 참고하세요.

​
4. 예약 및 활성화

Apple은 365일 기간 내에 최대 세 번까지 네이티브 리뷰 프롬프트를 표시합니다. Google Play는 시간 제한 할당량을 적용하지만 정확한 한도를 공개하지 않습니다. 짧은 기간(한 달 미만) 내에 API를 두 번 이상 호출하면 다이얼로그가 표시되지 않을 수 있습니다. 이 한도 내에 유지하려면 인앱 일정을 17주마다 한 번씩 표시되도록 설정하세요:
총 40회 표시 및 17주 간격이 설정된 OneSignal 인앱 메시지 예약 설정
긍정적인 리뷰를 늘리려면 훌륭한 경험을 한 사용자를 대상으로 하세요. 예를 들어 세션이 많거나 이전 인앱 메시지를 통해 긍정적인 피드백을 남긴 사용자를 대상으로 할 수 있습니다. 이러한 사용자에게 태그를 설정하고 리뷰 프롬프트의 대상으로 사용할 세그먼트를 만드세요.

​
FAQ

​
Apple의 네이티브 리뷰 프롬프트는 얼마나 자주 표시될 수 있나요?

Apple은 사용자당 365일 기간에 최대 세 번까지 RequestReviewAction 프롬프트를 표시합니다. 이는 시스템에서 강제 적용되므로 앱에서 횟수를 추적할 필요가 없습니다. App Store 리뷰 요청을 참고하세요.

​
Google의 네이티브 리뷰 프롬프트는 얼마나 자주 표시될 수 있나요?

Google Play는 할당량을 적용하지만 정확한 한도를 공개하지 않습니다. 짧은 기간(한 달 미만) 내에 launchReviewFlow를 두 번 이상 호출하면 다이얼로그가 표시되지 않을 수 있습니다. 할당량은 Google이 사전 통지 없이 변경할 수 있는 구현 세부 사항입니다. 인앱 리뷰 할당량을 참고하세요.

​
네이티브가 아닌 앱(Flutter, React Native, Expo)에서도 사용할 수 있나요?

네. 플랫폼별 플러그인을 사용하여 네이티브 리뷰 API를 호출하세요. 예를 들어 Flutter의 경우 in_app_review, Expo의 경우 StoreReview를 사용할 수 있습니다. OneSignal 인앱 메시지와 클릭 리스너는 프레임워크에 관계없이 동일하게 작동합니다.

인앱 클릭 액션

인앱 메시지 요소에 URL, 권한 프롬프트, 태그, 결과 및 커스텀 클릭 액션을 설정하세요.

태그

동작에 따라 사용자에게 태그를 지정하여 타겟 메시지를 위한 세그먼트를 구성하세요.