Android SDKでのアプリ内購入の復元

購入の復元は、ユーザーがサブスクリプションやアプリ内課金など、過去に購入したコンテンツへのアクセスを再度取得できる機能です。アプリをアンインストールして再インストールした場合や、新しいデバイスに移行した際に、再度料金を支払うことなく購入済みコンテンツにアクセスしたいユーザーに特に役立ちます。

Note

ペイウォールビルダーでスクリーンを作成した場合は、手動で購入を復元する必要はありません。復元コントロールを紐付けてください。新しいビルダーでは Restore purchases アクション、旧ビルダーでは復元リンクまたはボタンを使用します。これにより、SDKが復元を完了します。

スクリーンを自分で構築した場合は、.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 3.17.3 および 4.0.2 以降、restorePurchases() は復元するものがない場合でも正常に完了します。現在のプロファイルを返すので、その中のアクセスレベルのステータスを確認してください。それ以前のSDKバージョンでは、この場合にメソッドが NO_PURCHASES_TO_RESTORE エラーで失敗します。

復元できるもの

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

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

Note

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

Tip

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