Rork アプリの収益設計 — 広告と課金が食い合う地点をどう避けるか

// アプリ全体で唯一の判定元
import Purchases, { CustomerInfo } from "react-native-purchases";
 
const ENTITLEMENT_ID = "premium";
 
export function useEntitlement() {
  const [isPremium, setIsPremium] = useState(false);
  const [ready, setReady] = useState(false);
 
  useEffect(() => {
    const apply = (info: CustomerInfo) => {
      // プラン名（monthly / annual / lifetime / campaign）を一切見ない。
      // どのプランで得た権利かはダッシュボード側の関心事。
      setIsPremium(info.entitlements.active[ENTITLEMENT_ID] !== undefined);
      setReady(true);
    };
 
    Purchases.getCustomerInfo().then(apply).catch(() => setReady(true));
    Purchases.addCustomerInfoUpdateListener(apply);
  }, []);
 
  // ready を返すのが重要。判定前に広告を出すと、
  // 課金済みユーザーに一瞬だけ広告が見えてレビューで叩かれる。
  return { isPremium, ready };
}

// 起動時に静かに復元を試みる（UI を出さない）
async function silentRestore() {
  try {
    const info = await Purchases.restorePurchases();
    return info.entitlements.active[ENTITLEMENT_ID] !== undefined;
  } catch {
    // 失敗しても無音。ユーザーにエラーを見せる場面ではない
    return false;
  }
}

// Cloudflare Workers での Webhook 受信例
export default {
  async fetch(request: Request, env: Env) {
    const auth = request.headers.get("Authorization");
    if (auth !== `Bearer ${env.REVENUECAT_WEBHOOK_SECRET}`) {
      return new Response("unauthorized", { status: 401 });
    }
 
    const { event } = await request.json();
 
    // 権利の付与・剥奪に関わるイベントだけを扱う
    const GRANT = ["INITIAL_PURCHASE", "RENEWAL", "UNCANCELLATION", "PRODUCT_CHANGE"];
    const REVOKE = ["EXPIRATION", "BILLING_ISSUE"];
 
    const key = `entitlement:${event.app_user_id}`;
 
    if (GRANT.includes(event.type)) {
      await env.KV.put(key, JSON.stringify({
        active: true,
        expires_at: event.expiration_at_ms,
      }), { expirationTtl: 60 * 60 * 24 * 40 });
    } else if (REVOKE.includes(event.type)) {
      await env.KV.delete(key);
    }
 
    // 未知のイベントも 200 を返す。500 を返すと RevenueCat が
    // リトライを続け、Webhook が無効化されることがある。
    return new Response("ok", { status: 200 });
  },
};

// 回数と時間の両方を条件にする
const MIN_ACTIONS = 5;
const MIN_INTERVAL_MS = 120_000; // 最低 2 分は空ける
const COLD_START_GRACE_MS = 90_000; // 起動後 90 秒は出さない
 
let actionCount = 0;
let lastAdAt = 0;
const launchedAt = Date.now();
 
function shouldShowInterstitial(moment: Moment, isPremium: boolean): boolean {
  if (!canShowInterstitial(moment, isPremium)) return false;
 
  const now = Date.now();
  if (now - launchedAt < COLD_START_GRACE_MS) return false; // 初回体験を守る
  if (now - lastAdAt < MIN_INTERVAL_MS) return false;
  if (++actionCount < MIN_ACTIONS) return false;
 
  actionCount = 0;
  lastAdAt = now;
  return true;
}

import { requestTrackingPermissionsAsync } from "expo-tracking-transparency";
 
// 価値を受け取った直後に、文脈を添えて聞く
async function askTrackingAfterFirstValue() {
  const shown = await AsyncStorage.getItem("att_asked");
  if (shown) return;
 
  // 事前説明を自前の画面で出してから、OS のダイアログへ
  // （OS のダイアログは一度きり。断られたら設定アプリからしか戻せない）
  await showPrePermissionSheet({
    title: "広告の表示について",
    body: "このアプリは広告収益で無料提供しております。関連性の高い広告を表示することで、無料でお使いいただける状態を維持できます。",
  });
 
  await requestTrackingPermissionsAsync();
  await AsyncStorage.setItem("att_asked", "1");
}

type UserSignals = {
  sessionsCount: number;      // 起動回数
  itemsAcquired: number;      // ダウンロード・保存した数
  daysSinceInstall: number;
  lastPaywallAt: number | null;
};
 
const PAYWALL_COOLDOWN_MS = 1000 * 60 * 60 * 24 * 3; // 3日
 
function shouldShowPaywall(s: UserSignals): boolean {
  // 価値を受け取った実績がないユーザーには出さない
  if (s.itemsAcquired < 3) return false;
 
  // 一度しか起動していない人はまだ判断材料がない
  if (s.sessionsCount < 2) return false;
 
  // 断った人に連日出さない（アンインストールの主因）
  if (s.lastPaywallAt && Date.now() - s.lastPaywallAt < PAYWALL_COOLDOWN_MS) {
    return false;
  }
 
  return true;
}

import analytics from "@react-native-firebase/analytics";
 
// ペイウォールは「表示」も必ず記録する。
// 購入イベントだけ取っていると、分母がないため転換率が出せない。
async function logPaywallShown(trigger: string, signals: UserSignals) {
  await analytics().logEvent("paywall_shown", {
    trigger,
    items_acquired: signals.itemsAcquired,
    sessions_count: signals.sessionsCount,
    days_since_install: signals.daysSinceInstall,
  });
}
 
async function logPurchase(plan: "monthly" | "annual", price: number) {
  await analytics().logPurchase({
    currency: "JPY",
    value: price,
    items: [{ item_id: `subscription_${plan}`, item_name: `${plan} subscription` }],
  });
}