SDKロードエラーのトラブルシューティング
広告リクエスト中に広告をロードする際に発生する可能性のある一般的な問題を解決します。
読み終わるまでの所要時間 1 分最終更新 7日前
これらのエラーは、Unity Ads SDK が広告コンテンツを取得できない場合に発生します。広告が正常にロードされない場合は、広告を表示できません。そのため、広告リクエストは満たされません。このガイドでは、広告のロード時に発生する可能性のある問題をすばやく特定して修正できます。
Symptoms
Unity Ads SDK を使用して広告をロードしようとすると、以下のエラー メッセージが返されます。
[2] Unity Ads SDK の広告ロードが失敗しました ―リクエストがタイムアウトしました。ネットワーク接続を確認し、後で再試行してください。
このエラーメッセージは、Unity Ads SDK による Unity のサーバーへの広告リクエスト期された制限時間内に反応を受信しなかったため、広告ロードが失敗したことを示しています。
Causes
このエラーが発生する一般的な原因としては、以下のものが考えられます。
- ネットワークワーク接続が弱い (Wi-Fi 例えばデバイス)デバイス
- 一時的なネットワーク遅延
- サーバー反応遅延
Resolution
この問題を解決するには、デバイスに信頼性の高いインターネット接続があることを確認し、後で広告のロードを再試行してください。
Symptoms
Unity Ads SDK を使用して広告をロードしようとすると、以下のエラー メッセージが返されます。
[52100] Unity Ads SDK の広告ロードが失敗しました ―リクエストされた配置に利用できる広告枠がありません。
このエラー メッセージは、Unity Ads ネットワークが広告のフィルを完了できなかったために広告ロードが失敗したことを示しています。
Causes
このエラーの理由は、Unity Ads ネットワークが広告のフィルを完了できなかったためです。
注
広告リクエストが毎回満たされるとは限りません。フィルレートは、地域、キャンペーンの可用性、および広告市場価格によって異なります。これは時間の経過とともに変動する可能性があります。
Resolution
広告枠がなく、広告のロードに失敗した場合は、後で広告を再ロードしてみてください。
Unity Ads でフィルレートが常に低い場合は、application-ads.txt ファイルの設定(または正しく設定されていることを確認)を検討してください。多くの広告パートナーは、ファイルが正しく実装されているゲームにのみ入札します。この基準は、詐欺に対処し、広告市場の透明度を高めるために開発されました。Unity LevelPlay または別のメディエーション パートナーを使用して、フィルレートを向上させることもできます。
app-ads.txt収益の増加に関するその他のガイダンスについては、アカウント マネージャーまたはUnityサポートに接触してください。
Symptoms
Unity Ads SDK を使用して広告をロードしようとすると、以下のエラー メッセージが返されます。
[52101] Unity Ads SDK の広告ロードが失敗しました ―Unity Ads SDK が初期化されていません。広告をロードする前に SDK を初期化します。
このエラー メッセージは、ロードが試行される前に SDK が初期化されなかったために広告ロードが失敗したことを示しています。
Causes
このエラーが発生する一般的な原因としては、以下のものが考えられます。
- 広告のロード前に SDK 初期化メソッドが呼び出されませんでした
- SDK の初期化が失敗したため、ロードメソッドが実行されませんでした。
Resolution
この問題を解決するには、広告をロードする前に Unity Ads SDK が正常に初期化されていることを確認してください。
Symptoms
Unity Ads SDK を使用して広告をロードしようとすると、以下のエラー メッセージが返されます。
[52102] Unity Ads SDK の広告ロードが失敗しました ―配置が見つかりません。Unity Ads 収益化ダッシュボードの正しい配置 ID を使用します。
このエラー メッセージは、コードで使用されている配置 ID が Unity Ads プロジェクトで定義されているどの配置とも一致しないため、広告のロードに失敗したことを示しています。
Causes
このエラーが発生する一般的な原因としては、以下のものが考えられます。
- 配置 ID の大文字と小文字の区別またはスペルミス
- 収益化ダッシュボードに配置が追加されていない
- 配置は存在するが、他のプラットフォーム向け (例えば、Android ビルドのテスト中に iOS 配置をロードする場合)
- 別のアプリケーションにゲーム ID を使用しているため、プレースメントが対応しない
Resolution
この問題を解決するには、Unity Ads の収益化ダッシュボードでその配置が存在し、アクティブになっていることを確認し、プラットフォーム固有の正しい配置 ID を使用していることを確認し、スペルと大文字と小文字の区別を再確認します。
最近新しい配置を追加した場合は、アプリケーションを再起動するか、SDK キャッシュを消去します。配置 ID を最近変更した場合は、クリーン リビルドを実行して変更が確実に更新されるようにします。
注
プレースメントはプロジェクトおよびプラットフォームごとに定義されます。ゲーム ID と配置 ID の両方が同じ収益化ダッシュボード設定に属していることを確認します。
Symptoms
Unity Ads SDK を使用して広告をロードしようとすると、以下のエラー メッセージが返されます。
[52103] Unity Ads SDK の広告ロードが失敗しました ―内部プロトコルコルエラーが発生しました。もう一度やり直してください。
このエラー メッセージは、SDK が Unity の広告サーバーと通信中に予期しない反応または不正な形式の反応が検出されたため、広告ロードが失敗したことを示します。
Causes
このエラーが発生する一般的な原因としては、以下のものが考えられます。
- 不正な形式または不完全なサーバー反応
- SDK がバックエンドのプロトコルを解析できませんでした
- バックエンドゲートウェイの問題
Resolution
この問題を解決するには、安定したネットワーク接続を確保し、HTTP 応答を変更または切り捨てる可能性のある VPN を避け、広告のロードを再試行します。
エラーが解消されない場合は、詳細なログをキャプチャし、Unityサポートでバックエンドのレビューのために共有してください。
Symptoms
Unity Ads SDK を使用して広告をロードしようとすると、以下のエラー メッセージが返されます。
[52104] Unity Ads SDK の広告ロードが失敗しました ―配置 ID が広告形式または配置タイプと一致しません。Unity Ads Monetization (Unity Ads 収益化) ダッシュボードで配置設定を確認します。
このエラー メッセージは、指定された配置 ID が、要求されたものとは異なる広告形式または配置タイプに設定されているため、広告ロードに失敗したことを示しています。
Causes
このエラーが発生する一般的な原因としては、以下のものが考えられます。
- 配置に間違った広告形式を使用している(例えば、リワード型配置 ID のインタースティシャル広告をロードするメソッドを呼び出している)
- 間違ったタイプの配置を使用している (例えば配置いる)配置
- 誤ったダッシュボード設定を予想とは異なる広告タイプに設定している
- 配置タイプは正しいが別のプラットフォームに属しているというプラットフォームの不一致
- ダッシュボードボードで削除または変更された配置を参照する
Resolution
この問題を解決するには、Unity Ads の収益化ダッシュボードで、配置の広告形式が使用している API 呼び出しと一致することを確認し、正しいプラットフォーム固有の配置 ID をロードしていることを確認します。
Symptoms
Unity Ads SDK を使用して広告をロードしようとすると、以下のエラー メッセージが返されます。
[52105] Unity Ads SDK の広告ロードが失敗しました ―ネットワークエラーが発生しました。ネットワーク接続を確認し、後で再試行してください。
このエラー メッセージは、Unity Ads SDK が広告のロードを試行中に Unity の広告配信サーバへのネットワーク接続を確立または維持できなかったために、広告のロードが失敗したことを示しています。
Causes
このエラーが発生する一般的な原因としては、以下のものが考えられます。
- インターネット接続がない(またはデバイスがオフラインまたは機内モードである)
- 使用されている VPN が Unity Ads ドメインをブロックしている
- デバイスが Unity Ads エンドポイントを解決できない
Resolution
この問題を解決するには、デバイスに安定したインターネット接続があることを確認し、VPN を無効にして、ネットワークが使用可能であることを確認した後で広告のロードを再試行します。
Symptoms
Unity Ads SDK を使用して広告をロードしようとすると、以下のエラー メッセージが返されます。
[52106] Unity Ads SDK の広告ロードが失敗しました ―デバイス上のストレージ スペースが不足しています。スペースを解放して再試行してください。
このエラー メッセージは、デバイスの使用可能なストレージ スペースが不足し、SDK が一時的な広告アセットをキャッシュまたはディスクに書き込めなくなったため、広告ロードが失敗したことを示します。
Causes
このエラーが発生する一般的な原因としては、以下のものが考えられます。
- デバイスに空きストレージ容量がない
- デバイスにスペース容量があっても、アプリケーションのローカルディレクトリキャッシュがいっぱいになっている
Resolution
この問題を解決するには、デバイスのストレージスペースを解放するか、アプリケーションのキャッシュデータを消去してから、広告のロードを再試行してください。
Symptoms
Unity Ads SDK を使用して広告をロードしようとすると、以下のエラー メッセージが返されます。
[52107] Unity Ads SDK の広告ロードが失敗しました ―広告反応の解析中に内部エラーが発生しました。
このエラー メッセージは、Unity Ads SDK が Unity のサーバからの広告反応の処理中に内部解析エラーが発生したため、広告ロードが失敗したことを示します。
Causes
このエラーが発生する一般的な原因としては、以下のものが考えられます。
- 不正な形式のサーバー反応が不完全、切り捨てられた、または形式が正しくありませんでした。
- 広告メタデータの読み取り中に SDK のパーサーが失敗しました
- 古い SDK が新しいプロトコルに対して使用されている
- VPN が Unity Ads ドメインをブロックしている可能性があります
Resolution
この問題を解決するには、安定したネットワーク接続を確保し、制限のあるファイアウォールまたは VPN を避け、後で広告のリロードを再試行してください。
エラーが解消されない場合は、詳細なログをキャプチャし、Unityサポートでバックエンドのレビューのために共有してください。