PromptSurge

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ステップ

同じユーザー、同じタイミング。違いは、まずアプリについての言葉でお願いすることです。

  1. 旅行を保存しました

    オフラインで利用できます

    requestReview()

    ステップ1

    タイミングはあなたのコードが決める

    旅行の保存やレベルクリアなど、うまくいった直後に requestReview() を呼び出します。

  2. ひとつお願いがあります

    オフライン地図には力を入れました。短いレビューが、ほかの旅行者がこのアプリを見つける助けになります。

    今はしないはい

    ステップ2

    プリプロンプトがあなたの言葉でお願いする

    アプリでできることに触れる短いメッセージです。「今はしない」で閉じ、それ以外は何も起こりません。

  3. このアプリを評価

    星をタップして評価

    機能に触れたレビュー

    オフライン地図のおかげで旅行が助かりました。電波がなくても使えます。

    ステップ3

    ストア標準の評価シート

    「はい」でストアのシートがそのまま開きます。直前に読んだメッセージが、具体的に書くきっかけになります。

何のための仕組みか

  1. 同じユーザーからより多くのレビュー

    あなたが選んだタイミングで、答える理由と一緒にお願いします。

  2. 文章付きのレビューが増える

    機能についてのメッセージは、星だけでなく言葉を引き出します。

  3. あなたのキーワードがユーザーの言葉に

    アプリでできることに触れたレビューは、次に訪れる人に誰向けのアプリかを伝えます。

  4. ストアが読み取るシグナル

    Apple と Google はどちらも、評価とレビューが検索でのアプリの順位に関わると述べています。

ダッシュボードで、あなたのアプリに起きた変化を確認できます。1日あたりの文章付きレビュー数、星の数、キーワードへの言及を、プリプロンプト導入前と導入後で比べます。

出典: Apple:App Store の検索 · Google Play:アプリの発見とランキング

仕組み

  1. SDKを追加

    iOS、Android、Unityのパッケージをインストールし、起動時に一度だけinitialize()を呼び出します。その後、レベルクリア、プロジェクトの保存、注文の完了など、選んだタイミングでrequestReview()を呼び出します。

  2. プレプロンプトを自分仕様に

    ダッシュボードで、タイトル、メッセージ、2つのボタンラベルを書くか、組み込みAIに自分のレビューから下書きさせます。テーマを選び、Startup以上ならヘッダー画像を追加して承認すると、文面は10言語に翻訳され、アプリのアップデートなしでデバイスに届きます。

  3. コントロールグループと比較

    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で各回答を説明しています。

Androidアプリには呼び出し2つ、残りはダッシュボードで

無料プラン、クレジットカード不要。アプリを作成し、APIキーをコピーして、リリースしましょう。

無料アカウントを作成する →

すでにアカウントをお持ちですか? ログイン