PromptSurge

iOS SDK

SKStoreReviewControllerとrequestReviewのためのiOSレビュー依頼SDK

iOS版PromptSurgeは、ブランドに合った短いプレプロンプトを表示し、ユーザーが確認するとStoreKit自身のレビューリクエストを呼び出すSwiftパッケージです。コードに書く呼び出しは2つだけ。文面、テーマ、ヘッダー画像、言語はサーバーから配信されます。

無料プラン · iOS 14以降 · Swift Package Manager

1 · あなたのプレプロンプト

独自のヘッダー画像

ひとつお願いがあります

オフライン同期にはとくに力を入れました。短いレビューが、ほかの方がこのアプリを見つける助けになります。

今はしないレビューを書く

2 · ネイティブの評価シート

App StoreまたはGoogle Play

AppleまたはGoogle自身のシートを、そのまま表示

「今はしない」はダイアログを閉じ、それ以外は何も表示しません。

iOS SDKができること

StoreKit自身のレビューシート

確認されると、SDKはウィンドウシーンを渡してStoreKitにレビューシートをリクエストします。現在のSDKバージョンでは、iOS 16以降でAppStore.requestReview(in:)を、それより前ではSKStoreReviewController.requestReview(in:)を呼び出します。シートを表示するかどうかはiOSが決め、表示は1台のデバイスにつき年最大3回です。SDK自体が星を描画したり、評価を収集したりすることはありません。

UIKitとSwiftUI

表示元となる任意のビューコントローラーを渡せます。SwiftUIからはルートビューコントローラーを渡してください。ダイアログはコードで構築されたUIKitのカードで、セーフエリアを尊重し、長い文面はスクロールします。

すべての表示条件チェックを内蔵

オプトアウト、デバイスごとの90日間のクールダウン、10%のコントロールグループ、50台のウォームアップ、プランの月間上限が、何かを表示する前にチェックされます。ウォームアップ、コントロールグループ、上限到達のためにプレプロンプトが表示されない場合も、ネイティブのリクエストは実行されるため、そのタイミングを逃しません。

ATTプロンプト不要、プライバシーマニフェスト同梱

使用する識別子は、identifierForVendorとバンドルIDをソルト付きでSHA-256ハッシュしたものだけです。IDFAは使用せず、App Tracking Transparencyのプロンプトも表示されません。PrivacyInfo.xcprivacyはパッケージに同梱されており、App Privacyの回答はREADMEに記載されています。

待たずに表示

起動時にprefetch()を呼び出すと文面がデバイスにキャッシュされるため、requestReview(in:)はネットワークの往復なしでダイアログを表示できます。

統合方法

Xcodeでパッケージを追加します(File > Add Package Dependenciesを開き、下のURLを貼り付けて、PromptSurgeプロダクトを選択)。一度だけ初期化し、選んだタイミングでrequestReview(in:)を呼び出します。Package.swiftを含む詳しい手順はドキュメントにあります。

パッケージURL

https://github.com/PromptSurge-SDK/sdk-ios

アプリのエントリーポイント(SwiftUI)

import SwiftUI
import PromptSurge

@main
struct YourApp: App {
    init() {
        PromptSurge.initialize(apiKey: "ps_live_your_key_here")
        PromptSurge.prefetch()   // warms the cache in the background
    }

    var body: some Scene {
        WindowGroup { ContentView() }
    }
}

選んだタイミングで(UIKit)

import PromptSurge

class CheckoutViewController: UIViewController {
    private func onPurchaseSuccess() {
        PromptSurge.requestReview(in: self)
    }
}

統合中は、PromptSurge.setLogLevel(.info)で判断ごとに1行のログが出力されます。新しいアプリを最初の50台のデバイスまでネイティブシートのみにするウォームアップの判断も含まれます。

統合ドキュメントを見る →

スマホの画面で

ユーザーに見えるもの、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回記録します。

よくある質問

対応しているiOSのバージョンは?

iOS 14以降です。Xcode 14以降でビルドし、Swift Package Managerでインストールします。

App Storeガイドライン5.6.1のもとで、プレプロンプトは認められていますか?

ガイドライン5.6.1には、レビューの依頼にはAppleのAPIを使用すること、そしてカスタムのレビュープロンプトはAppleが認めないことが記載されています。PromptSurge自体が評価を収集することはありません。星の評価もレビュー本文も、常にStoreKit経由でリクエストされるApple自身のシートで行われます。その前に表示されるダイアログは短い依頼であり、ユーザーの気持ちを尋ねることは決してありません。また、AppleのStoreKitドキュメントには、ボタンのタップなどのユーザー操作に応じてrequestReviewを呼び出さないよう記載されています。シートが表示されない場合があるためです。プレプロンプトでは、ユーザーが確認ボタンをタップすることでシートがリクエストされます。現在のSDKバージョンでは、あるデバイスでAppleのシートを365日間に3回リクエストすると(Apple自身の上限です)、そのデバイスではプレプロンプトを表示しなくなるため、「はい」が空振りに終わることが少なくなります。個々のアプリをAppleがどう審査するかはAppleが決めることなので、ご自身で書く文面はシンプルな平叙文にとどめ、App Review向けのメモでプレプロンプトについて説明することもご検討ください。文面に質問が含まれている場合は、ダッシュボードが警告します。

ストアの記載内容とApp Review向けメモ(英語のドキュメント)→

確認後、ネイティブシートは必ず表示されますか?

いいえ、iOSが決めます。StoreKitがリクエストを表示するのは1台のデバイスにつき365日間で最大3回で、すでに評価したユーザーには、1年が経過した後、新しいバージョンについてのみ表示されます。現在のSDKバージョンでは、SDKがあるデバイスでシートを365日間に3回リクエストすると、そのデバイスではプレプロンプトを表示しなくなります。シートが表示されたかどうか、ユーザーが評価したかどうかは、SDKにも他のどんなコードにもわかりません。

テストデバイスで何も表示されないのはなぜですか?

ほとんどの場合はウォームアップが原因です。新しいアプリは、50台の異なるデバイスがレビューのタイミングに到達するまで、ネイティブシートのみで動作します。テスト中はダッシュボードでそのアプリのウォームアップをオフにし、setLogLevel(.info)を有効にして各判断を確認してください。

App Privacyでは何を申告すればよいですか?

Identifiers > Device IDとUsage Data > Product Interactionを、いずれも分析目的、ユーザーの身元にリンクされず、トラッキングには使用しないものとして申告します。これはアプリのほかの部分が収集するデータに加えての申告です。READMEに一覧表があります。

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

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

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

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