Android SDKのエラーを処理する

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

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

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

エラー解決策
UNKNOWN不明または予期しないエラーが発生したことを示します。
ITEM_UNAVAILABLEこのエラーは主にテスト段階で発生します。プロダクトが本番環境に存在しないか、ユーザーが Google Play のテスターグループに属していない可能性があります。
ADAPTY_NOT_INITIALIZEDAdapty 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_TIMEOUTGoogle Play が応答する前にリクエストが最大タイムアウトに達したことを示します。Play Billing Library の呼び出しで要求されたアクションの実行が遅延した場合などに発生します。
FEATURE_NOT_SUPPORTED要求された機能が現在のデバイスの Play Store でサポートされていません。
BILLING_SERVICE_DISCONNECTEDクライアントアプリと BillingClient 経由の Google Play Store サービスとの接続が切断されたことを示します。
BILLING_SERVICE_UNAVAILABLEGoogle Play Billing サービスが現在利用できないことを示します。ほとんどの場合、クライアントデバイスと Google Play Billing サービスの間のどこかでネットワーク接続の問題が発生しています。
BILLING_UNAVAILABLE

購入プロセス中に請求に関する問題が発生したことを示します。考えられる原因は以下のとおりです:

1. ユーザーのデバイスに Play Store アプリがインストールされていないか、古いバージョンです。

2. ユーザーがサポートされていない国にいます。

3. ユーザーが、管理者によって購入が無効化されているエンタープライズアカウントに属しています。

4. Google Play がユーザーの支払い方法に請求できませんでした(例:クレジットカードの有効期限切れ)。

5. ユーザーが Play Store アプリにログインしていません。

DEVELOPER_ERRORAPI の使い方が正しくないことを示します。
BILLING_ERRORGoogle Play 自体の内部的な問題を示します。
ITEM_ALREADY_OWNEDそのプロダクトはすでに購入済みです。
ITEM_NOT_OWNEDユーザーがそのアイテムを所有していないため、要求されたアクションが失敗したことを示します。
BILLING_NETWORK_ERRORデバイスと Play のシステム間のネットワーク接続に問題があったことを示します。
NO_PRODUCT_IDS_FOUND

ペイウォール内のプロダクトがいずれもストアで利用できないことを示します。

このエラーが発生した場合は、以下の手順で解決してください:

  1. すべてのプロダクトが Adapty ダッシュボードに追加されているか確認してください。
  2. アプリの Package name が Google Play Console のものと一致していることを確認してください。
  3. アプリストアのプロダクト ID がダッシュボードに追加したものと一致していることを確認してください。ストアにすでに Bundle ID が含まれている場合を除き、ID に Bundle ID を含めないようにしてください。
  4. Google の税設定でアプリの有料ステータスが Active になっていることを確認してください。税情報が最新であり、証明書が有効であることも確認してください。
  5. 収益化の対象となるよう、アプリに銀行口座が紐付けられているか確認してください。
  6. プロダクトがお住まいの地域で利用可能か確認してください。
  7. アプリがいずれかのテストトラックに登録されていることを確認してください。Internal testing トラックはレビュー不要でアプリが顧客に公開されないため、最も手軽な選択肢です。
NO_PURCHASES_TO_RESTOREGoogle Play が復元する購入を見つけられなかったことを示します。
AUTHENTICATION_ERRORAdapty.activate メソッドを使用して Adapty SDK を正しく設定 する必要があります。
BAD_REQUESTリクエストが不正です。
Google Play との連携 に必要なすべての手順を完了していることを確認してください。
SERVER_ERRORサーバーエラーです。
REQUEST_FAILED正確に特定できないネットワークの問題を示します。
DECODING_FAILEDレスポンスのデコードに失敗しました。
コードを確認し、送信しているパラメータが有効であることを確認してください。例えば、無効な API キーを使用している場合にもこのエラーが発生することがあります。
ANALYTICS_DISABLED無効化されている ため、アナリティクスイベントを処理できません。
WRONG_PARAMETERパラメータの一部が正しくないことを示します。空白にできない箇所が空白になっている、型が間違っているなどが原因として考えられます。

その他の問題

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

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