Android SDK
Google PlayのIn-App Review APIで実現する、Androidのアプリ内レビュー
Android版PromptSurgeは、ブランドに合った短いプレプロンプトを表示し、ユーザーが確認するとGoogle PlayのIn-App Reviewフローを起動するKotlinライブラリです。コードに書く呼び出しは2つだけ。文面、テーマ、ヘッダー画像、言語はサーバーから配信されます。
無料プラン · minSdk 24 · JitPack
1 · あなたのプレプロンプト
ひとつお願いがあります
オフライン同期にはとくに力を入れました。短いレビューが、ほかの方がこのアプリを見つける助けになります。
2 · ネイティブの評価シート
App StoreまたはGoogle Play
AppleまたはGoogle自身のシートを、そのまま表示
Android SDKができること
Play自身のレビューカード
確認されると、SDKはReviewManagerのrequestReviewFlow()とlaunchReviewFlow()を実行します。カードはGoogleのもので、そのまま表示されます。その時点でプレプロンプトはすでに閉じており、カードを表示するかどうかはPlay自身の割り当てによって決まります。
どのアプリテーマにもなじむ
ダイアログはMaterial 3です。Materialテーマではアプリの見た目を継承し、AppCompat、プラットフォーム、カスタムのゲームテーマでは、クラッシュする代わりに同梱の独自テーマにフォールバックします。ダッシュボードで設定した色はその上に適用されます。
本番アプリでも安全
minSdk 24、ランタイムパーミッション不要、マニフェストへの追加なし、R8ルールはAARに同梱。アクティビティが終了処理中の場合、状態がすでに保存されている場合、またはダイアログがすでに表示されている場合、requestReview()は何もしません。
すべての表示条件チェックを内蔵
オプトアウト、デバイスごとの90日間のクールダウン、10%のコントロールグループ、50台のウォームアップ、プランの月間上限を最初にチェックします。ウォームアップ、コントロールグループ、上限到達のためにプレプロンプトが表示されない場合も、Playのレビューフローは起動されるため、そのタイミングを逃しません。
Data Safetyの回答も用意
使用する識別子はANDROID_IDとパッケージ名のSHA-256だけで、生のIDは使用せず、広告IDも使用しません。PlayのData Safetyフォームで何を申告すべきかは、READMEに正確に記載されています。
統合方法
JitPackとGradleの依存関係を1つ追加し(依存関係の指定と最新バージョンはドキュメントに記載)、Applicationで初期化してから、選んだタイミングでrequestReview()を呼び出します。
Application.onCreate()
import com.promptsurge.sdk.PromptSurge
class MyApp : Application() {
override fun onCreate() {
super.onCreate()
PromptSurge.initialize(this, "ps_live_your_key_here")
}
}選んだタイミングで
// In an Activity (AppCompatActivity works)
PromptSurge.requestReview(this)
// Or from a Fragment
PromptSurge.requestReview(requireActivity())統合中は、PromptSurge.setLogLevel(PromptSurge.LogLevel.INFO)で判断ごとに1行のログが出力されます。Playのカードは割り当てによって制限されており、デバッグビルドでは何も表示されないことがよくあるため、そこでカードが表示されなくても正常です。
ユーザーに見えるもの、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回記録します。
よくある質問
対応しているAndroidのバージョンは?
minSdk 24(Android 7.0)以降、Kotlin 1.9以降で、JitPackで配布しています。ダイアログにはandroidx.fragmentが必要ですが、appcompatがすでに取り込んでいます。
プレプロンプトは、Google Playのアプリ内レビューのガイドラインとどう関係しますか?
Googleはアプリに対し、レビューカードを変更せずにそのまま表示し、その上に何も重ねないこと、そしてカードの表示前や表示中にユーザーに質問をしないことを求めています。例として、意見を尋ねる質問(「このアプリは気に入りましたか?」)や予測を尋ねる質問(「このアプリを星5つで評価しますか?」)が挙げられています。PromptSurgeがPlayのカードを変更したり、その上に何かを重ねたりすることはありません。PromptSurgeのダイアログはカードが開く前に閉じており、デフォルトの文面もAIが生成する文面も、レビューをお願いする平叙文で、質問ではありません。また、Googleのガイドでは、割り当て(クォータ)によってカードが表示されない場合があるため、レビューフローを起動するCTAボタンをアプリに設けるべきではないとしています。プレプロンプトの確認ボタンはまさにそのようなボタンなので、この指針をご自身のアプリに照らして検討してください。現在のSDKバージョンでは、Playのカードを最後にリクエストしてから30日以内のデバイスにはプレプロンプトを表示しません。これでリスクは下がりますが、Googleが割り当てを公開していないため、なくすことはできません。ご自身で文面を書く場合は、このページの例のようにタイトルを平叙文にしてください。質問が含まれている場合は、ダッシュボードが警告します。
ストアの記載内容とApp Review向けメモ(英語のドキュメント)→「今はしない」でPlayの割り当てを消費しますか?
いいえ。「今はしない」ではレビューフローを一切起動しません。In-App Review APIを呼び出すのは、確認されたときと、ウォームアップ、コントロールグループ、プランの上限到達によるネイティブのみの経路だけです。
テストデバイスで何も表示されないのはなぜですか?
通常はウォームアップが原因です。新しいアプリは、50台の異なるデバイスがレビューのタイミングに到達するまで、Playのカードのみで動作します。テスト中はダッシュボードでそのアプリのウォームアップをオフにしてください。Play自身のカードも割り当てによって制限されており、デバッグビルドでは表示されないことがよくあります。
Data Safetyでは何を申告すればよいですか?
Device or other IDsと、App activity > App interactionsを、収集あり・共有なし、分析目的、ユーザーにリンクされないものとして申告します。これはアプリのほかの部分が収集するデータに加えての申告です。READMEで各回答を説明しています。
関連ページ
無料で始める
Indieプランは永久無料です。アプリ1つ、プレプロンプト表示は月500回まで、クレジットカードは不要です。カスタムヘッダー画像はStartup(1アプリあたり月額€39)から利用できます。価格はEUR(税込)です。
Androidアプリには呼び出し2つ、残りはダッシュボードで
無料プラン、クレジットカード不要。アプリを作成し、APIキーをコピーして、リリースしましょう。
無料アカウントを作成する →すでにアカウントをお持ちですか? ログイン