エラー処理
広告表示デリゲートまたはコールバックインターフェースは、広告のロードに失敗したり、表示に失敗した場合に呼び出しを受けます。 このコールにはエラーコードが伴います。 このページでは、これらのエラーコードについて説明します。
エラーオブジェクト
コールバックで受け取るエラーは、MaxErrorを実装するファーストクラスエラーオブジェクトです。
このオブジェクトには以下のメソッドがあります。
getCode()- 以下の表にあるエラーコードを返します。
getMessage()- エラーについて説明する、人間が読める形式のメッセージを返します。
getMediatedNetworkErrorCode()- エラーに対するメディエーションネットワークのエラーコードを返します。 この機能は、広告ディスプレイの失敗コールバックで返されたエラーにのみ利用できます。
getMediatedNetworkErrorMessage()- エラーに対するメディエーションネットワークのエラーメッセージを返します。 デフォルトは空の文字列です。 この機能は、広告ディスプレイの失敗コールバックで返されたエラーにのみ利用できます。
getWaterfall()- 広告の現在のウォーターフォール情報を確認できます。 ネットワークのレスポンスには、ウォーターフォール内の各広告に対する広告のロード状態、レイテンシー、認証情報、およびメディエーションネットワーク情報が含まれます。 ウォーターフォール内の広告がロードに失敗した場合、ネットワークレスポンスがエラー情報を提供します。 このメソッドの詳細については、アドバンス設定：Waterfall Information APIを参照してください。
MAXエラーコード
| コード | 定数 | 説明 | Load（ロード） / Display（ディスプレイ） |
|---|---|---|---|
| 204 | MaxErrorCode.NO_FILL | 現在、デバイスの対象となる広告がありません（フィルなし）。MAXはこのアプリ/デバイスに対して、どのメディエーションネットワークからも対象となる広告を返しませんでした。 | L |
| −1 | MaxErrorCode.UNSPECIFIED | システムが想定外の状態にあります。この状態は、定義されているエラーに分類できません。詳細については、エラーオブジェクトのメッセージフィールドを確認してください。 | L/D |
| −23 | MaxErrorCode.FULLSCREEN_AD_ALREADY_SHOWING | 別のフルスクリーン広告がまだ表示されている間に、フルスクリーン広告（インタースティシャルまたはリワード広告）を表示しようとしています。 | D |
| −24 | MaxErrorCode.FULLSCREEN_AD_NOT_READY | フルスクリーン広告のロードが完了する前に、フルスクリーン広告を表示しようとしています。 | D |
| -1000 | MaxErrorCode.NETWORK_ERROR | 一般的なネットワークエラーにより、広告リクエストが失敗しました。詳細はエラーオブジェクトのメッセージフィールドを確認してください。 | L |
| −1001 | MaxErrorCode.NETWORK_TIMEOUT | インターネット接続が遅いため、広告リクエストがタイムアウトしました。 | L |
| −1009 | MaxErrorCode.NO_NETWORK | デバイスがインターネットに接続されていないため、広告リクエストが失敗しました。 | L |
| −5001 | MaxErrorCode.AD_LOAD_FAILED | どのネットワークも広告枠を埋められなかったため、広告のロードに失敗しました。MAXはメディエーションネットワークから適格な広告を返しましたが、すべの広告のロードに失敗しました。詳細については、エラーオブジェクトのadLoadFailureInfoフィールドを参照してください。 | L |
| −5201 | MaxErrorCode.ERROR_CODE_INVALID_LOAD_STATE | SDKの内部状態が無効です。これが発生する理由は様々あります。 | L |
| −5205 | MaxAdapterError.AD_NOT_READY | 表示しようとした時点で、アダプターで広告が準備されていませんでした。 | L |
| −5209 | MaxAdapterError.INTERNAL_ERROR | 特定できない内部エラー。 | L |
| −5601 | MaxErrorCode.NO_ACTIVITY | SDKは最上位のActivityを見つけることができなかったため、広告のロードに失敗しました。 | L |
| −5602 | MaxErrorCode.DONT_KEEP_ACTIVITIES_ENABLED | ユーザーが「Don’t Keep Activities（アクティビティを保持しない）」開発者設定を有効にしているため、SDKが広告の表示に失敗しました。 | D |
| −5603 | MaxErrorCode.INVALID_AD_UNIT_ID | パブリッシャーが無効な広告ユニットIDを提供したため、SDKは広告のロードに失敗しました。考えられる理由は次のとおりです。
| L |
各ネットワークからのエラーコード
アドネットワークが返すエラーコードの詳細については、各ネットワークが公開するエラードキュメントのページをご参照ください。