ads.txt / app-ads.txt バリデーター
ads.txt または app-ads.txt ファイルを 1 行ずつブラウザ内で検証します。貼り付けたファイルはデバイス上に留まります。
ads.txt / app-ads.txt バリデーターは、すべてブラウザ内で動作します。貼り付けたファイルはデバイス上で解析・確認され、ArrayKit にアップロードされることも、リモート URL からフェッチされることもありません。
sellers.json バリデーターを開く
ads.txt バリデーター について
ads.txt / app-ads.txt バリデーターは、貼り付けた瞬間に Authorized Digital Sellers ファイルをリントします。すべての行を辿り、DATA レコードをカンマ区切りのフィールドに分割し、それぞれが必須の 3 または 4 フィールド — 広告システムのドメイン、パブリッシャーアカウント id、DIRECT または RESELLER 関係、TAG-ID のような任意の認証局 id — を持つことを確認します。コメントと空行はスキップされ、OWNERDOMAIN、CONTACT、SUBDOMAIN、MANAGERDOMAIN、INVENTORYPARTNERDOMAIN のような VARIABLE 行が解析され、誤ったフィールド数、不正な関係値、重複エントリ、余分な空白が行番号と推奨修正とともに指摘されます。サマリーが DIRECT と RESELLER のレコード数、ユニークな販売者ドメイン数を集計します。パブリッシャーと広告オペレーションチームは、ファイルをサードパーティのクローラーに送ることなくここで監査できます — すべてのチェックはデバイス上で動作します。
機能
- 各 DATA レコードがちょうど 3 または 4 のカンマ区切りフィールドを持つことを検証
- 関係フィールドが DIRECT または RESELLER であることを確認し、大文字小文字を正規化
- VARIABLE 行を解析: CONTACT、SUBDOMAIN、OWNERDOMAIN、MANAGERDOMAIN、INVENTORYPARTNERDOMAIN
- ads.txt クローラーと同じようにコメント(#)と空行をスキップ
- 重複する販売者レコードを指摘し、最初に現れた行に遡って示す
- 余分な空白パディングや、ドメインらしくない広告システムフィールドを警告
- DIRECT と RESELLER の数、ユニークな販売者ドメイン数を要約
- ファイルをすべてブラウザ内で解析 — 貼り付けた内容はアップロードされません
ads.txt バリデーター の使い方
- ads.txt または app-ads.txt ファイルを貼り付けるか、サンプルを読み込んで形式を確認する
- 判定バナーでエラーと警告の件数を読む
- Findings を開き、推奨修正を使って指摘された各行を直す
- DIRECT、RESELLER、ユニークドメインのサマリー数を確認する
例
入力
google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0
appnexus.com, 3456, RESELLER
badexchange.com, 99, PARTNER
出力
2 records valid
Line 3 — Relationship must be DIRECT or RESELLER (found "PARTNER").
3 番目のフィールドは DIRECT または RESELLER でなければならず、PARTNER は拒否されます。
よくあるエラーとトラブルシューティング
- 完全に見える行で「Expected 3 or 4 fields」が出る。 — フィールドはカンマ区切りであり、スペースやタブ区切りではありません。ドメイン、アカウント id、関係の間にカンマを置き、余分な末尾フィールドを削除してください。
- 関係が DIRECT と読めるのにレコードが指摘される。 — 余分な文字や誤ったキーワードがないか確認してください — 有効なのは DIRECT と RESELLER のみです。小文字の direct/reseller は受け付けられますが、正規化できるようバリデーターは警告します。
- TAG-ID のみが異なる行で重複警告が出る。 — 重複検出はドメイン、アカウント id、関係を使います。同じ販売者タプルを持つ 2 行は、認証局 id が異なっても重複です — 1 つだけ残してください。
- サブドメインの販売者がバイヤーに拾われていない。 — 各委譲サブドメインを SUBDOMAIN=sub.example.com という variable 行で宣言し、クローラーがそのサブドメイン自身の ads.txt を取得するよう知らせてください。
よくある質問
- ads.txt バリデーターは各行で何を確認しますか?
- すべての DATA レコードについて、3 または 4 のカンマ区切りフィールド — 広告システムのドメイン、パブリッシャーアカウント id、DIRECT または RESELLER 関係、任意の認証局 id — があることを検証し、誤ったフィールド数、不正な関係値、重複、余分な空白を行番号とともに指摘します。
- ads.txt における DIRECT と RESELLER の違いは何ですか?
- DIRECT は、パブリッシャーがその広告システムと直接のアカウントを持ち、販売者関係を管理していることを意味します。RESELLER は、認定パートナーが自身のアカウントを通じて在庫を再販することを意味します。3 番目のフィールドはこの 2 つのキーワードのいずれかちょうど 1 つでなければなりません。
- このバリデーターは app-ads.txt でも機能しますか?
- はい。app-ads.txt は ads.txt と同じレコード文法 — 同じ DATA レコードフィールドと VARIABLE 宣言 — を使うので、どちらのファイルを貼り付けても同じチェックが適用されます。app-ads.txt は単に、アプリストア掲載の開発者ドメインに置かれます。
- OWNERDOMAIN のような VARIABLE 行はどう扱われますか?
- KEY=value として書かれた行は、販売者レコードではなく variable として解析されます。バリデーターは CONTACT、SUBDOMAIN、OWNERDOMAIN、MANAGERDOMAIN、INVENTORYPARTNERDOMAIN を認識し、未知のキーを警告し、値のない variable を指摘します。
- ads.txt の重複レコードとは何ですか?
- 同じ広告システムのドメイン、パブリッシャーアカウント id、関係を持つ 2 つのレコード — ドメインは大文字小文字を区別せず比較 — は、一方が認証局 id を追加していても重複です。バリデーターはレコードが最初に現れた行を示すので、繰り返しを削除できます。
- 検証時に私の ads.txt ファイルはアップロードされますか?
- いいえ。バリデーターはファイルをデバイス上で解析・確認し、リモートの ads.txt URL や広告タグをフェッチすることはありません。貼り付けた内容が ArrayKit やどのクローラーにも送られることはありません。
関連ツール
すべての ArrayKit ツール