PromptSurge

Unity SDK

C# 호출 한 번으로 iOS와 Android에 띄우는 Unity 리뷰 요청 프롬프트

Unity용 PromptSurge는 게임 안에 브랜드에 맞춘 짧은 사전 프롬프트를 보여준 뒤 네이티브 리뷰 시트를 여는 UPM 패키지입니다. iOS에서는 StoreKit, Android에서는 Google Play In-App Review를 사용합니다. 레벨이 끝난 뒤 RequestReview()를 호출하세요. 문구, 테마, 헤더 이미지, 언어는 서버에서 제공됩니다.

무료 플랜 · Unity 2022.3 LTS+ · iOS, Android

1 · 나만의 사전 프롬프트

나만의 헤더 이미지

작은 부탁이 있습니다

오프라인 동기화에 공을 많이 들였습니다. 짧은 리뷰가 다른 사람들이 이 앱을 발견하는 데 도움이 됩니다.

나중에리뷰 남기기

2 · 네이티브 평점 시트

App Store 또는 Google Play

Apple 또는 Google의 시트가 변경 없이 그대로 표시됩니다

'나중에'를 누르면 다이얼로그가 닫히고 그 외에는 아무것도 표시되지 않습니다.

Unity SDK가 해주는 일

두 스토어, 호출 하나

PromptSurge.RequestReview()는 작은 네이티브 shim을 통해 iOS에서는 SKStoreReviewController를, Android에서는 Play의 In-App Review를 엽니다. Play 의존성은 External Dependency Manager가 있으면 자동으로 해결되고, 없으면 Gradle 한 줄로 추가할 수 있습니다.

게임 UI에 맞게 설계

다이얼로그는 코드로 만든 UGUI 오버레이로, 색상과 헤더 이미지가 적용됩니다. 씬에 EventSystem이 없으면 직접 생성하고, 카드 바깥을 탭하거나 Android 뒤로 가기 버튼을 누르면 닫히며, 준비가 끝날 때까지 숨겨져 있으므로 이미지 로딩이 느려도 입력을 막지 않습니다.

에디터에서는 조용히

Play Mode에서는 모든 호출이 의도적으로 아무 작업도 하지 않습니다. 다이얼로그도, 네이티브 시트도, 과금되는 이벤트도 없고 PlayerPrefs에 아무것도 기록하지 않습니다. 확인하려면 기기로 빌드하세요.

IL2CPP 대응

패키지에 link.xml과 [Preserve] 속성이 포함되어 있으므로, 관리 코드 스트리핑을 Medium이나 High로 설정해도 SDK에 필요한 코드가 제거되지 않습니다.

모든 표시 조건 검사 내장

옵트아웃, 기기당 90일 쿨다운, 10% 대조군, 기기 50대 워밍업, 플랜의 월간 한도를 먼저 검사합니다. 워밍업, 대조군, 한도 소진 때문에 사전 프롬프트를 보류하더라도 네이티브 시트는 그대로 열리므로 그 순간을 놓치지 않습니다.

통합 방법

Window > Package Manager > + > Add package from git URL에서 문서에 있는 버전 고정 URL로 패키지를 추가하세요. 그런 다음 한 번 초기화하고 원하는 순간에 RequestReview()를 호출하세요.

GameManager.cs

using PromptSurgeSDK;

public class GameManager : MonoBehaviour {
    void Start() {
        PromptSurge.Initialize("ps_live_your_key_here");
        PromptSurge.Prefetch();   // warms the cache in the background
    }
}

LevelManager.cs

using PromptSurgeSDK;

public class LevelManager : MonoBehaviour {
    void OnLevelComplete() {
        PromptSurge.RequestReview();
    }
}

Android에서는 Play의 리뷰 라이브러리가 EDM4U를 통해 자동으로 추가됩니다. EDM4U가 없다면 mainTemplate.gradle에 implementation 'com.google.android.play:review:2.0.1'을 추가하세요. 통합하는 동안 PromptSurge.SetLogLevel(LogLevel.Info)를 켜면 판단마다 한 줄씩 출력됩니다.

통합 문서 보기 →

휴대폰 화면에서

사용자가 보게 되는 것, 3단계

같은 사용자, 같은 순간입니다. 차이는 먼저 앱에 대한 말로 부탁한다는 점입니다.

  1. 여행이 저장되었습니다

    오프라인에서 사용 가능

    requestReview()

    1단계

    순간은 당신의 코드가 정합니다

    여행 저장이나 레벨 완료처럼 무언가 잘된 직후에 requestReview()를 호출하세요.

  2. 작은 부탁이 있어요

    오프라인 지도에 공을 많이 들였습니다. 짧은 리뷰 하나가 다른 여행자들이 이 앱을 찾는 데 도움이 됩니다.

    나중에좋아요

    2단계

    프리프롬프트가 당신의 말로 부탁합니다

    앱이 무엇을 하는지 짚어 주는 짧은 메시지입니다. 나중에를 누르면 닫히고 그 밖의 일은 일어나지 않습니다.

  3. 이 앱 평가하기

    별을 눌러 평가하세요

    기능을 언급한 리뷰

    오프라인 지도 덕분에 여행을 망치지 않았어요. 신호가 없어도 됩니다.

    3단계

    스토어의 평가 창 그대로

    좋아요를 누르면 스토어의 창이 그대로 열립니다. 방금 읽은 메시지가 구체적으로 쓸 거리를 줍니다.

무엇을 위해 만들었나

  1. 같은 사용자에게서 더 많은 리뷰

    당신이 고른 순간에, 답할 이유와 함께 부탁합니다.

  2. 글로 쓴 리뷰가 늘어납니다

    기능에 대한 메시지는 별점만이 아니라 글을 이끌어 냅니다.

  3. 당신의 키워드가 사용자의 말로

    앱이 무엇을 하는지 언급한 리뷰는 다음 방문자에게 누구를 위한 앱인지 알려 줍니다.

  4. 스토어가 읽는 신호

    Apple과 Google 모두 평점과 리뷰가 검색에서 앱 순위에 반영된다고 밝히고 있습니다.

대시보드에서 당신의 앱에 생긴 변화를 볼 수 있습니다. 하루 작성 리뷰 수, 별점, 키워드 언급을 프리프롬프트 이전과 이후로 비교합니다.

출처: Apple: App Store 검색 · Google Play: 앱 검색 노출 및 순위

작동 방식

  1. SDK 추가

    iOS, Android 또는 Unity 패키지를 설치하고 앱 실행 시 initialize()를 한 번 호출하세요. 그런 다음 레벨 완료, 프로젝트 저장, 주문 완료처럼 원하는 순간에 requestReview()를 호출하세요.

  2. 나만의 사전 프롬프트 만들기

    대시보드에서 제목, 메시지, 두 개의 버튼 레이블을 작성하거나, 내장 AI가 기존 리뷰를 바탕으로 초안을 작성하게 하세요. 테마를 고르고, Startup 이상이라면 헤더 이미지를 추가한 뒤 수락하세요. 문구가 10개 언어로 번역되어 앱 업데이트 없이 기기에 전달됩니다.

  3. 대조군과 비교

    기기의 10%는 사전 프롬프트를 보지 않고 같은 순간에 네이티브 시트를 바로 받습니다. 대시보드는 두 그룹을 나란히 보여주고, 스토어 평점과 평점 수를 매일 기록합니다.

추정이 아니라 대조군과 비교해 측정합니다

모든 앱에는 대조군(홀드아웃 그룹)이 있습니다. 기기의 10%가 평생 대조군에 배정되어 사전 프롬프트를 보지 않습니다. 이 기기들이 선택한 순간에 도달하면, PromptSurge가 없을 때처럼 네이티브 시트가 바로 실행됩니다. 새 앱은 또한 네이티브 시트만 사용하는 기기 50대의 워밍업으로 시작하므로, 첫 사전 프롬프트가 표시되기 전에 기준선이 마련됩니다.

대시보드는 리뷰 요청 시점에 도달한 모든 기기를 대상으로 두 그룹을 비교합니다. 사전 프롬프트를 본 기기 수, 탭스루한 기기 수, 요청된 네이티브 시트 수입니다. 양쪽 모두 기기가 최소 50대가 될 때까지는 결론을 내리지 않습니다.

정직하게 밝혀 둘 한계가 하나 있습니다. Apple과 Google은 사용자가 평가했는지, 무엇을 썼는지 앱에 절대 알려주지 않습니다. 그래서 PromptSurge는 퍼널 옆에 스토어 평점과 평점 수를 하루에 한 번 기록하고 그 변화를 보여줍니다. 이는 스토어 전체 수치이며 특정 프롬프트의 성과로 귀속되지 않고, 대시보드에도 그렇게 표시됩니다.

10% 대조군

기기 단위로 평생 배정됩니다. 같은 순간에 네이티브 시트가 바로 실행됩니다.

기기 50대 워밍업

새 앱은 네이티브 시트만으로 시작하므로 기준선이 먼저 만들어집니다.

일별 스토어 스냅샷

스토어 링크가 있는 앱의 경우, 각 스토어의 평균 평점과 평점 수를 하루에 한 번 기록합니다.

자주 묻는 질문

지원하는 Unity 버전은 무엇인가요?

Unity 2022.3 LTS 이상입니다. 이전 LTS 버전에서도 동작할 수 있지만 컴파일을 확인하지 않았으며 지원하지 않습니다. Android 빌드는 Play 스토어 배포와 minSdkVersion 21이, iOS 빌드는 iOS 14가 필요합니다.

에디터에서 아무 일도 일어나지 않는 이유는 무엇인가요?

의도된 설계입니다. 테스트 중에 노출이 과금되거나 PlayerPrefs가 채워지지 않도록, 모든 진입점이 Play Mode에서는 아무 작업도 하지 않습니다. 기기로 빌드하세요. 새 앱이라면 기기 50대 워밍업도 감안해야 하며, 테스트하는 동안 대시보드에서 끌 수 있습니다.

QA가 다이얼로그를 여러 번 볼 수 있나요?

네. PromptSurge.SetRateLimitBypass(true)를 호출하면 해당 기기의 쿨다운이 꺼집니다. 이 설정은 PlayerPrefs에 저장되며 켜져 있는 동안 검사할 때마다 경고를 기록하므로, 출시하는 빌드에서는 절대 호출하지 마세요.

두 스토어 모두에서 사전 프롬프트가 허용되나요?

두 스토어 모두 평가 자체가 자체 시트에서 이루어지도록 요구하며, SDK는 그 시트만 엽니다. iOS에서는 StoreKit, Android에서는 Play In-App Review이며 둘 다 변경 없이 표시됩니다. Apple의 가이드라인 5.6.1은 커스텀 리뷰 프롬프트를 허용하지 않으며, Google은 앱이 카드 앞에서 사용자에게 어떤 질문도 하지 말 것을 요청합니다. 사전 프롬프트는 플레이어의 기분이나 몇 점을 줄지 절대 묻지 않으며, 평서문으로 된 제목은 아무것도 묻지 않습니다. 두 스토어 모두 한도 때문에 시트가 표시되지 않을 수 있으므로 버튼 탭으로 시트를 열지 말라고 권합니다. 현재 SDK 버전은 그 한도에 도달했을 가능성이 높으면 iOS와 Android 각각에서 사전 프롬프트를 건너뜁니다. 특정 게임을 각 스토어가 어떻게 심사할지는 해당 스토어가 결정합니다.

스토어가 말하는 내용과 App Review용 메모(영문 문서) →

비용은 얼마인가요?

Indie 플랜은 영구 무료입니다. 앱 1개, 월 500회 사전 프롬프트 노출을 신용카드 없이 사용할 수 있습니다. Startup은 앱당 월 €39(연간 결제 시 월 €31)이며 월 10,000회 노출과 맞춤 헤더 이미지가 포함됩니다. Growth는 앱당 월 €99, Unlimited는 앱당 월 €249입니다. 앱마다 별도의 플랜이 있으며, 플랜에 따라 조직에서 만들 수 있는 앱 수가 정해집니다. 프롬프트 노출 1회는 사전 프롬프트가 한 번 표시된 것을 뜻하며, 네이티브 리뷰 시트와 대조군 기기는 카운트되지 않습니다. 가격은 EUR 기준이며 부가세가 포함되어 있습니다.

레벨이 끝난 뒤 호출 하나, 나머지는 대시보드에서

무료 플랜, 신용카드 불필요. 게임을 만들고 API 키를 복사해 기기로 빌드하세요.

무료 계정 만들기 →

이미 계정이 있으신가요? 로그인