sellers.json バリデーター
sellers.json ドキュメントを IAB Tech Lab 仕様に照らしてブラウザ内で検証します。貼り付けたファイルはデバイス上に留まります。
sellers.json バリデーターは、すべてブラウザ内で動作します。貼り付けたドキュメントはデバイス上で解析・確認され、URL からフェッチされることも ArrayKit にアップロードされることもありません。
ads.txt バリデーターを開く
sellers.json バリデーター について
sellers.json バリデーターは、貼り付けた瞬間に IAB Tech Lab の sellers.json ドキュメントをリントします。必須のトップレベル version と sellers[] 配列を確認し、次にすべての seller エントリを辿ります: 各エントリにはファイル全体で一意な seller_id と、PUBLISHER、INTERMEDIARY、BOTH のいずれかの seller_type(大文字小文字を区別しない)が必要です。seller が is_confidential とマークされていない限り name と domain は必須で、is_passthrough はクリーンな boolean でなければなりません。結果は合否の判定、配列インデックスと seller_id が付いた seller ごとのエラーメッセージ、そして type ごとの seller 数に加え confidential と passthrough のエントリ数を数えるサマリーとして返されます。広告オペレーションとサプライパスのチームは、ファイルをサードパーティサービスに POST することなく、自社やパートナーのファイルをここで監査できます — すべてデバイス上で動作します。
機能
- sellers.json 仕様に沿って、必須のトップレベル version と sellers[] 配列を確認
- すべての seller_id が存在し、ファイル内で一意であることを検証
- seller_type を PUBLISHER、INTERMEDIARY、BOTH(大文字小文字を区別しない)に照らして検証
- seller が is_confidential = 1 を設定していない限り name と domain を強制
- is_confidential と is_passthrough がクリーンな 0/1 の boolean フラグであることを確認
- 各エラーに sellers[] のインデックスと問題の seller_id を付与
- seller_type ごとの数に加え confidential と passthrough の合計を要約
- ドキュメントをブラウザ内で解析・検証 — ファイルがデバイスから離れることはありません
sellers.json バリデーター の使い方
- sellers.json ドキュメントを貼り付けるか、サンプルを読み込んで期待される形状を確認する
- 合否の判定と seller-type のサマリー数を読む
- メッセージ内のインデックスと seller_id を使って、指摘された各 sellers[i] エントリにジャンプする
- 問題のフィールドを修正し、ドキュメントが通るまで再検証する
例
入力
{
"version": "1.0",
"sellers": [
{ "seller_id": "1001", "seller_type": "RESELLER" }
]
}
出力
Invalid sellers.json — 3 issues
sellers[0] (seller_id 1001) — Invalid "seller_type" "RESELLER". Must be one of PUBLISHER, INTERMEDIARY, or BOTH.
sellers[0] — "name" is required unless the seller is confidential.
sellers[0] — "domain" is required unless the seller is confidential.
seller_type は PUBLISHER、INTERMEDIARY、BOTH のみを受け付け、非 confidential の seller には name と domain が必要です。
よくあるエラーとトラブルシューティング
- 明らかに sellers を持つファイルで「Missing required top-level field version」。 — sellers.json はトップレベルで sellers[] と並んで文字列の version フィールド(例: "1.0")を必要とします。追加してください — sellers 配列だけでは不十分です。
- confidential な seller が name や domain の欠落で指摘される。 — name と domain は、その seller で is_confidential = 1 の場合にのみ任意です。is_confidential を 1 に設定して省くか、両フィールドを指定してください。
- 値が正しく見えるのに seller_type が拒否される。 — 有効なのは PUBLISHER、INTERMEDIARY、BOTH のみ(大文字小文字を区別しない)です。RESELLER、SSP、EXCHANGE のような値は仕様に含まれず失敗します。
- 別物と思う id で「Duplicate seller_id」。 — seller_id は文字列として比較されるので、1001 と "1001" は衝突します。各 seller_id はファイル内で一意でなければなりません — 番号を振り直すかエントリを重複排除してください。
よくある質問
- sellers.json バリデーターは何を確認しますか?
- 必須のトップレベル version と sellers[] 配列を確認し、次にすべての seller が一意な seller_id、PUBLISHER・INTERMEDIARY・BOTH のいずれかの seller_type、そして seller が confidential でない限り name と domain を持つことを確認し、各問題をそのインデックスと seller_id とともに指摘します。
- seller はいつ name と domain を省けますか?
- その seller が is_confidential = 1 を設定する場合のみです。sellers.json 仕様は confidential なアカウントに name と domain を隠すことを許可するので、バリデーターはそれらのエントリで name/domain 要件をスキップし、サマリーで別途カウントします。
- sellers.json でどの seller_type 値が有効ですか?
- PUBLISHER(在庫を所有)、INTERMEDIARY(別アカウントの在庫を再販)、BOTH です。チェックは大文字小文字を区別しないので publisher と PUBLISHER はどちらも通りますが、RESELLER などの他の文字列は無効な seller_type として報告されます。
- なぜ seller_id が重複として報告されるのですか?
- 各 seller_id は単一の sellers.json ファイル内で一意でなければなりません。バリデーターは比較前に id を文字列に正規化するので、数値の 1001 と文字列の "1001" は同じ ID として扱われ、2 番目の出現が最初への参照とともに指摘されます。
- バリデーターは URL から私の sellers.json をフェッチしますか?
- いいえ。リモート URL や広告エンドポイントをフェッチすることは決してありません。ドキュメントのテキストを貼り付けると、デバイス上で解析・検証されるので、ファイルに関する情報が ArrayKit やどのサードパーティにもアップロードされることはありません。
関連ツール
すべての ArrayKit ツール