Rork × AdMob UMP × ATT 同意管理の本番実装ガイド — グローバル配信で収益を落とさないための設計パターン

# UMP を含む AdMob SDK をインストール
npm install react-native-google-mobile-ads
 
# iOS の場合は Pod のインストールも必要
cd ios && pod install && cd ..

{
  "expo": {
    "plugins": [
      [
        "react-native-google-mobile-ads",
        {
          "androidAppId": "ca-app-pub-XXXXXXXXXXXXXXXX~YYYYYYYYYY",
          "iosAppId": "ca-app-pub-XXXXXXXXXXXXXXXX~ZZZZZZZZZZ",
          "userTrackingUsageDescription": "広告のパーソナライズとアプリの改善のために、端末の識別情報を使用させていただきます。"
        }
      ]
    ]
  }
}

// src/consent/initializeConsent.ts
import mobileAds, {
  AdsConsent,
  AdsConsentStatus,
  AdsConsentDebugGeography,
} from 'react-native-google-mobile-ads';
 
export type ConsentResult = {
  canRequestAds: boolean;
  consentStatus: AdsConsentStatus;
  isGDPRRegion: boolean;
  error?: string;
};
 
export async function initializeConsent(): Promise<ConsentResult> {
  try {
    // Step 1: 同意情報をリクエスト
    // __DEV__ では EEA ユーザーとしてデバッグする
    const consentInfo = await AdsConsent.requestInfoUpdate(
      __DEV__
        ? {
            debugGeography: AdsConsentDebugGeography.EEA,
            testDeviceIdentifiers: ['YOUR_TEST_DEVICE_ID'],
          }
        : undefined,
    );
 
    // Step 2: 必要に応じて同意フォームを表示
    if (
      consentInfo.isConsentFormAvailable &&
      consentInfo.status === AdsConsentStatus.REQUIRED
    ) {
      await AdsConsent.loadAndShowConsentFormIfRequired();
    }
 
    // Step 3: 広告リクエストが可能か判定
    const canRequestAds = await AdsConsent.getConsentInfo().then(
      (info) => info.canRequestAds ?? false,
    );
 
    return {
      canRequestAds,
      consentStatus: consentInfo.status,
      isGDPRRegion:
        consentInfo.status === AdsConsentStatus.REQUIRED ||
        consentInfo.status === AdsConsentStatus.OBTAINED,
    };
  } catch (error) {
    // ネットワーク切断などで同意情報取得に失敗した場合
    // フェイルクローズ（広告配信を停止）ではなく、
    // 前回の同意状態でフォールバックするのが Google 推奨パターン
    console.error('[Consent] Failed to initialize:', error);
    return {
      canRequestAds: false,
      consentStatus: AdsConsentStatus.UNKNOWN,
      isGDPRRegion: false,
      error: error instanceof Error ? error.message : 'Unknown error',
    };
  }
}

// src/consent/requestATT.ts
import { Platform } from 'react-native';
import {
  request,
  PERMISSIONS,
  RESULTS,
  check,
} from 'react-native-permissions';
 
export async function requestATTIfNeeded(): Promise<boolean> {
  if (Platform.OS !== 'ios') {
    return true; // Android は ATT 不要
  }
 
  // iOS 14.5 未満は ATT API 自体がない
  const iosVersion = parseFloat(Platform.Version as string);
  if (iosVersion < 14.5) {
    return true;
  }
 
  try {
    // まず現在の状態をチェック（再表示を避ける）
    const currentStatus = await check(PERMISSIONS.IOS.APP_TRACKING_TRANSPARENCY);
    if (currentStatus === RESULTS.GRANTED) return true;
    if (currentStatus === RESULTS.DENIED) return false;
    if (currentStatus === RESULTS.BLOCKED) return false;
 
    // まだ未確定なら表示
    const result = await request(PERMISSIONS.IOS.APP_TRACKING_TRANSPARENCY);
    return result === RESULTS.GRANTED;
  } catch (error) {
    console.error('[ATT] Request failed:', error);
    return false;
  }
}

// src/consent/regionAware.ts
import { AdsConsent, AdsConsentStatus } from 'react-native-google-mobile-ads';
 
export async function isLikelyGDPRRegion(): Promise<boolean> {
  const info = await AdsConsent.getConsentInfo();
  // REQUIRED = 同意が必要な地域（EEA/UK/スイス）
  // OBTAINED = 同意取得済み（同意が必要な地域だが既に回答済み）
  // NOT_REQUIRED = 同意不要（非 EEA）
  return (
    info.status === AdsConsentStatus.REQUIRED ||
    info.status === AdsConsentStatus.OBTAINED
  );
}

// src/consent/propagateConsent.ts
import analytics from '@react-native-firebase/analytics';
import Purchases from 'react-native-purchases';
import { AdsConsent } from 'react-native-google-mobile-ads';
 
export async function propagateConsent(): Promise<void> {
  const consentInfo = await AdsConsent.getConsentInfo();
  const canTrack = consentInfo.canRequestAds ?? false;
 
  // Firebase Analytics の同意モード
  // これを呼ばないと EEA ユーザーに対して勝手にデータ収集してしまう
  await analytics().setAnalyticsCollectionEnabled(canTrack);
  await analytics().setConsent({
    ad_storage: canTrack ? 'granted' : 'denied',
    ad_user_data: canTrack ? 'granted' : 'denied',
    ad_personalization: canTrack ? 'granted' : 'denied',
    analytics_storage: canTrack ? 'granted' : 'denied',
  });
 
  // RevenueCat の属性収集も同意に基づいて制御
  await Purchases.setAttributes({
    $consentGiven: canTrack ? 'true' : 'false',
  });
 
  if (!canTrack) {
    // 同意がない場合は IDFA 系の属性をクリア
    await Purchases.collectDeviceIdentifiers(); // 内部で null に設定
  }
}

// src/screens/SettingsScreen.tsx
import React from 'react';
import { View, Text, Button, Alert } from 'react-native';
import { AdsConsent, AdsConsentStatus } from 'react-native-google-mobile-ads';
 
export function PrivacySettingsSection() {
  const [isLoading, setIsLoading] = React.useState(false);
 
  const handleRevokeConsent = async () => {
    setIsLoading(true);
    try {
      // 同意状態をリセット
      await AdsConsent.reset();
      // 再取得を促す
      await AdsConsent.requestInfoUpdate();
 
      const info = await AdsConsent.getConsentInfo();
      if (
        info.isConsentFormAvailable &&
        info.status === AdsConsentStatus.REQUIRED
      ) {
        // 同意フォームを再表示
        await AdsConsent.loadAndShowConsentFormIfRequired();
      }
 
      Alert.alert(
        '同意設定を更新しました',
        'アプリを再起動すると新しい設定が完全に反映されます。',
      );
    } catch (error) {
      Alert.alert(
        'エラー',
        '同意設定の更新に失敗しました。ネットワーク接続をご確認の上、もう一度お試しください。',
      );
    } finally {
      setIsLoading(false);
    }
  };
 
  return (
    <View style={{ padding: 16 }}>
      <Text style={{ fontSize: 16, fontWeight: '600' }}>プライバシー設定</Text>
      <Text style={{ marginTop: 8, color: '#666' }}>
        広告のパーソナライズに関する同意を変更できます。
      </Text>
      <Button
        title={isLoading ? '処理中...' : '同意設定を変更する'}
        onPress={handleRevokeConsent}
        disabled={isLoading}
      />
    </View>
  );
}

// デバッグビルドのみに表示
{__DEV__ && (
  <Button
    title="[DEBUG] Reset Consent"
    onPress={async () => {
      await AdsConsent.reset();
      Alert.alert('Reset', 'Consent state cleared. Restart the app.');
    }}
  />
)}

// audit-data-safety.mjs
import { readFileSync, existsSync } from "node:fs";
 
// SDK 名 → Play「データセーフティ」で申告が必要になりやすいデータ種別
const SDK_DATA_TYPES = {
  "react-native-google-mobile-ads": ["Device or other IDs", "App interactions"],
  "@react-native-firebase/analytics": ["Device or other IDs", "App interactions"],
  "@react-native-firebase/crashlytics": ["Crash logs", "Diagnostics"],
  "react-native-purchases": ["Purchase history"],
  "expo-location": ["Approximate location", "Precise location"],
  "@amplitude/analytics-react-native": ["Device or other IDs", "App interactions"],
  "posthog-react-native": ["Device or other IDs", "App interactions"],
};
 
function readJson(path) {
  if (!existsSync(path)) return null;
  return JSON.parse(readFileSync(path, "utf8"));
}
 
const pkg = readJson("./package.json");
if (!pkg) {
  console.error("package.json が見つかりません。プロジェクト直下で実行してください。");
  process.exit(2);
}
 
const deps = Object.keys({ ...pkg.dependencies, ...pkg.devDependencies });
const required = new Map(); // データ種別 → 由来 SDK の配列
 
for (const dep of deps) {
  for (const type of SDK_DATA_TYPES[dep] ?? []) {
    if (!required.has(type)) required.set(type, []);
    required.get(type).push(dep);
  }
}
 
const declared = new Set(readJson("./data-safety.declared.json")?.declared ?? []);
const missing = [...required.keys()].filter((t) => !declared.has(t));
const extra = [...declared].filter((t) => !required.has(t));
 
console.log(`検出した SDK: ${deps.filter((d) => SDK_DATA_TYPES[d]).length} 件`);
for (const [type, sources] of required) {
  const mark = declared.has(type) ? "OK  " : "MISS";
  console.log(`  ${mark} ${type}  ← ${sources.join(", ")}`);
}
if (extra.length) console.log(`\n申告済みだが SDK 由来が見つからない項目: ${extra.join(", ")}`);
if (missing.length) {
  console.error(`\n申告漏れの可能性: ${missing.length} 件`);
  process.exit(1);
}
console.log("\n申告漏れは検出されませんでした。");

{
  "declared": ["Device or other IDs", "Crash logs", "Purchase history"]
}

検出した SDK: 5 件
  OK   Device or other IDs  ← react-native-google-mobile-ads, @react-native-firebase/analytics
  MISS App interactions  ← react-native-google-mobile-ads, @react-native-firebase/analytics
  OK   Crash logs  ← @react-native-firebase/crashlytics
  MISS Diagnostics  ← @react-native-firebase/crashlytics
  OK   Purchase history  ← react-native-purchases
  MISS Approximate location  ← expo-location
  MISS Precise location  ← expo-location
 
申告漏れの可能性: 4 件

# app.json / app.config.js 側の指定を確認する
grep -rn "targetSdkVersion\|compileSdkVersion" app.json app.config.js 2>/dev/null
 
# prebuild 済みなら生成された Gradle 側も確認する
grep -rn "targetSdkVersion" android/build.gradle android/app/build.gradle 2>/dev/null