エラーコード一覧
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ステータスコードも返します。関連ドキュメント
REST API概要
API基本使用法
ターゲティング設定
ターゲティングパラメータ設定