広告を1つ出すだけのつもりでいたら、テストが1300件を超えて1回まわすのに15分以上かかるようになりました

（実況中継 No.8）

かずゆきです。

前回の記事

前回は絵と BGM と課金の回でした。最後に「次は App Store Connect への登録です」と書いたのですが、そちらは後回しになって、広告を入れる回になりました。

• 広告を出す判断と、広告の部品（SDK）を入れました

• 実機で7項目を確認しました。そのうち1つは、確認すべきことの前提が間違っていました

• 紹介ページ・プライバシーポリシー・サポート・お問い合わせフォームができて、公開しました

進め方は変わりません。設計書を Claude Code に書かせて、Codex にレビューさせて、実装させて、またレビューさせます。私は実機で遊んで、注文を出す係です。

広告の部品を、いきなり製品のアプリに入れませんでした

フェーズ9A では広告が1本も出ません。出す・出さないの判断だけを先に作りました。全画面の広告が割り込むと、その間だけゲームの画面の切り替えを保留する必要があります。部品と同時に書くと、実機でおかしくなったときに判断の誤りなのか部品の挙動なのかを切り分けられません。フェーズ7B とフェーズ7C で実際にそうなったのだそうです。

頻度の持ち方の話が面白いところでした。「6回に1回」を割り算の余りで判定すると、広告の在庫が無くて出せなかった回に候補が消えてしまいます。「次に出せるのは累計何回目か」で持つ形になりました。6回目に在庫が無ければ7回目で出して、次は10回目です。

フェーズ9B-1 で部品を入れます。ここで、製品のアプリには入れず、確認専用の別アプリを作ってそちらにだけ入れました。理由を聞いて納得しました。Google の広告の部品は、初期化を明示的に呼ばなくても、最初の広告の読み込みで起動します。初期化の呼び出しだけを塞いでも、読み込みまで届けば通信が走ります。製品のアプリに繋いだ時点で部品が製品の中に入ってしまい、「ログが出ない」ことは「通信していない」ことの証明になりません。

確かめたかったのは1つだけで、横画面で広告が崩れないかでした。設計書が「公開後に気づきやすい事故」として挙げていたところです。崩れませんでした。「閉じる」ボタンも切れていません。

そのうえで、フェーズ9A で作った判断の側には1行も触らずに実物の広告が出ています。広告の出来事を「出た」「報酬を得た」「閉じた」「出せなかった」の4つに割ってあったのが、部品の側の作りとそのまま噛み合いました。

フェーズ9B-2 は、まるごと「うまくいかないとき」の回でした

入ったのはこういうものです。

• 読み込みに失敗したら、2秒 → 5秒 → 15秒 → 30秒 → 1分 → 2分 → 5分と間隔を空けてやり直す

• 読み込んでから50分経った広告は捨てて取り直す

• 広告が出ているあいだは、効果音も BGM も振動も止める

やり直しの回数に上限を置くかどうかで、計画が1回ひっくり返っています。当初は「8回で打ち止め」と書いてありました。Codex の計画レビューで、打ち止めたぶんを戻す道が今の画面に無いと指摘が出ています。リワード広告のボタンは在庫が失敗のままだと押せませんし、割り込みの広告は在庫が無ければそもそも呼ばれません。戻せない上限はただの詰みなので、回数ではなく間隔のほうを5分で頭打ちにする形になりました。

音を止めるところも、思っていたより面倒でした。広告の画面が出るとき、アプリが背面に回ったという通知は必ずしも来ません。背面化の経路だけで止めていると、広告の音に BGM が重なります。しかも、広告と背面化が同時に起きたときに、片方が解けただけで音を戻してはいけません。止める理由を集合で持って、全部無くなったら戻す形になりました。振動も同じ扱いにしています。

このフェーズでは、Claude Code が自分で書いたテストで自分のバグを2つ掴んで、そのまま直しています。どちらも画面には何も出ないので、私が遊んでいても一生気づけません。

1つは、経過時間を差分の足し込みで数えていたせいで、丸め誤差でちょうどの境目が1フレームずれていたというものです。119フレームのあとの1フレームが 0.9999… にしかならず、120フレームちょうどが永遠に来ません。境目の両側を見るテストを書いていたので、そこで引っかかりました。

もう1つは Swift の書き方の落とし穴で、値を取り出して書き換えたつもりが、書き戻しが消えていました。状態も変わらずログにも出ないので、やり直しの待ち時間が永久に減らないだけです。これも Claude Code がテストで掴んで直しました。

書いたはずの約束が、テストの届かないところで抜けていました

Claude Code が書いたものを Codex がレビューして、6件の指摘が出ました。うち2件が本物のバグで、Claude Code がその場で直しています。

重いほうはこういうものです。読み込みのやり直しには通し番号を振ってあって、古い試行の成功が遅れて届いても、新しい広告を上書きしないようになっています。これは計画にはっきり書いてありました。ところが部品側の実装で番号を照らし合わせておらず、「記録の上では新しい広告なのに、実物は古い広告」という道が残っていました。

なぜ抜けたかというと、そこが確認専用アプリの中にあって、自動テストがまったく届かない場所だったからです。テストは全部通っていました。

同じレビューで、「書いてあるのに何も検査していないテスト」も3件見つかっています。二度呼んでも増えないことを確かめるテストが、二度目に実際には何もしていなかったもの。片方だけ捨てるはずが両方捨てても通ってしまうもの。BGM を戻す1行を消しても通る配線のテスト。どれも Claude Code が書いたテストで、Codex に言われて Claude Code が書き直しました。このシリーズで毎回書いている「テストを書いた」と「テストが誤りを検出できる」は別、という話が、また出てきたことになります。

そこでフェーズ9B-3b で、部品を製品のアプリのほうへ移しました。テストが届くようにするためです。ところが移すだけでは足りませんでした。広告の在庫が特定の型で、読み込みの呼び出しが型そのものに紐づいていて、照合部分が外から見えず、そもそもテストの中では広告を1つも作れません（通信が要るためです）。

計画の中心にあった前提が半分しか正しくなかった、と記録に書いてありました。結局、部品に触ってよいファイルを1つに固定して、その手前に部品と関係のない継ぎ目を作り、テストからは偽物を差し込む形になっています。ここでテストが19件増えました。

確認専用アプリはここで畳んでいます。

同意を確かめる前に、広告を要求してはいけません

フェーズ9B-3a です。EU 向けの同意管理（UMP）と、Apple の ATT を入れました。ここまで広告の既定は「何も出さない偽物」のままにしてありましたが、関門ができたので実物に切り替えています。

関門を一方通行で作ってはいけない、というのが今回の要でした。設定画面から同意を取り消せるので、許可 → 不許可は現実に起こります。止まらないと、読み込み済みの広告が残り、やり直しが回り続け、在庫があるのでボタンも押せてしまいます。許可の状態を持ち続けて、読み込みを始めるすべての入口で毎回見る形になりました。

判断の作りでいくつか細かい決めごとがあります。

• 「まだ問い合わせていない」と「問い合わせ中」を区別する必要がありました。どちらも「まだ」ですが、はい・いいえの2値では表せません

• 同意情報の更新に失敗しても「終わった」扱いにして、保存されている前回の値を見ます。失敗を不許可にすると、電波が悪いだけでその起動のあいだ広告が出なくなります

• 更新に失敗していたら、アプリを前面に戻したときにやり直します。成功していたらやり直しません

1つ、私が出した判断を撤回しています。広告の部品が持っている識別子の扱いで、はじめは「そのまま有効でよい」と答えました。Codex の2回目のレビューで、Apple の ATT が対象にしているのは IDFA という識別子だけではなくトラッキング全般だ、と指摘が出ました。「部品が IDFA を送らない」だけでは「トラッキングしていない」の説明になりません。ATT の許諾が下りるまで無効にする形へ直しました。

AdMob の管理画面の設定は私の担当でした。ここでいちばん大事だったのは、IDFA についてのメッセージを作らないことです。有効にすると管理画面の仕組みが自前で ATT のダイアログを出してしまい、フェーズ9A で作った説明画面と二重になります。

日本からだと同意フォームは出ないので、EEA にいることにして確認しました。計画には「テスト端末の ID を登録する必要がある」と書いてありましたが、部品の中の説明書きを読んだらシミュレータでは要らないと分かっています。日本語で、アプリ名とアイコン入りのフォームが出ました。「同意しない」を選ぶと、広告を1つも要求しません。

ここでも Codex のレビューで、すぐ直すべきものが3件出ました。3件とも「順番」の誤りで、Claude Code が全部直しています。同意を取り消したときに、状態を書き換えるより先に「読み込み済みの広告を捨てろ」と合図していて、捨てた側がその場で読み込み直すので、取り消した直後に古い許可のまま1本要求していたもの。アプリを前面に戻したとき、広告の再開が同意の取り直しより先に走っていて、iOS の設定でトラッキングを切って戻ると古い許諾のままやり直しが始まっていたもの。部品の初期化中に届いた ATT の変更が反映されないもの。どれも、遊んでいて気づける種類のものではありません。

設定画面はこれで11項目になりました。iPhone SE の横画面に収まるかどうかを、画面を見なくても検査できる形にしてあります。実際に確かめたら 8pt はみ出したので、この画面だけ行間を 8pt から 4pt に詰めています。

最後に Claude Code が、自分のコードにわざと間違いを16個仕込んで、テストが落ちるかを1つずつ確かめています。最初は3個が落ちませんでした。テスト側の偽物が古い呼び返しを消してしまう、といった穴が自分で見つかって、そこを塞いでから本番のコードに戻しています。私は結果の報告を読んでいるだけです。

実機で7項目を見て、1つは前提のほうが間違っていました

フェーズ3つぶんの実機確認が溜まっていたので、まとめて1回で見ました。iPhone 16 Pro です。

主眼のはずだったのは「広告の音と BGM が重なる」でした。これは私が実機を触っていて、起こりえないと言いました。全画面の広告はリザルト画面からしか出ませんし、リザルト画面では曲が止まっています。フェーズ9B-1 が積み残しとして書いていたのは、観察ではなく想定でした。

壊れたときに出る症状は「重なる」ではなく「戻ってこない」ほうです。止める理由が残ったままになると、そのあと曲が二度と鳴りません。確認の手順を書き直して、そちらを見ています。7項目とも通りました。

段取りで分かったことのほうが、読んでいて面白かったです。

• 機内モードの確認には USB ケーブルが要ります。無線だと接続が切れて、パソコンから端末を掴めず、起動時の引数を渡せません

• 本体の消音スイッチを解除しておきます。このゲームの音は他のアプリを邪魔しない分類なので、スイッチに従って全部消えます

• 割り込みの広告は毎回は出ません。6回目のゲームオーバーから、以後3回ごと、かつ前の全画面広告から90秒。知らないと不具合に見えます

オフラインで起動するとボタンが灰色になって、機内モードを解除してアプリに戻すと、再起動しないまま数秒で押せるようになりました。フェーズ9B-2 で入れたやり直しと、前面に戻ったときに待ち時間を切り上げる作りが効いています。

AdMob にプライバシーポリシーの URL を出せと言われました

同意フォームを作ろうとしたら、プライバシーポリシーの URL が必須でした。まだ存在しません。設計書ではフェーズ11 の予定でした。App Store の審査でもいずれ要るので、ここで前倒しになりました。

できたのは4つです。

• 紹介ページ

• プライバシーポリシー（AdMob へ渡す URL はこちら）

• サポートとよくある質問（App Store Connect で必須）

• お問い合わせフォーム

まよいびの子の紹介ページ として公開しました。ビルドの要らない素の HTML で、外から読み込む部品もほぼ入れていません（1つだけある例外は下に書きます）。プロトタイプのときと同じ方針です。

ゲームの画面写真は1枚も使っていません。ボタンやバージョン番号が写り込むためで、代わりに ChatGPT で作った元の一枚絵に、HTML で文字を重ねてあります。題字はアプリで使っているものと同じ画像を、絵の暗がりに溶ける形で乗せています。紹介文も新しく書き起こしていません。ゲームの中の「ものがたり」の文をそのまま置いてあります。

お問い合わせは、最初はメールアドレスをそのまま書いていました。あれは収集されて迷惑メールの宛先になるので、フォームに置き換えています。かといって外部のフォームサービスは使いません。使うと送信内容が第三者に渡って、「情報を集めません」というプライバシーポリシーの中身と食い違います。以前の別のアプリで使っているフォームを移してもらって、自分のサーバーから直接メールが届く形になりました。

中身は、人ではない送信元を弾く仕掛けがいくつかと、ヘッダの差し込みを防ぐ処理です。弾く経路4種類を実際に試して確かめたと書いてありました。自動返信は入れていません。入れると、任意のアドレスへメールを送れる経路になってしまうためです。1つだけ外部と通信する部品（Cloudflare の判定）を使っているので、その事実もプライバシーポリシーに書きました。あわせて「アプリの中では Cloudflare と通信しません」も書いています。

ここでも私から注文を出しています。「ものがたりの見え方が良くない」と言いました。狭い画面で絵の上に覆いをかけて無理に文字を読ませていて、絵が濁ったうえに、主人公の子が切れて見えなくなっていました。画面の広さで作りを変えて、広いときは絵を敷いて右の余白へ文字、狭いときは絵を絵として見せて文字はその下、という形になっています。

テストが1300件を超えました

フェーズ9A に着手した時点で1058件でした。今日の終わりで1304件です。1日で250件近く増えました。

タップして光を届けるだけのカジュアルなゲームで、テスト項目が1300件を超えました。自分でも驚いています。1件も私が書いたものではありません。全部 Claude Code が、何を守るのかを実装計画に書いてから書いたものです。

そのぶん、1回まわすのに15分以上かかるようになりました。書き換えるたびに待つので、1日で進む量が目に見えて落ちています。仕方がないところです。

広告を入れてみて、こういうテスト項目が必要なのか、と勉強になりました。読み込みに失敗したら何秒待ってやり直すか。同意を取り消されたら読み込み済みの広告をどうするか。広告の表示中にホームボタンで抜けて、また戻ってきたら音はどうなるか。どれも、遊んでいる人が気に留めることのない場所です。

息子が「意外とおもろいな。」と言ってくれました

テストプレイは中2の息子に頼んでいます。No.1 のときからずっとです。

今日遊んでいて、「意外とおもろいな。」と言われました。うれしかったです。

ハイスコアも更新してくれました。121600点です。

次は

フェーズ9B-4 です。広告の ID を本番のものに差し替えて、App Store の App Privacy を申告します。前回の宿題だった App Store Connect への登録も、まだ手つかずで残っています。

つづきます。

#まよいびの子 #個人開発 #ゲーム開発 #iOSアプリ開発 #Swift #SpriteKit #Xcode #ClaudeCode #Claude #Codex #生成AI #AIコーディング #開発日記 #制作日記 #プログラミング #エンジニア #ものづくり #アプリ開発 #スマホゲーム #インディーゲーム #広告 #AdMob #GoogleMobileAds #リワード広告 #インタースティシャル #UMP #GDPR #同意管理 #ATT #IDFA #トラッキング #プライバシーポリシー #プライバシー #AppPrivacy #SDK #リトライ #バックオフ #ユニットテスト #ミューテーションテスト #テスト自動化 #テスト設計 #コードレビュー #実機テスト #シミュレータ #XcodeGen #リファクタリング #依存関係 #ランディングページ #お問い合わせフォーム #PHP #iPhone #iOS #AppStore #ゲームアプリ #自作ゲーム #ひとり開発 #個人開発者 #週末開発 #副業 #ChatGPT #GPT5 #LLM #AI活用 #AIエージェント #AIとの共同作業 #ペアプログラミング #プロンプト #開発効率化 #失敗談 #振り返り #学び #気づき #継続は力なり #毎日note #note初心者 #創作 #親子 #子育て #中学生 #プログラミング教育