Android SDKのエラーを処理する

SDKから返されるエラーはすべて AdaptyError です。

デバッグ前に詳細ログを有効にしてください。 ほとんどの AdaptyError は、Play Billing、ネットワーク、またはバックエンドのエラーをラップしています。詳細ログを有効にすると（Adapty.logLevel = AdaptyLogLevel.VERBOSE — ログ記録を参照）、ラップされたエラーがコンソールに出力され、実際の原因がわかることがほとんどです。

これらの解決策で問題が解決しない場合は、サポートに問い合わせる前にその他の問題を参照して、より効率的にサポートできるよう手順をご確認ください。

エラー	解決策
UNKNOWN	不明または予期しないエラーが発生したことを示します。
ITEM_UNAVAILABLE	このエラーは主にテスト段階で発生します。プロダクトが本番環境に存在しないか、ユーザーが Google Play のテスターグループに属していない可能性があります。
ADAPTY_NOT_INITIALIZED	Adapty SDK が有効化されていません。スプラッシュスクリーンや初期の UI フックが `Adapty.activate` の完了前に Adapty のメソッドを呼び出している場合によく見られます。実機ではエミュレーターと実行タイミングが異なるため、再現しないこともあります。`Adapty.activate` が完了してから、他の SDK 呼び出しを行うようにしてください。完全な手順については Android SDK の呼び出し順序を参照してください。また、`Adapty.activate` メソッドを使用して Adapty SDK を正しく設定する必要があります。
PROFILE_WAS_CHANGED	操作中にユーザープロファイルが変更されました。 `Adapty.identify` の実行中に別のメソッドを呼び出すと発生します。実行中の呼び出しが切り替え直前のプロファイルに対して行われ、SDK によって拒否されます。`Adapty.identify` の完了後に他の SDK 呼び出しを行うようにしてください。Android SDK の呼び出し順序を参照してください。
PRODUCT_NOT_FOUND	購入しようとしたプロダクトがストアで利用できないことを示します。
INVALID_JSON	ローカルのフォールバックペイウォール JSON が無効です。デフォルトの英語のペイウォールを修正してから、無効なローカルペイウォールを置き換えてください。ペイウォールの修正方法についてはリモートコンフィグでペイウォールをカスタマイズするを、ローカルペイウォールの置き換え方法についてはローカルフォールバックペイウォールを定義するを参照してください。
CURRENT_SUBSCRIPTION_TO_UPDATE _NOT_FOUND_IN_HISTORY	置き換え対象の元のサブスクリプションが有効なサブスクリプションの中に見つかりません。
BILLING_SERVICE_TIMEOUT	Google Play が応答する前にリクエストが最大タイムアウトに達したことを示します。Play Billing Library の呼び出しで要求されたアクションの実行が遅延した場合などに発生します。
FEATURE_NOT_SUPPORTED	要求された機能が現在のデバイスの Play Store でサポートされていません。
BILLING_SERVICE_DISCONNECTED	クライアントアプリと `BillingClient` 経由の Google Play Store サービスとの接続が切断されたことを示します。
BILLING_SERVICE_UNAVAILABLE	Google Play Billing サービスが現在利用できないことを示します。ほとんどの場合、クライアントデバイスと Google Play Billing サービスの間のどこかでネットワーク接続の問題が発生しています。
BILLING_UNAVAILABLE	購入プロセス中に請求に関する問題が発生したことを示します。考えられる原因は以下のとおりです： 1. ユーザーのデバイスに Play Store アプリがインストールされていないか、古いバージョンです。 2. ユーザーがサポートされていない国にいます。 3. ユーザーが、管理者によって購入が無効化されているエンタープライズアカウントに属しています。 4. Google Play がユーザーの支払い方法に請求できませんでした（例：クレジットカードの有効期限切れ）。 5. ユーザーが Play Store アプリにログインしていません。
DEVELOPER_ERROR	API の使い方が正しくないことを示します。
BILLING_ERROR	Google Play 自体の内部的な問題を示します。
ITEM_ALREADY_OWNED	そのプロダクトはすでに購入済みです。
ITEM_NOT_OWNED	ユーザーがそのアイテムを所有していないため、要求されたアクションが失敗したことを示します。
BILLING_NETWORK_ERROR	デバイスと Play のシステム間のネットワーク接続に問題があったことを示します。
NO_PRODUCT_IDS_FOUND	ペイウォール内のプロダクトがいずれもストアで利用できないことを示します。このエラーが発生した場合は、以下の手順で解決してください：すべてのプロダクトが Adapty ダッシュボードに追加されているか確認してください。アプリの Package name が Google Play Console のものと一致していることを確認してください。アプリストアのプロダクト ID がダッシュボードに追加したものと一致していることを確認してください。ストアにすでに Bundle ID が含まれている場合を除き、ID に Bundle ID を含めないようにしてください。 Google の税設定でアプリの有料ステータスが Active になっていることを確認してください。税情報が最新であり、証明書が有効であることも確認してください。収益化の対象となるよう、アプリに銀行口座が紐付けられているか確認してください。プロダクトがお住まいの地域で利用可能か確認してください。アプリがいずれかのテストトラックに登録されていることを確認してください。Internal testing トラックはレビュー不要でアプリが顧客に公開されないため、最も手軽な選択肢です。
NO_PURCHASES_TO_RESTORE	Google Play が復元する購入を見つけられなかったことを示します。
AUTHENTICATION_ERROR	`Adapty.activate` メソッドを使用して Adapty SDK を正しく設定する必要があります。
BAD_REQUEST	リクエストが不正です。 Google Play との連携に必要なすべての手順を完了していることを確認してください。
SERVER_ERROR	サーバーエラーです。
REQUEST_FAILED	正確に特定できないネットワークの問題を示します。
DECODING_FAILED	レスポンスのデコードに失敗しました。コードを確認し、送信しているパラメータが有効であることを確認してください。例えば、無効な API キーを使用している場合にもこのエラーが発生することがあります。
ANALYTICS_DISABLED	無効化されているため、アナリティクスイベントを処理できません。
WRONG_PARAMETER	パラメータの一部が正しくないことを示します。空白にできない箇所が空白になっている、型が間違っているなどが原因として考えられます。

その他の問題

まだ解決策が見つかっていない場合は、次のステップを試してみてください。

SDKを最新バージョンにアップグレードする: 最新のSDKバージョンは安定性が高く、既知の問題の修正が含まれているため、常にアップグレードをおすすめします。
サポートチームへの問い合わせ、またはコミュニティでの質問: サポートフォーラムで他の開発者に質問することもできます。
support@adapty.io またはチャットでサポートチームに連絡する: SDKのアップグレードが難しい場合や、アップグレードしても解決しない場合は、サポートチームにお問い合わせください。詳細ログを有効化してログを共有いただくと、問題の解決が早くなります。関連するコードスニペットを添付することもできます。