エラー処理
広告表示デリゲートまたはコールバックインターフェースは、広告のロードに失敗したり、表示に失敗した場合に呼び出しを受けます。 このコールにはエラーコードが伴います。 このページでは、これらのエラーコードについて説明します。
エラーオブジェクト
コールバックで受信するエラーは、MAErrorを実装するファーストクラスのエラーオブジェクトです。
このオブジェクトには、以下のAPIが含まれています。
code- エラーコードは、以下の表で確認してください。
message- エラーを説明する人間が読めるメッセージ。
mediatedNetworkErrorCode- メディエーションネットワークのエラーコード。 広告表示の失敗コールバックで返されるエラーにのみ利用可能。
mediatedNetworkErrorMessage- エラーに対するメディエーションネットワークのエラーメッセージを返す。 デフォルトは空の文字列です。 広告表示の失敗コールバックで返されるエラーにのみ利用可能です。
getWaterfall()- 広告がロードされた場合、またはロードに失敗した場合に、現在のウォーターフォールの情報を確認できます。 ネットワークのレスポンスには、広告のロード状態、レイテンシー、認証情報、およびメディエーションネットワーク情報が含まれます。 ウォーターフォール内の広告がロードに失敗した場合、ネットワークのレスポンスにはエラー情報が提供されます。 詳細は、アドバンス設定: ウォーターフォール情報APIで確認してください。
MAXエラーコード
| コード | 定数 | 説明 | Load / Display |
|---|---|---|---|
| −1 | MAErrorCodeUnspecified | システムが予期しない状態にあります。このエラーコードは、他の定義済みエラーのいずれにも分類できなかったエラーを表します。詳細はエラーオブジェクトブジェクトのメッセージフィールドを確認してください。 | L/D |
| 204 | MAErrorCodeNoFill | 現在、デバイスの対象となる広告がありません（フィルなし）。MAXはこのアプリ/デバイスに対して、どのメディエーションネットワークからも対象となる広告を返しませんでした。 | L |
| −5001 | MAErrorCodeAdLoadFailed | ネットワークが広告枠を埋められなかったため、広告のロードに失敗しました。MAXはメディエーションネットワークから適格な広告を返しましたが、すべての広告がロードに失敗しました。詳細はエラーオブジェクトの adLoadFailureInfo フィールドを参照してください。 | L |
| -1000 | MAErrorCodeNetworkError | 一般的なネットワークエラーにより、広告リクエストが失敗しました。詳細はエラーオブジェクトのメッセージフィールドを確認してください。 | L |
| −1001 | MAErrorCodeNetworkTimeout | インターネット接続が遅いため、広告リクエストがタイムアウトしました。 | L |
| −1009 | MAErrorCodeNoNetwork | デバイスがインターネットに接続されていないため、広告リクエストが失敗しました。 | L |
| −23 | MAErrorCodeFullscreenAdAlreadyShowing | 別のフルスクリーン広告がまだ表示されている間に、フルスクリーン広告（インタースティシャルまたはリワード広告）を表示しようとしています。 | D |
| −24 | MAAdapterError.adNotReady | フルスクリーン広告のロードが完了する前に、フルスクリーン広告を表示しようとしています。 | D |
| −5205 | MAAdapterError.adNotReady | 表示しようとした時点で、アダプターで広告が準備されていませんでした。 | L |
| −5209 | MAAdapterError.internalError | 特定できない内部エラー。 | L |
| −5603 | MAErrorCodeInvalidAdUnitIdentifier | パブリッシャーが無効な広告ユニットIDを提供したため、SDKが広告のロードに失敗しました。広告ユニットIDが無効である理由として考えられること：
| L |
各ネットワークからのエラーコード
アドネットワークが返すエラーコードの詳細については、各ネットワークが公開するエラードキュメントのページをご参照ください。