SDKの初期化エラーのトラブルシューティング
Unity Ads SDKの初期化中に発生する可能性のある一般的な問題を解決します。
読み終わるまでの所要時間 1 分最終更新 7日前
これらのエラーは、Unity Ads SDK が正しく初期化されなかった場合に発生します。初期化が正常に完了しないと、広告のリクエスト、ロード、表示ができません。このガイドを使用して、Unity Ads SDK の初期化時に発生する可能性のある問題をすばやく特定し、修正します。
Symptoms
Unity Ads SDK を初期化しようとすると、以下のエラー メッセージが返されます。
[2] Unity Ads SDK の初期化に失敗 ―リクエストがタイムアウトしました。ネットワーク接続を確認し、後で再試行してください。
このエラーメッセージは、Unity のサーバーへのネットワークリクエストが予期された制限時間内に反応を受け取らなかったため、SDK の初期化が失敗したことを示しています。
Causes
このエラーが発生する一般的な原因としては、以下のものが考えられます。
- ネットワークワーク接続が弱い (Wi-Fi 例えばデバイス)デバイス
- サーバー反応遅延
- 低速デバイス
Resolution
この問題を解決するには、インターネットアクセスを確認し、初期化を再試行します。
Symptoms
Unity Ads SDK を初期化しようとすると、以下のエラー メッセージが返されます。
[52000] Unity Ads SDK の初期化に失敗 ―不明なエラーが発生しました。
このエラー メッセージは、不明または予期しない内部エラーによって SDK の初期化が失敗したことを示します。
Causes
このエラーの一般的な原因は、Unity Ads サーバでの一時的なバックエンドの問題が原因である可能性があります。
Resolution
この問題を解決するには、ネットワーク接続とゲーム ID が正しいことを確認してから、初期化を再試行してください。
エラーが解消されない場合は、詳細なログをキャプチャし、Unityサポートでバックエンドのレビュー用に共有してください。Unity Ads SDK の最新バージョンへの更新が必要な場合があります。
Symptoms
Unity Ads SDK を初期化しようとすると、以下のエラー メッセージが返されます。
[52001] Unity Ads SDK の初期化に失敗 ―無効なゲーム ID: $gameId。Unity Ads 収益化ダッシュボードでゲーム ID を確認します。
このエラー メッセージは、指定されたゲーム ID が無効(存在しないか数値以外)であるか、正しく参照されていないため、SDK の初期化に失敗したことを示します。
Causes
このエラーの一般的な原因は、以下の 1 つ以上の理由で発生する可能性がある、誤ったゲーム ID の使用です。
- 無効な/数字以外のゲーム ID が使用されている
- ダッシュボードボードからコピーされた、またはコードに挿入された誤ったゲーム ID
- 間違ったプロジェクトからゲーム ID をコピーする
- 収益化ダッシュボードで削除またはアーカイブされているプロジェクト
Resolution
この問題を解決するには、収益化ダッシュボードでゲームIDを確認し、それが正しいプロジェクトと一致することを確認し、コード内のプレースホルダー値または数値以外の値を置き換えます。
収益化ダッシュボードでプロジェクトを作成したばかりの場合は、バックエンドの同期に数分待ちます。
Symptoms
Unity Ads SDK を初期化しようとすると、以下のエラー メッセージが返されます。
[52002] Unity Ads SDK の初期化に失敗 ―ゲーム ID が一致しません。Unity Ads 収益化ダッシュボードからターゲットプラットフォームの正しいゲーム ID を使用します。
このエラーメッセージは、渡されたゲーム ID がアプリケーションを実行しているプラットプラットフォームと一致しないために SDK の初期化が失敗したことを示しています。
Causes
このエラーが発生する一般的な原因としては、以下のものが考えられます。
- Android ビルドに iOS ゲーム ID を渡す
- Android ゲーム ID を iOS ビルドに渡す
- 収益化ダッシュボードでゲーム ID を誤って割り当てたり、別のプラットフォームに関連付けたりする
- ダッシュボードボードから間違ったゲーム ID をコピーする、またはコードに挿入する
- 条件付きコンパイル ロジックを使用している場合、ランタイムにプラットフォーム固有のゲーム ID を選択できない
Resolution
この問題を解決するには、Unity Ads ダッシュボードで正しい Android または iOS ゲーム ID を使用していることを確認し、初期化期化中にコードが条件付きで適切な ID を選択していることを確認します。デバッグで、SDK が Android と iOS の間で適切なプラットプラットフォームを検出していることを確認します。
Symptoms
Unity Ads SDK を初期化しようとすると、以下のエラー メッセージが返されます。
[52003] Unity Ads SDK の初期化に失敗 ―内部プロトコルコルエラーが発生しました。もう一度やり直してください。
このエラー メッセージは、SDK が Unity サーバにリクエストを送信し、不完全または予期しない反応を受け取ったため、SDK の初期化が失敗したことを示します。
Causes
このエラーが発生する一般的な原因としては、以下のものが考えられます。
- Unity サーバからの初期化反応の形式が正しくありませんでした。
- 一時的なサーバーの問題
- ネットワーク問題
Resolution
この問題を解決するには、安定した接続を確認し、後で初期化を再試行してください。
エラーが再現可能な場合は、ログを有効にしてHTTPレスポンスをキャプチャし、Unityサポートにレポートしてバックエンドでレビューします。
Symptoms
Unity Ads SDK を初期化しようとすると、以下のエラー メッセージが返されます。
[52004] Unity Ads SDK の初期化に失敗 ―システムエラーが発生しました。もう一度やり直してください。
このエラー メッセージは、SDK の起動を完了できないシステムレベルの内部問題がデバイスに発生したため、SDK の初期化に失敗したことを示します。
Causes
このエラーが発生する一般的な原因としては、以下のものが考えられます。
- SDK が必要なファイルまたはシステム情報の読み取りまたは書き込みができませんでした
- 初期化中にデバイスが使用可能なストレージまたはメモリを使い果たした。
- SDK のローカルキャッシュまたはフォルダーの作成時に読み取りまたは書き込みエラーが発生しました
Resolution
この問題を解決するには、アプリケーションに必要な権限と十分なデバイス ストレージがあることを確認し、再起動後に初期化を再試行してください。
エラーが解消されない場合は、アプリケーションのキャッシュを消去して破損したローカル SDK データを削除します。
Symptoms
Unity Ads SDK を初期化しようとすると、以下のエラー メッセージが返されます。
[52005] Unity Ads SDK の初期化に失敗 ―ネットワークエラーが発生しました。もう一度やり直してください。
このエラーメッセージは、ネットワーク接続の問題により SDK が Unity サーバーと正常に通信できなかったために SDK の初期化が失敗したことを示しています。
Causes
このエラーが発生する一般的な原因としては、以下のものが考えられます。
- インターネット接続がない(またはデバイスがオフラインか機内モードである)
- 不安定な信号または弱い接続
- VPN が Unity Ads ドメインをブロックしている可能性があります。
- デバイスが Unity Ads エンドポイントを解決できない、または Unity Ads エンドポイントに到達できない
Resolution
この問題を解決するには、デバイスに安定したインターネット接続があることを確認し、制限のあるファイアウォールや VPN を避け、接続を確認した後に初期化を再試行します。
エラーが解消されない場合は、ログをキャプチャして、特定の HTTP コード(例えば、、)が繰り返されているかどうかを確認します。
-1009-1022Symptoms
Unity Ads SDK を初期化しようとすると、以下のエラー メッセージが返されます。
[52006] Unity Ads SDK の初期化に失敗 ―デバイス上のストレージ スペースが不足しています。スペースを解放して再試行してください。
このエラーメッセージは、初期化中に Unity Ads SDK が設定データ、キャッシュされたアセット、ログを格納するために必要なローカルファイルを作成または書き込むための十分な空きストレージスペースがデバイスにないために、SDK の初期化に失敗したことを示しています。
Causes
このエラーが発生する一般的な原因としては、以下のものが考えられます。
- デバイスの使用可能ストレージがゼロまたは不足している
- アプリケーションに割り当てられたキャッシュまたはディレクトリぱいになっている
- 永続化されたキャッシュの蓄積(古いログ、キャッシュされたアセット、または消去されていない一時データ)
Resolution
この問題を解決するには、ディスク スペースを解放してデバイス ストレージを解放し(未使用のアプリケーション、メディア、ファイルを削除)、必要に応じてデバイス設定からアプリケーションのキャッシュを消去して古いSDKデータを削除し、SDKの初期化を再度試みます。