AdMob オープンアプリ広告の頻度設計 — 復帰時の体感ストレスを抑えながら eCPM を取りに行く運用メモ

// hooks/useAppOpenAd.ts
import { useEffect, useRef, useState } from "react";
import { AppState, AppStateStatus } from "react-native";
import { AppOpenAd, AdEventType, TestIds } from "react-native-google-mobile-ads";
import { useRemoteConfig } from "./useRemoteConfig";
import { useSession } from "./useSession";
 
type AdState = "idle" | "loading" | "loaded" | "showing" | "error";
 
export function useAppOpenAd() {
  const { minInterval, coldStartSkip, modalRefs } = useRemoteConfig();
  const { lastShownAt, lastDismissedExternalAt, sessionStartedAt } = useSession();
  const [state, setState] = useState<AdState>("idle");
  const adRef = useRef<AppOpenAd | null>(null);
 
  // 初回ロード
  useEffect(() => {
    const ad = AppOpenAd.createForAdRequest(
      __DEV__ ? TestIds.APP_OPEN : "ca-app-pub-XXXXXXXX/YYYYYYYY",
      { requestNonPersonalizedAdsOnly: false, keywords: ["wallpaper", "lifestyle"] }
    );
    adRef.current = ad;
    ad.addAdEventListener(AdEventType.LOADED, () => setState("loaded"));
    ad.addAdEventListener(AdEventType.ERROR, () => setState("error"));
    ad.load();
    setState("loading");
  }, []);
 
  // フォアグラウンド復帰で表示判定
  useEffect(() => {
    const sub = AppState.addEventListener("change", (s: AppStateStatus) => {
      if (s !== "active") return;
      if (!adRef.current || state !== "loaded") return;
 
      // ルール1: コールドスタート初回はスキップ
      if (coldStartSkip && Date.now() - sessionStartedAt < 3000) return;
      // ルール2: 最小間隔
      if (Date.now() - lastShownAt < minInterval * 1000) return;
      // ルール3: モーダル復帰スキップ（写真ライブラリ等の外部UIから戻ったとき）
      if (Date.now() - lastDismissedExternalAt < 5000) return;
 
      adRef.current.show();
      setState("showing");
    });
    return () => sub.remove();
  }, [state, minInterval, coldStartSkip, lastShownAt, lastDismissedExternalAt]);
 
  return { state };
}

// hooks/useRemoteConfig.ts
import remoteConfig from "@react-native-firebase/remote-config";
import { useEffect, useState } from "react";
 
const DEFAULTS = {
  app_open_min_interval_sec: 120,
  app_open_cold_start_skip: true,
  app_open_modal_skip_window_ms: 5000,
  app_open_enabled: true,
};
 
export function useRemoteConfig() {
  const [config, setConfig] = useState(DEFAULTS);
  useEffect(() => {
    (async () => {
      await remoteConfig().setDefaults(DEFAULTS);
      await remoteConfig().setConfigSettings({ minimumFetchIntervalMillis: 3600 * 1000 });
      await remoteConfig().fetchAndActivate();
      setConfig({
        app_open_min_interval_sec: remoteConfig().getNumber("app_open_min_interval_sec"),
        app_open_cold_start_skip: remoteConfig().getBoolean("app_open_cold_start_skip"),
        app_open_modal_skip_window_ms: remoteConfig().getNumber("app_open_modal_skip_window_ms"),
        app_open_enabled: remoteConfig().getBoolean("app_open_enabled"),
      });
    })();
  }, []);
  return {
    minInterval: config.app_open_min_interval_sec,
    coldStartSkip: config.app_open_cold_start_skip,
    modalRefs: config.app_open_modal_skip_window_ms,
    enabled: config.app_open_enabled,
  };
}

// hooks/useSession.ts
import { create } from "zustand";
 
interface SessionState {
  sessionStartedAt: number;
  lastShownAt: number;
  lastDismissedExternalAt: number;
  markExternalShown: () => void;
  markAdShown: () => void;
}
 
export const useSession = create<SessionState>((set) => ({
  sessionStartedAt: Date.now(),
  lastShownAt: 0,
  lastDismissedExternalAt: 0,
  markExternalShown: () => set({ lastDismissedExternalAt: Date.now() }),
  markAdShown: () => set({ lastShownAt: Date.now() }),
}));

import * as ImagePicker from "expo-image-picker";
import { useSession } from "./hooks/useSession";
 
export async function pickWallpaper() {
  const { markExternalShown } = useSession.getState();
  markExternalShown();
  return await ImagePicker.launchImageLibraryAsync({ mediaTypes: ImagePicker.MediaTypeOptions.Images });
}