エラー処理
広告表示デリゲートまたはコールバックインターフェースは、広告のロードに失敗したり、表示に失敗した場合に呼び出しを受けます。 このコールにはエラーコードが伴います。 このページでは、これらのエラーコードについて説明します。
エラーオブジェクト
コールバックで受信するエラーは、ErrorInfoを実装するファーストクラスのエラーオブジェクトです。
このオブジェクトには、以下のAPIが含まれています。
Code- エラーコードは、以下の表で確認してください。
Message- エラーを説明する、読み取り可能なメッセージ。
MediatedNetworkErrorCode- メディエーションネットワークのエラーコード。 広告表示の失敗コールバックで返されるエラーにのみ利用可能。
MediatedNetworkErrorMessage- エラーに対するメディエーションネットワークのエラーメッセージを返す。 デフォルトは空の文字列です。 広告表示の失敗コールバックで返されるエラーにのみ利用可能です。
WaterfallInfo- 広告がロードされた場合、またはロードに失敗した場合に、現在のウォーターフォールの情報を確認できます。 ネットワークのレスポンスには、広告のロード状態、レイテンシー、認証情報、およびメディエーションネットワーク情報が含まれます。ウォーターフォール内の広告がロードに失敗した場合、ネットワークのレスポンスにはエラー情報が提供されます。詳細は、アドバンス設定: ウォーターフォール情報APIで確認してください。
MAXエラーコード
| コード | MaxSdkBase.ErrorCode 定数 | 説明 | Load / Display |
|---|---|---|---|
| −1 | .Unspecified | システムが予期しない状態にあります。このエラーコードは、他の定義済みエラーのいずれにも分類できなかったエラーを表します。詳細はエラーオブジェクトブジェクトのメッセージフィールドを確認してください。 | L/D |
| 204 | .NoFill | 現在、デバイスの対象となる広告がありません（在庫なし）。MAXはこのアプリ/デバイスに対して、どのメディエーションネットワークからも適格な広告を返しませんでした。 | L |
| −5001 | .AdLoadFailed | ネットワークが広告枠を埋められなかったため、広告のロードに失敗しました。MAXはメディエーションネットワークから適格な広告を返しましたが、すべての広告がロードに失敗しました。詳細はエラーオブジェクトの adLoadFailureInfo フィールドを参照してください。 | L |
| -1000 | .NetworkError | 一般的なネットワークエラーにより、広告リクエストが失敗しました。詳細はエラーオブジェクトのメッセージフィールドを確認してください。 | L |
| −1001 | .NetworkTimeout | インターネット接続が遅いため、広告リクエストがタイムアウトしました。 | L |
| −1009 | .NoNetwork | デバイスがインターネットに接続されていないため、広告リクエストが失敗しました。 | L |
| −23 | .FullscreenAdAlreadyShowing | 別のフルスクリーン広告が表示されている間に、フルスクリーン広告（インタースティシャルまたはリワード広告）を表示しようとしています。 | D |
| −24 | .FullscreenAdNotReady | フルスクリーン広告のロードが完了する前に、フルスクリーン広告を表示しようとしています。 | D |
| −5601 | .NoActivity | SDKは最上位のActivityを見つけることができなかったため、広告のロードに失敗しました。 | L |
| −5602 | .DontKeepActivitiesEnabled | ユーザーが開発者設定で「Don’t Keep Activities（アクティビティを保持しない）」設定を有効にしているため、SDKが広告の表示に失敗しました。 | D |
| −5603 | .InvalidAdUnitID | パブリッシャーが無効な広告ユニットIDを提供したため、SDKが広告のロードに失敗しました。広告ユニットIDが無効である理由として考えられること：
| L |
各ネットワークからのエラーコード
アドネットワークが返すエラーコードの詳細については、各ネットワークが公開するエラードキュメントのページをご参照ください。
- BidMachine (Android) & BidMachine (iOS)
- Chartboost
- DT Exchange
- Google BiddingとGoogle AdMob (Android)および Google BiddingとGoogle AdMob
- InMobi
- ironSource (Android)および ironSource (iOS)
- Liftoff Monetize
- Line (Android)、 Line (iOS) (こちらも参照)
- Maio (Android) & Maio (iOS)
- Meta Audience Network
- Mintegral
- MoPub
- Ogury — インタースティシャル広告(Android)およびOgury — インタースティシャル広告 (iOS)
- Ogury — オプトイン動画広告 (Android)およびOgury — オプトイン動画広告 (iOS)
- Ogury — バナー広告 (Android)およびOgury — バナー広告 (iOS)
- Pangle (Android)およびPangle (iOS)
- Tencent (Android)およびTencent (iOS)
- Unity Ads (Android)およびUnity Ads (iOS)
- Yandex
- YSO Network (Android)およびYSO Network (iOS)