起動広告が、背面から戻った回にしか出ていませんでした。「前面に戻った」合図が、読み込みより先に過ぎていたためです

// app-open-gate.test.ts — 実行: node --test app-open-gate.test.ts
import { test } from "node:test";
import assert from "node:assert/strict";
import { AppOpenGate, COOLDOWN_MS, OPPORTUNITY_WINDOW_MS } from "./app-open-gate.ts";
 
function setup() {
  let t = 0;
  let shown = 0;
  const gate = new AppOpenGate(() => { shown += 1; }, () => t);
  return { gate, advance: (ms: number) => { t += ms; }, shown: () => shown };
}
 
// 旧実装の再現: 「復帰した」合図でだけ、読み込み済みなら出す
class NaiveGate {
  loaded = false;
  shown = 0;
  onLoaded() { this.loaded = true; }
  onReturn() { if (this.loaded) { this.shown += 1; this.loaded = false; } }
}
 
test("旧実装: 起動直後に読み込みが終わっても、復帰の合図が来ないので一度も出ない", () => {
  const naive = new NaiveGate();
  naive.onLoaded(); // 起動して1.2秒後に読み込み完了。復帰の合図はまだ一度も来ていない
  assert.equal(naive.shown, 0);
});
 
test("起動から機会の期限内に読み込みが終われば、一度だけ出る", () => {
  const { gate, advance, shown } = setup();
  advance(1_200);
  gate.onLoaded();
  gate.tick();
  assert.equal(shown(), 1);
});
 
test("読み込みが期限に間に合わなければ、その起動では出さず、あとからも不意に出さない", () => {
  const { gate, advance, shown } = setup();
  advance(OPPORTUNITY_WINDOW_MS + 1);
  gate.onLoaded();
  advance(60_000);
  gate.tick();
  assert.equal(shown(), 0);
});
 
test("使っている最中に読み込みが終わっても出ない（復帰という機会が無い）", () => {
  const { gate, advance, shown } = setup();
  advance(OPPORTUNITY_WINDOW_MS + 1);
  gate.tick(); // 起動の機会は期限切れ
  advance(120_000);
  gate.onLoaded();
  assert.equal(shown(), 0);
});
 
test("背面から戻り、広告が用意できていれば出る。クールダウン中の復帰では出ない", () => {
  const { gate, advance, shown } = setup();
  advance(1_000);
  gate.onLoaded(); // 起動時に1回目
  assert.equal(shown(), 1);
  gate.onClosed();
 
  advance(10_000);
  gate.onForeground(false);
  advance(5_000);
  gate.onLoaded(); // 閉じたあとに読み直した広告
  gate.onForeground(true); // クールダウン内の復帰
  assert.equal(shown(), 1);
 
  advance(COOLDOWN_MS);
  gate.onForeground(false);
  gate.onForeground(true); // クールダウンを過ぎてからの復帰
  assert.equal(shown(), 2);
});
 
test("復帰した1秒後に読み込みが終わる順でも出る", () => {
  const { gate, advance, shown } = setup();
  advance(OPPORTUNITY_WINDOW_MS + 1);
  gate.tick();
  advance(300_000);
  gate.onForeground(false);
  gate.onForeground(true);
  advance(1_000);
  gate.onLoaded();
  assert.equal(shown(), 1);
});
 
test("背面で起動された場合は、前面に来るまで出さない", () => {
  const { gate, advance, shown } = setup();
  gate.onForeground(false); // 背面で起動
  gate.onLoaded();
  advance(30_000);
  gate.tick();
  assert.equal(shown(), 0);
  gate.onForeground(true);
  assert.equal(shown(), 1);
});

// startAppOpenAd.ts — 接続の骨子。react-native-google-mobile-ads の AppOpenAd を使う想定です。
import { AppState } from "react-native";
import { AdEventType, AppOpenAd, TestIds } from "react-native-google-mobile-ads";
import { AppOpenGate } from "./app-open-gate";
 
// 開発中は必ずテスト用ユニット。本番の ID は環境変数から渡します
const UNIT_ID = __DEV__
  ? TestIds.APP_OPEN
  : (process.env.EXPO_PUBLIC_APP_OPEN_UNIT_ID ?? "YOUR_APP_OPEN_UNIT_ID");
 
let ad = AppOpenAd.createForAdRequest(UNIT_ID);
let needsReload = false; // 直前の読み込みが失敗したか
const gate = new AppOpenGate(() => ad.show());
 
function load(): void {
  ad = AppOpenAd.createForAdRequest(UNIT_ID);
  ad.addAdEventListener(AdEventType.LOADED, () => gate.onLoaded());
  ad.addAdEventListener(AdEventType.CLOSED, () => {
    gate.onClosed();
    load(); // 広告は使い切り。閉じたら次を用意する
  });
  ad.addAdEventListener(AdEventType.ERROR, () => {
    gate.onClosed();
    needsReload = true; // その場で読み直さない。次の復帰まで待てば、失敗が続いても無限ループにならない
  });
  ad.load();
}
 
export function startAppOpenAd(): () => void {
  gate.onForeground(AppState.currentState === "active"); // 背面で起動されたなら、前面に来るまで待たせる
  load();
 
  const sub = AppState.addEventListener("change", (state) => {
    gate.onForeground(state === "active");
    if (state === "active" && needsReload) {
      needsReload = false;
      load();
    }
  });
  const timer = setInterval(() => gate.tick(), 1_000); // 何も起きないまま機会が切れるのを拾う
 
  return () => {
    sub.remove();
    clearInterval(timer);
  };
}

// launch-trace.ts — 起動順を、起動からの経過時間つきでログに残す
const t0 = performance.now();
 
export function trace(label: string): void {
  console.log(`[launch +${Math.round(performance.now() - t0)}ms] ${label}`);
}
 
// 使う場所の例:
//   trace("前面に来た")             ← AppState の購読を始めた直後に、現在の状態と一緒に
//   trace("広告の読み込みを開始")    ← ad.load() の直前
//   trace("広告の読み込みが完了")    ← LOADED のリスナー内
//   trace("広告を表示")             ← show() の直前（理由として launch か return かも添える）