エラー処理
広告表示デリゲートまたはコールバックインターフェースは、広告のロードに失敗したり、表示に失敗した場合に呼び出しを受けます。 このコールにはエラーコードが伴います。 このページでは、これらのエラーコードについて説明します。
エラーオブジェクト
コールバックで受信するエラーは、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)] (https://intl.cloud.tencent.com/jp/document/product/1024/30722)および[Tencent (iOS)](https://intl.cloud.tencent.com/jp/document/product/1024/30731)
- Unity Ads (Android)およびUnity Ads (iOS)
- Yandex
- YSO Network (Android)およびYSO Network (iOS)