AdMob を入れている iOS アプリ Totteco で、管理画面に「app-ads.txt が見つかりません」の警告が出ていた。独自ドメインは持っておらず、アプリ紹介サイトは Cloudflare Pages の totteco.pages.dev に置いている。この *.pages.dev だけで app-ads.txt を通せるのか、というのが今回の話。結論は通せた。引っかかった箇所を残しておく。
app-ads.txt はどこを見られるか
app-ads.txt は広告枠の正規の販売者を宣言して不正在庫を防ぐ仕組みで、設置しないと配信・収益が制限されることがある。
クローラがファイルを探す起点は、公開中の App Store リスティングに載っているデベロッパー Web サイト URL のドメイン。そのドメインのルート直下（https://example.com/app-ads.txt）を見に行く。サブパスやランダムなサブドメインは見ない。
ここで疑問になるのが、totteco.pages.dev のような共有サブドメインを「ルートドメイン」として扱ってくれるのか、という点。
pages.dev は Public Suffix List に載っている
IAB の app-ads.txt 仕様では、ルートドメインの判定に Public Suffix List（PSL）を使う。pages.dev は Cloudflare が PSL に登録しているので、totteco.pages.dev 自体が登録可能ドメイン（eTLD+1）として扱われる。
仕様上、複数パートの公開サフィックスでは「公開サフィックスの直前のサブドメイン 1 つ」をルートとしてクロールする。pages.dev が公開サフィックスなので、デベロッパー URL が https://totteco.pages.dev なら、クローラは:
https://totteco.pages.dev/app-ads.txtを見に来る。つまり独自ドメインを買わなくても、*.pages.dev のルートに置けば成立する。www. / m. はクローラの探索対象から除外される点だけ注意（totteco. は該当しないので問題ない）。
Astro なら public/ に置くだけ
サイトは Astro。public/ 配下はビルドで dist/ のルートにそのままコピーされるので、置き場所は次の 1 箇所:
web/public/app-ads.txt中身は AdMob 管理画面の「アプリ → app-ads.txt」に出るコピペ用の行。1 ネットワーク（AdMob のみ）ならこれだけ:
google.com, pub-XXXXXXXXXXXXXXXX, DIRECT, f08c47fec0942fa0pub-XXXX...は自分のパブリッシャー ID。Info.plistのGADApplicationIdentifier（ca-app-pub-XXXX~YYYY）の~の前の数字部分がそれにあたるf08c47fec0942fa0は Google の認証局 ID（固定値）- メディエーションや他ネットワークを使っているなら、各社の行も追記する
SPA フォールバックに飲まれていないか確認する
ハマりやすいのがこれ。サイトが SPA 的なフォールバック（存在しないパスを index.html で返す）を持っていると、/app-ads.txt がテキストではなく HTML を返してしまい、クローラは「app-ads.txt ではない」と判断して失敗する。
静的アセットは普通フォールバックより優先されるので、置けば直る話ではあるが、配信結果は必ず実際の HTTP レスポンスで確認するのが確実。Content-Type: text/plain で中身が返ればOK:
$ curl -sIL https://totteco.pages.dev/app-ads.txt | grep -i content-type
content-type: text/plain; charset=utf-8
$ curl -sL https://totteco.pages.dev/app-ads.txt
google.com, pub-XXXXXXXXXXXXXXXX, DIRECT, f08c47fec0942fa0ブラウザで開いて中身が見えても、Content-Type が text/html だと弾かれることがあるので、ヘッダまで見ておく。
クロールは即時ではない
ファイルが正しく配信されていても、AdMob 側のクロールはすぐには走らない。確認したのは次の条件:
- App Store Connect のマーケティング URL が
https://totteco.pages.devになっている - AdMob のアプリが、その App Store のアプリ ID とリンク済みである（手動作成アプリのままだとストアの URL を辿れない）
- アプリが公開済みである（未公開だと参照する公開ストアページが無く、クロール先が定まらない）
この 3 つが揃っていれば、あとは待ち。管理画面から再クロールをリクエストできるが、反映は最大 24 時間〜数日かかる。今回は条件を満たした状態で待ったらステータスが「承認済み」に変わった。
まとめ
*.pages.devは PSL に載っているので、独自ドメインなしでも app-ads.txt を通せる- Astro なら
public/app-ads.txtを置くだけ、配信はContent-Type: text/plainで確認する - クロールはストアのデベロッパー URL 起点。リンク済み・公開済みを揃えて待つ