Unity SDK
C#の呼び出し1つでiOSとAndroidに対応する、Unityレビュー依頼SDK
Unity版PromptSurgeは、ゲーム内にブランドに合った短いプレプロンプトを表示し、その後ネイティブのレビューシート(iOSではStoreKit、AndroidではGoogle PlayのIn-App Review)を開くUPMパッケージです。レベルクリア後にRequestReview()を呼び出すだけ。文面、テーマ、ヘッダー画像、言語はサーバーから配信されます。
無料プラン · Unity 2022.3 LTS以降 · iOS、Android
1 · あなたのプレプロンプト
ひとつお願いがあります
オフライン同期にはとくに力を入れました。短いレビューが、ほかの方がこのアプリを見つける助けになります。
2 · ネイティブの評価シート
App StoreまたはGoogle Play
AppleまたはGoogle自身のシートを、そのまま表示
Unity SDKができること
両ストアに呼び出し1つで
PromptSurge.RequestReview()は、小さなネイティブシムを介して、iOSではSKStoreReviewController、AndroidではPlayのIn-App Reviewを開きます。Playの依存関係はExternal Dependency Managerで自動的に解決されます。使わない場合も、Gradleに1行追加するだけです。
ゲームUI向けに設計
ダイアログはコードで構築されたUGUIオーバーレイで、あなたの色とヘッダー画像を使います。シーンにEventSystemがなければ作成し、カードの外側のタップやAndroidの戻るボタンで閉じます。準備が整うまで非表示のままなので、画像の読み込みが遅くても入力をブロックしません。
エディターでは何もしない
Play Modeでは、すべての呼び出しが意図的に何もしません(no-op)。ダイアログもネイティブシートも表示されず、課金対象のイベントも発生せず、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)で判断ごとに1行のログが出力されます。
ユーザーに見えるもの、3ステップ
同じユーザー、同じタイミング。違いは、まずアプリについての言葉でお願いすることです。
旅行を保存しました
オフラインで利用できます
requestReview()
ステップ1
タイミングはあなたのコードが決める
旅行の保存やレベルクリアなど、うまくいった直後に requestReview() を呼び出します。
ひとつお願いがあります
オフライン地図には力を入れました。短いレビューが、ほかの旅行者がこのアプリを見つける助けになります。
今はしないはいステップ2
プリプロンプトがあなたの言葉でお願いする
アプリでできることに触れる短いメッセージです。「今はしない」で閉じ、それ以外は何も起こりません。
このアプリを評価
星をタップして評価
機能に触れたレビュー
オフライン地図のおかげで旅行が助かりました。電波がなくても使えます。
ステップ3
ストア標準の評価シート
「はい」でストアのシートがそのまま開きます。直前に読んだメッセージが、具体的に書くきっかけになります。
何のための仕組みか
同じユーザーからより多くのレビュー
あなたが選んだタイミングで、答える理由と一緒にお願いします。
文章付きのレビューが増える
機能についてのメッセージは、星だけでなく言葉を引き出します。
あなたのキーワードがユーザーの言葉に
アプリでできることに触れたレビューは、次に訪れる人に誰向けのアプリかを伝えます。
ストアが読み取るシグナル
Apple と Google はどちらも、評価とレビューが検索でのアプリの順位に関わると述べています。
ダッシュボードで、あなたのアプリに起きた変化を確認できます。1日あたりの文章付きレビュー数、星の数、キーワードへの言及を、プリプロンプト導入前と導入後で比べます。
仕組み
SDKを追加
iOS、Android、Unityのパッケージをインストールし、起動時に一度だけinitialize()を呼び出します。その後、レベルクリア、プロジェクトの保存、注文の完了など、選んだタイミングでrequestReview()を呼び出します。
プレプロンプトを自分仕様に
ダッシュボードで、タイトル、メッセージ、2つのボタンラベルを書くか、組み込みAIに自分のレビューから下書きさせます。テーマを選び、Startup以上ならヘッダー画像を追加して承認すると、文面は10言語に翻訳され、アプリのアップデートなしでデバイスに届きます。
コントロールグループと比較
10%のデバイスはプレプロンプトを一切見ずに、同じタイミングでネイティブシートが直接表示されます。ダッシュボードは両グループを並べて表示し、ストアの評価と評価数を毎日記録します。
想定ではなく、コントロールグループとの比較で測定
すべてのアプリにコントロールグループ(ホールドアウト)があります。10%のデバイスがずっとこのグループに割り当てられ、プレプロンプトを見ることはありません。選んだタイミングに到達すると、PromptSurgeがない場合と同じように、ネイティブシートが直接表示されます。新しいアプリは、まずネイティブシートのみで50台のデバイスによるウォームアップから始まるため、最初のプレプロンプトが表示される前にベースラインができています。
ダッシュボードは、レビューのタイミングに到達したすべてのデバイスについて2つのグループを比較します。プレプロンプトを見た数、タップスルーした数、ネイティブシートがリクエストされた数です。各グループが少なくとも50台に達するまで、結論は表示されません。
正直に言うと、限界が1つあります。AppleもGoogleも、ユーザーが評価したかどうかや、何を書いたかをアプリに伝えることはありません。そのためPromptSurgeは、ファネルと並べて、ストアの評価と評価数を1日1回記録し、その変化を表示します。これはストア全体の合計であり、個々のプロンプトの成果として計上されるものではありません。ダッシュボードにもそう明記しています。
10%のコントロールグループ
デバイスごとに割り当て、ずっと固定。同じタイミングでネイティブシートが直接表示されます。
50台のウォームアップ
新しいアプリはネイティブシートのみで始まるため、ベースラインが先にできます。
ストアの毎日のスナップショット
ストアリンクを設定したアプリについて、各ストアの平均評価と評価数を1日1回記録します。
よくある質問
対応しているUnityのバージョンは?
Unity 2022.3 LTS以降です。それより古いLTSでも動作する可能性はありますが、コンパイルを確認しておらず、サポート対象外です。AndroidビルドにはPlayストアでの配信とminSdkVersion 21が、iOSビルドにはiOS 14が必要です。
エディターで何も起きないのはなぜですか?
仕様です。Play Modeではすべてのエントリーポイントが何もしないため、テストで表示回数が課金されたり、PlayerPrefsが埋まったりすることはありません。実機向けにビルドしてください。新しいアプリでは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は1アプリあたり月額€39(年間払いの場合は月額€31)で、月10,000回の表示とカスタムヘッダー画像が利用できます。Growthは1アプリあたり月額€99、Unlimitedは€249です。プランはアプリごとに設定され、そのプランによって組織で作成できるアプリの数が決まります。プロンプト表示1回とは、プレプロンプトが1回表示されることです。ネイティブのレビューシートとコントロールグループのデバイスはカウントされません。価格はEUR(税込)です。
関連ページ
無料で始める
Indieプランは永久無料です。アプリ1つ、プレプロンプト表示は月500回まで、クレジットカードは不要です。カスタムヘッダー画像はStartup(1アプリあたり月額€39)から利用できます。価格はEUR(税込)です。
レベルクリア後に呼び出し1つ、残りはダッシュボードで
無料プラン、クレジットカード不要。ゲームを作成し、APIキーをコピーして、実機向けにビルドしましょう。
無料アカウントを作成する →すでにアカウントをお持ちですか? ログイン