Skip to main content

エラーコード一覧

REST広告リクエスト(/request)は、レスポンスボディのcodeフィールドに以下のいずれかのコードを返します。 認証に失敗した場合は、HTTP 401を返します。HTTPステータスコードを参照してください。
  • msgフィールドには、人が読むためのメッセージではなく、上の表の定数名がそのまま入ります。エラー処理はcodeの値に基づいて分岐してください。
  • REST広告リクエストは4000(ERROR_CODE_INVALID_UNIT)と4001(ERROR_CODE_AD_INACTIVE)を返しません。誤った広告ユニットIDや、有効な広告キャンペーンがない広告ユニットの場合も4002を返します。

エラー詳細説明

ERROR_CODE_AD_NO_FILL (4002)

原因:リクエストに対して表示できる広告がありません。主な原因は次のとおりです。
  • 広告ユニットIDが誤っている、またはApp Keyとは別のアプリの広告ユニットIDでリクエストした
  • バナー・ネイティブ以外の広告ユニットでリクエストした
  • 該当広告ユニットに有効な広告キャンペーンがない
  • リクエストがキャンペーンのターゲティング条件(コンテキストターゲティングのcontextIdを含む)に一致しない
解決方法:
  • 広告ユニットIDが正確で、App Keyと同じアプリの広告ユニットか、コピー/ペースト時に空白や特殊文字が含まれていないか確認
  • バナーまたはネイティブの広告ユニットか確認
  • コンソールでキャンペーンが実行中か、キャンペーンスケジュール(開始日/終了日)と予算の消化状況を確認
  • contextIdがコンソールに入力したコンテキストIDと完全に一致しているか確認
  • ターゲティング設定が過度に制限的でないか確認
  • リトライロジックを実装(指数バックオフ推奨)
  • 代替コンテンツ(フォールバック)を準備
リトライ実装例:

ERROR_CODE_INVALID_PARAMS (4003)

原因:必須パラメータ(unit)がないか、値が空です。 解決方法:
  • 必須パラメータ(unit)が含まれ、値が空でないか確認
  • パラメータ名に誤りがないか確認
パラメータチェックリスト:

エラー処理のベストプラクティス

1. エラーコードに基づく分岐処理

2. フォールバックコンテンツの準備

3. モニタリングとロギング


HTTPステータスコード

REST APIは標準HTTPステータスコードも返します。
HTTP 200でもレスポンスボディのcode値を必ず確認してください。ビジネスロジックエラーはレスポンスボディに含まれます。

関連ドキュメント

REST API概要

API基本使用法

ターゲティング設定

ターゲティングパラメータ設定