Android SDKで購入を復元する

購入の復元は、サブスクリプションやアプリ内課金などの購入済みコンテンツに、再度課金されることなくアクセスを取り戻せる機能です。アプリをアンインストールして再インストールしたユーザーや、新しいデバイスに乗り換えたユーザーが、以前の購入コンテンツに再び支払いなしでアクセスしたい場合に特に役立ちます。

Note

ペイウォールビルダーで作成したペイウォールでは、追加のコードなしで購入が自動的に復元されます。その場合は、このステップをスキップできます。

ペイウォールビルダーを使ってペイウォールをカスタマイズしていない場合に購入を復元するには、.restorePurchases() メソッドを呼び出してください。

Adapty.restorePurchases { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val profile = result.value
                      
            if (profile.accessLevels["YOUR_ACCESS_LEVEL"]?.isActive == true) {
            // successful access restore
            }
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // handle the error
        }
    }
}

Adapty.restorePurchases(result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyProfile profile = ((AdaptyResult.Success<AdaptyProfile>) result).getValue();
        
        if (profile != null) {
            AdaptyProfile.AccessLevel premium = profile.getAccessLevels().get("YOUR_ACCESS_LEVEL");
            
            if (premium != null && premium.isActive()) {
                // successful access restore
            }
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // handle the error
    }
});

レスポンスパラメーター:

パラメーター説明

パラメーター	説明
Profile	`AdaptyProfile` オブジェクト。このモデルには、アクセスレベル、サブスクリプション、および非サブスクリプション購入に関する情報が含まれています。ユーザーがアプリにアクセスできるかどうかを確認するには、アクセスレベルのステータスを確認してください。

Profile

AdaptyProfile オブジェクト。このモデルには、アクセスレベル、サブスクリプション、および非サブスクリプション購入に関する情報が含まれています。

ユーザーがアプリにアクセスできるかどうかを確認するには、アクセスレベルのステータス を確認してください。

Info

Adapty Android SDK 4.0.2 以降では、復元するものが何もない場合でも restorePurchases() は正常に完了します。現在のプロファイルを返すので、その中のアクセスレベルのステータスを確認してください。それ以前の SDK バージョンでは、この場合にメソッドが NO_PURCHASES_TO_RESTORE エラーで失敗します。

復元できる内容

restorePurchases は、Google Play からアクティブなサブスクリプションと未消費の買い切り購入を復元します。

Google Play Billing Library 8 を使用する Adapty Android SDK 4.0.2 以降では、Play Store は期限切れのサブスクリプションや消費済みの買い切り購入を返さなくなりました。デバイスの切り替えや再インストール後にユーザーがそれらを復元できるようにするには、Adapty.identify でユーザーを識別してください。これにより、Adapty はストアではなく自社のバックエンドから購入履歴を復元します。

Note

Google Play は現在所有している購入のみを報告するため、Adapty を統合する前に期限切れになったサブスクリプションは restorePurchases() では見つけられません。それらを Adapty に追加するには、過去のデータをインポートしてください。

Adapty SDK がモバイルアプリにどのように統合されているか、実際の例を見てみませんか？ペイウォールの表示、購入処理、その他の基本機能を含む完全なセットアップを実演しているサンプルアプリをご覧ください。