Unity SDKのエラーを処理する

SDKから返されるエラーはすべて AdaptyErrorCode 形式です。以下に例を示します。

Tip

デバッグ前に詳細ログを有効にしてください。 AdaptyError のほとんどは、StoreKit、Play Billing、ネットワーク、またはバックエンドのエラーをラップしています。詳細ログを有効にすると（Adapty.SetLogLevel(AdaptyLogLevel.Verbose, ...) — ログ記録を参照）、ラップされたエラーがコンソールに出力され、実際の原因を特定しやすくなります。

Important

これらの解決策で問題が解決しない場合は、サポートチームがより効率的にサポートできるよう、その他の問題セクションで事前に確認すべき手順をご覧ください。

using AdaptySDK;

Adapty.MakePurchase(product, (result, error) => {
  if (error != null && error.Code == AdaptyErrorCode.CantMakePayments) {
      // In-app purchases are not allowed on this device
  }
});

Note

ユーザーがキャンセルした購入はエラーではありません。MakePurchase はその結果を通じて報告します：result.Type が AdaptyPurchaseResultType.UserCancelled となります — 購入を行うをご覧ください。

システム StoreKit コード

エラー	コード	解決策
unknown	0	不明または予期しないエラーが発生したことを示すエラーコードです。再試行するか、その他の問題セクションをご確認ください。
clientInvalid	1	クライアントが実行しようとした操作を許可されていないことを示すエラーコードです。
paymentCancelled	2	ユーザーが支払いリクエストをキャンセルしたことを示すエラーコードです。対応は不要ですが、ビジネスロジックの観点から、ユーザーに割引を提供したり、後でリマインドしたりすることができます。
paymentInvalid	3	支払いパラメーターのいずれかが App Store に認識されなかったことを示すエラーです。
paymentNotAllowed	4	ユーザーが支払いの承認を許可されていないことを示すエラーコードです。
storeProductNotAvailable	5	リクエストされたプロダクトがストアで利用できないことを示すエラーコードです。アプリを再インストールしてみてください。
cloudServicePermissionDenied	6	ユーザーがクラウドサービス情報へのアクセスを許可していないことを示すエラーコードです。
cloudServiceNetworkConnectionFailed	7	デバイスがネットワークに接続できなかったことを示すエラーコードです。
cloudServiceRevoked	8	ユーザーがこのクラウドサービスの使用権限を取り消したことを示すエラーコードです。
privacyAcknowledgementRequired	9	ユーザーがまだ Apple のプライバシーポリシーに同意していないことを示すエラーコードです。
unauthorizedRequestData	10	アプリが必要な権限を持っていないプロパティを使用しようとしていることを示すエラーコードです。
invalidOfferIdentifier	11	オファーの `identifier` が有効ではありません。たとえば、App Store でそのIDのオファーが設定されていないか、オファーが取り消されています。 AppStore Connect で必要なオファーを設定し、有効なオファーIDを渡すようにしてください。
invalidSignature	12	支払い割引のシグネチャーが有効ではないことを示すエラーコードです。
missingOfferParams	13	支払い割引のパラメーターが不足していることを示すエラーコードです。
invalidOfferPrice	14	App Store Connect で指定した価格が無効になったことを示すエラーコードです。オファーは常に割引価格である必要があります。

Android カスタムコード

エラー	コード	解決策
adaptyNotInitialized	20	`Adapty.activate` メソッドを使用して Adapty SDK を適切に設定する必要があります。Unity の場合の設定方法をご確認ください。
productNotFound	22	このエラーは、購入しようとしたプロダクトがストアで利用できないことを示します。
invalidJson	23	ペイウォールの JSON が無効です。Adapty ダッシュボードで修正してください。修正方法の詳細はリモートコンフィグによるペイウォールのカスタマイズをご参照ください。
currentSubscriptionToUpdateNotFoundInHistory	24	更新が必要な元のサブスクリプションが見つかりません。
pendingPurchase	25	このエラーは、購入状態が「購入済み」ではなく「保留中」であることを示します。詳細は Android デベロッパードキュメントの保留中のトランザクションの処理をご参照ください。
billingServiceTimeout	97	このエラーは、Google Play が応答する前にリクエストが最大タイムアウトに達したことを示します。たとえば、Play Billing ライブラリの呼び出しによってリクエストされたアクションの実行が遅延した場合などに発生します。
featureNotSupported	98	リクエストされた機能は、現在のデバイスの Play ストアではサポートされていません。
billingServiceDisconnected	99	この致命的なエラーは、`BillingClient` を介したクライアントアプリと Google Play ストアサービスの接続が切断されたことを示します。
billingServiceUnavailable	102	この一時的なエラーは、Google Play Billing サービスが現在利用できないことを示します。多くの場合、クライアントデバイスと Google Play Billing サービスの間でネットワーク接続の問題が発生していることを意味します。
billingUnavailable	103	このエラーは、購入プロセス中にユーザーの課金エラーが発生したことを示します。発生する例としては以下が挙げられます。 1. ユーザーのデバイスの Play ストアアプリが古くなっている。 2. ユーザーがサポートされていない国にいる。 3. ユーザーがエンタープライズユーザーであり、エンタープライズ管理者が購入を無効にしている。 4. Google Play がユーザーの支払い方法に請求できない（例：クレジットカードの有効期限切れなど）。 5. ユーザーが Play ストアアプリにログインしていない。
developerError	105	これは、API の使用方法が不正であることを示す致命的なエラーです。
billingError	106	これは、Google Play 内部の問題を示す致命的なエラーです。
itemAlreadyOwned	107	消耗型アイテムはすでに購入済みです。
itemNotOwned	108	このエラーは、アイテムに対してリクエストされたアクションが失敗したことを示します。

StoreKit カスタムコード

エラー	コード	解決策
noProductIDsFound	1000	このエラーは、ペイウォールでリクエストしたプロダクトがApp Storeに登録されているにもかかわらず、購入可能な状態ではないことを示しています。このエラーは `InvalidProductIdentifiers` の警告と一緒に表示されることがあります。警告のみでエラーが出ない場合は無視して問題ありません。このエラーが発生している場合は、コード-1000 `noProductIDsFound` エラーの修正方法セクションの手順に従ってください。
productRequestFailed	1002	現在、利用可能なプロダクトを取得できません。考えられる原因： - キャッシュがまだ作成されておらず、かつインターネット接続もない状態。
cantMakePayments	1003	このデバイスではアプリ内課金が許可されていません。トラブルシューティングガイドを参照してください。
cantReadReceipt	1005	デバイスに有効なレシートがありません。サンドボックステスト中に発生することがあります。対応は不要ですが、ビジネスロジックの観点では、ユーザーに割引を提供したり、後でリマインドしたりすることを検討してください。
productPurchaseFailed	1006	プロダクトの購入に失敗しました。これは内部のStoreKitエラーをラップしています。ラップされたエラーを確認するか（または詳細ログを有効にしてコンソールで確認）、実際の原因を調べてください。ラップされたエラーは、通常上記の表にあるStoreKitコード0〜14のいずれかで、最も多いのは `paymentCancelled`、`paymentInvalid`、`paymentNotAllowed`、`invalidOfferPrice` です。具体的な原因が特定できない場合は、新しいサンドボックスプロファイルで試してみてください。それでも解決しない場合はAppleサポートにお問い合わせください。
refreshReceiptFailed	1010	このエラーは、レシートが受信されなかったことを示しています。StoreKit 1にのみ適用されます。
fetchSubscriptionStatusFailed	1020	SDKがストアからサブスクリプションのステータスを読み取れませんでした。呼び出しをリトライし、その他の問題セクションを参照してください。

ネットワークカスタムコード

エラー	コード	解決方法
notActivated	2002	Adapty SDK が有効化されていません。スプラッシュスクリーンや早期のスクリプトフックが `Adapty.Activate` の完了前に Adapty のメソッドを呼び出している場合によく発生します。実機のタイミングとエディタのタイミングが異なるため、エディタでは再現しないことがあります。他の SDK 呼び出しをスケジュールする前に、`Activate` の完了コールバックを待つようにしてください。完全なシーケンスについては Unity SDK の呼び出し順序を参照してください。
badRequest	2003	リクエストが不正です。 App Store との連携に必要なすべての手順を完了していることを確認してください。
serverError	2004	サーバーエラーです。しばらく時間をおいてから再試行してください。問題が解決しない場合は、Adapty サポートチームにお問い合わせください。
networkFailed	2005	ユーザーのデバイスのネットワーク接続に問題があることを示すエラーです。 VPN を無効にするか、モバイルデータ通信から WiFi に切り替えるか、その逆を試してみてください。
decodingFailed	2006	レスポンスのデコードに失敗したことを示すエラーです。コードを確認し、送信しているパラメータが有効であることを確認してください。たとえば、このエラーは無効な API キーを使用していることを示している場合があります。
encodingFailed	2009	リクエストのエンコードに失敗したことを示すエラーです。
analyticsDisabled	3000	アナリティクスをオプトアウトしているため、アナリティクスイベントを処理できません。
wrongParam	3001	一部のパラメータが正しくないことを示すエラーです。 Adapty のペイウォールビルダーを使用していて、このエラーによりペイウォールが表示できない場合は、ペイウォールビルダーの Show on device をオンにしてください。もう一つの考えられる原因は、ローカルのフォールバックファイルのバージョンが SDK バージョンと一致していないことです。ダッシュボードから新しいファイルをダウンロードしてください。
activateOnceError	3005	`.activate` メソッドを複数回呼び出すことはできません。
profileWasChanged	3006	操作中にユーザープロファイルが変更されました。 `Adapty.Identify` の実行中にメソッドが呼び出されると発生します。実行中の呼び出しが切り替わる直前のプロファイルに対して行われるため、SDK がそれを拒否します。ユーザーアクションの呼び出しを行う前に、`Identify` の完了コールバックを待つようにしてください。Unity SDK の呼び出し順序を参照してください。
unsupportedData	3007	SDK がサポートしていないデータ形式であることを示すエラーです。
fetchTimeoutError	3101	フェッチ操作がタイムアウトしたことを示すエラーです。
operationInterrupted	9000	この操作はシステムによって中断されました。再試行してください。

その他の問題

まだ解決策が見つからない場合は、次の手順をお試しください。

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