@apps-in-toss/native-modules 0.0.0-dev.1752049503789 → 1.0.0

package/src/AppsInTossModule/native-modules/ads/googleAdMob.ts

@@ -0,0 +1,690 @@
+import { noop } from 'es-toolkit';
+import type { AdMobFullScreenEvent, AdMobHandlerParams, InterstitialAd, RewardedAd } from './types';
+import { INTERNAL__appBridgeHandler } from '../../native-event-emitter/internal/appBridge';
+import { getOperationalEnvironment } from '../getOperationalEnvironment';
+import { isMinVersionSupported } from '../isMinVersionSupported';
+
+// MARK: Interstitial AD (load)
+
+export interface LoadAdMobInterstitialAdOptions {
+  /**
+   * 광고 단위 ID
+   */
+  adUnitId: string;
+}
+
+/**
+ * @public
+ * @category 광고
+ * @name LoadAdMobInterstitialAdEvent
+ * @description 전면 광고를 불러오는 함수에서 발생하는 이벤트 타입이에요. `loaded` 이벤트가 발생하면 광고를 성공적으로 불러온 거예요. 이때 [InterstitialAd](/react-native/reference/native-modules/광고/InterstitialAd.html) 객체가 함께 반환돼요.
+ */
+export type LoadAdMobInterstitialAdEvent =
+  | AdMobFullScreenEvent
+  | {
+      type: 'loaded';
+      data: InterstitialAd;
+    };
+
+/**
+ * @public
+ * @category 광고
+ * @name LoadAdMobInterstitialAdParams
+ * @description 전면 광고를 불러오는 함수에 필요한 옵션 객체예요.
+ */
+export type LoadAdMobInterstitialAdParams = AdMobHandlerParams<
+  LoadAdMobInterstitialAdOptions,
+  LoadAdMobInterstitialAdEvent
+>;
+
+/**
+ * @public
+ * @category 광고
+ * @name loadAdMobInterstitialAd
+ * @description 앱 화면 전체를 덮는 전면 광고를 미리 불러와서, 광고가 필요한 시점에 바로 보여줄 수 있도록 준비하는 함수예요.
+ * @param {LoadAdMobInterstitialAdParams} params 광고를 불러올 때 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
+ * @param {LoadAdMobInterstitialAdOptions} params.options 광고를 불러올 때 전달할 옵션 객체예요.
+ * @param {string} params.options.adUnitId 광고 단위 ID예요. 발급받은 전면 광고용 ID를 입력해요.
+ * @param {(event: LoadAdMobInterstitialAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고가 닫히거나 클릭됐을 때). 자세한 이벤트 타입은 [LoadAdMobInterstitialAdEvent](/react-native/reference/native-modules/광고/LoadAdMobInterstitialAdEvent.html)를 참고하세요.
+ * @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
+ * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+ *
+ * @example
+ * ### 버튼 눌러 불러온 전면 광고 보여주기
+ * ```tsx
+ * import { GoogleAdMob } from '@apps-in-toss/framework';
+ * import { useFocusEffect } from '@granite-js/native/@react-navigation/native';
+ * import { useNavigation } from '@granite-js/react-native';
+ * import { useCallback, useState } from 'react';
+ * import { Button, Text, View } from 'react-native';
+ *
+ * const AD_UNIT_ID = '<AD_UNIT_ID>';
+ *
+ * export function GoogleAdmobInterstitialAdExample() {
+ *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
+ *   const navigation = useNavigation();
+ *
+ *   const loadAd = useCallback(() => {
+ *     if (GoogleAdMob.loadAdMobInterstitialAd.isSupported() !== true) {
+ *       return;
+ *     }
+
+ *     const cleanup = GoogleAdMob.loadAdMobInterstitialAd({
+ *       options: {
+ *         adUnitId: AD_UNIT_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         switch (event.type) {
+ *           case 'loaded':
+ *             console.log('광고 로드 성공', event.data);
+ *             setAdLoadStatus('loaded');
+ *             break;
+ *
+ *           case 'clicked':
+ *             console.log('광고 클릭');
+ *             break;
+ *
+ *           case 'dismissed':
+ *             console.log('광고 닫힘');
+ *             navigation.navigate('/examples/google-admob-interstitial-ad-landing');
+ *             break;
+ *
+ *           case 'failedToShow':
+ *             console.log('광고 보여주기 실패');
+ *             break;
+ *
+ *           case 'impression':
+ *             console.log('광고 노출');
+ *             break;
+ *
+ *           case 'show':
+ *             console.log('광고 컨텐츠 보여졌음');
+ *             break;
+ *         }
+ *       },
+ *       onError: (error) => {
+ *         console.error('광고 불러오기 실패', error);
+ *       },
+ *     });
+ *
+ *     return cleanup;
+ *   }, [navigation]);
+ *
+ *   const showAd = useCallback(() => {
+ *     if (GoogleAdMob.showAdMobInterstitialAd.isSupported() !== true) {
+ *       return;
+ *     }
+ *
+ *     GoogleAdMob.showAdMobInterstitialAd({
+ *       options: {
+ *         adUnitId: AD_UNIT_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         switch (event.type) {
+ *           case 'requested':
+ *             console.log('광고 보여주기 요청 완료');
+ *             break;
+ *         }
+ *       },
+ *       onError: (error) => {
+ *         console.error('광고 보여주기 실패', error);
+ *       },
+ *     });
+ *   }, []);
+ *
+ *   useFocusEffect(loadAd);
+ *
+ *   return (
+ *     <View>
+ *       <Text>
+ *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
+ *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
+ *         {adLoadStatus === 'failed' && '광고 로드 실패'}
+ *       </Text>
+ *
+ *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export function loadAdMobInterstitialAd(params: LoadAdMobInterstitialAdParams) {
+  if (!loadAdMobInterstitialAd.isSupported()) {
+    params.onError(new Error(UNSUPPORTED_ERROR_MESSAGE));
+    return noop as () => void;
+  }
+
+  const { onEvent, onError, options } = params;
+
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod('loadAdMobInterstitialAd', options, {
+    onAdClicked: () => {
+      onEvent({ type: 'clicked' });
+    },
+    onAdDismissed: () => {
+      onEvent({ type: 'dismissed' });
+    },
+    onAdFailedToShow: () => {
+      onEvent({ type: 'failedToShow' });
+    },
+    onAdImpression: () => {
+      onEvent({ type: 'impression' });
+    },
+    onAdShow: () => {
+      onEvent({ type: 'show' });
+    },
+    onSuccess: (result: InterstitialAd) => onEvent({ type: 'loaded', data: result }),
+    onError,
+  });
+
+  return unregisterCallbacks;
+}
+
+// MARK: Interstitial AD (show)
+
+export interface ShowAdMobInterstitialAdOptions {
+  /**
+   * 광고 단위 ID
+   */
+  adUnitId: string;
+}
+
+/**
+ * @public
+ * @category 광고
+ * @name ShowAdMobInterstitialAdEvent
+ * @description 전면 광고를 보여주는 함수에서 발생하는 이벤트 타입이에요. `requested` 이벤트가 발생하면 광고 노출 요청이 Google AdMob에 성공적으로 전달된 거예요.
+ */
+export type ShowAdMobInterstitialAdEvent = { type: 'requested' };
+
+/**
+ * @public
+ * @category 광고
+ * @name ShowAdMobInterstitialAdParams
+ * @description 불러온 전면 광고를 보여주는 함수에 필요한 옵션 객체예요.
+ */
+export type ShowAdMobInterstitialAdParams = AdMobHandlerParams<
+  ShowAdMobInterstitialAdOptions,
+  ShowAdMobInterstitialAdEvent
+>;
+
+/**
+ * @public
+ * @category 광고
+ * @name showAdMobInterstitialAd
+ * @description 앱 화면 전체를 덮는 전면 광고를 사용자에게 노출해요. 이 함수는 `loadAdMobInterstitialAd` 로 미리 불러온 광고를 실제로 사용자에게 노출해요.
+ * @param {ShowAdMobInterstitialAdParams} params 광고를 보여주기 위해 사용할 설정 값이에요. 광고 ID와과 광고의 동작에 대한 콜백을 설정할 수 있어요.
+ * @param {ShowAdMobInterstitialAdOptions} params.options 광고를 보여줄 때 전달할 옵션 객체예요.
+ * @param {string} params.options.adUnitId 광고 단위 ID예요. `loadAdMobInterstitialAd` 로 불러온 전면 광고용 ID를 입력해요.
+ * @param {(event: ShowAdMobInterstitialAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고 노출을 요청했을 때). 자세한 이벤트 타입은 [ShowAdMobInterstitialAdEvent](/react-native/reference/native-modules/광고/ShowAdMobInterstitialAdEvent.html)를 참고하세요.
+ * @param {(reason: unknown) => void} [params.onError] 광고를 노출하지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
+ * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+ *
+ * @example
+ * ### 버튼 눌러 불러온 전면 광고 보여주기
+ * ```tsx
+ * import { GoogleAdMob } from '@apps-in-toss/framework';
+ * import { useFocusEffect } from '@granite-js/native/@react-navigation/native';
+ * import { useNavigation } from '@granite-js/react-native';
+ * import { useCallback, useState } from 'react';
+ * import { Button, Text, View } from 'react-native';
+ *
+ * const AD_UNIT_ID = '<AD_UNIT_ID>';
+ *
+ * export function GoogleAdmobInterstitialAdExample() {
+ *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
+ *   const navigation = useNavigation();
+ *
+ *   const loadAd = useCallback(() => {
+ *     if (GoogleAdMob.loadAdMobInterstitialAd.isSupported() !== true) {
+ *       return;
+ *     }
+
+ *     const cleanup = GoogleAdMob.loadAdMobInterstitialAd({
+ *       options: {
+ *         adUnitId: AD_UNIT_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         switch (event.type) {
+ *           case 'loaded':
+ *             console.log('광고 로드 성공', event.data);
+ *             setAdLoadStatus('loaded');
+ *             break;
+ *
+ *           case 'clicked':
+ *             console.log('광고 클릭');
+ *             break;
+ *
+ *           case 'dismissed':
+ *             console.log('광고 닫힘');
+ *             navigation.navigate('/examples/google-admob-interstitial-ad-landing');
+ *             break;
+ *
+ *           case 'failedToShow':
+ *             console.log('광고 보여주기 실패');
+ *             break;
+ *
+ *           case 'impression':
+ *             console.log('광고 노출');
+ *             break;
+ *
+ *           case 'show':
+ *             console.log('광고 컨텐츠 보여졌음');
+ *             break;
+ *         }
+ *       },
+ *       onError: (error) => {
+ *         console.error('광고 불러오기 실패', error);
+ *       },
+ *     });
+ *
+ *     return cleanup;
+ *   }, [navigation]);
+ *
+ *   const showAd = useCallback(() => {
+ *     if (GoogleAdMob.showAdMobInterstitialAd.isSupported() !== true) {
+ *       return;
+ *     }
+ *
+ *     GoogleAdMob.showAdMobInterstitialAd({
+ *       options: {
+ *         adUnitId: AD_UNIT_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         switch (event.type) {
+ *           case 'requested':
+ *             console.log('광고 보여주기 요청 완료');
+ *             break;
+ *         }
+ *       },
+ *       onError: (error) => {
+ *         console.error('광고 보여주기 실패', error);
+ *       },
+ *     });
+ *   }, []);
+ *
+ *   useFocusEffect(loadAd);
+ *
+ *   return (
+ *     <View>
+ *       <Text>
+ *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
+ *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
+ *         {adLoadStatus === 'failed' && '광고 로드 실패'}
+ *       </Text>
+ *
+ *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export function showAdMobInterstitialAd(params: ShowAdMobInterstitialAdParams) {
+  if (!showAdMobInterstitialAd.isSupported()) {
+    params.onError(new Error(UNSUPPORTED_ERROR_MESSAGE));
+    return noop as () => void;
+  }
+
+  const { onEvent, onError, options } = params;
+
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod('showAdMobInterstitialAd', options, {
+    onSuccess: () => onEvent({ type: 'requested' }),
+    onError,
+  });
+
+  return unregisterCallbacks;
+}
+
+// MARK: Rewarded AD (load)
+
+export interface LoadAdMobRewardedAdOptions {
+  /**
+   * 광고 단위 ID
+   */
+  adUnitId: string;
+}
+
+/**
+ * @public
+ * @category 광고
+ * @name LoadAdMobRewardedAdEvent
+ * @description 보상형 광고를 불러오는 함수에서 발생하는 이벤트 타입이에요. `loaded` 이벤트가 발생하면 광고를 성공적으로 불러온 거예요. 이때 [RewardedAd](/react-native/reference/native-modules/광고/RewardedAd.html) 객체가 함께 반환돼요. `userEarnedReward` 이벤트는 사용자가 광고를 끝까지 시청해, 보상 조건을 충족했을 때 발생해요.
+ */
+export type LoadAdMobRewardedAdEvent =
+  | AdMobFullScreenEvent
+  | { type: 'loaded'; data: RewardedAd }
+  | { type: 'userEarnedReward' };
+
+/**
+ * @public
+ * @category 광고
+ * @name LoadAdMobRewardedAdParams
+ * @description 보상형 광고를 불러오는 함수에 필요한 옵션 객체예요.
+ */
+export type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOptions, LoadAdMobRewardedAdEvent>;
+
+/**
+ * @public
+ * @category 광고
+ * @name loadAdMobRewardedAd
+ * @description 사용자가 광고를 끝까지 시청하면 리워드를 제공할 수 있는 보상형 광고를 미리 불러와서, 광고가 필요한 시점에 바로 보여줄 수 있도록 준비하는 함수예요.
+ * @param {LoadAdMobRewardedAdParams} params 광고를 불러올 때 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
+ * @param {LoadAdMobRewardedAdOptions} params.options 광고를 불러올 때 전달할 옵션 객체예요.
+ * @param {string} params.options.adUnitId 광고 단위 ID예요. 발급받은 보상형 광고용 ID를 입력해요.
+ * @param {(event: LoadAdMobRewardedAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고가 닫히거나 클릭됐을 때). 자세한 이벤트 타입은 [LoadAdMobRewardedAdEvent](/react-native/reference/native-modules/광고/LoadAdMobRewardedAdEvent.html)를 참고하세요.
+ * @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
+ * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+ *
+ * @example
+ *
+ * ### 버튼 눌러 불러온 보상형 광고 보여주기
+ *
+ * ```tsx
+ * import { GoogleAdMob } from '@apps-in-toss/framework';
+ * import { useCallback, useState } from 'react';
+ * import { Button, Text, View } from 'react-native';
+ *
+ * const AD_UNIT_ID = '<AD_UNIT_ID>';
+ *
+ * export function GoogleAdmobRewardedAdExample() {
+ *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
+ *
+ *   const loadAd = useCallback(() => {
+ *     if (GoogleAdMob.loadAdMobRewardedAd.isSupported() !== true) {
+ *       return;
+ *     }
+ *
+ *     const cleanup = GoogleAdMob.loadAdMobRewardedAd({
+ *       options: {
+ *         adUnitId: AD_UNIT_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         console.log(event.type);
+ *         switch (event.type) {
+ *           case 'loaded':
+ *             console.log('광고 로드 성공', event.data);
+ *             setAdLoadStatus('loaded');
+ *             break;
+ *
+ *           case 'clicked':
+ *             console.log('광고 클릭');
+ *             break;
+ *
+ *           case 'dismissed':
+ *             console.log('광고 닫힘');
+ *             break;
+ *
+ *           case 'failedToShow':
+ *             console.log('광고 보여주기 실패');
+ *             break;
+ *
+ *           case 'impression':
+ *             console.log('광고 노출');
+ *             break;
+ *
+ *           case 'show':
+ *             console.log('광고 컨텐츠 보여졌음');
+ *             break;
+ *
+ *           case 'userEarnedReward':
+ *             console.log('사용자가 광고 시청을 완료했음');
+ *             break;
+ *         }
+ *       },
+ *       onError: (error) => {
+ *         console.error('광고 불러오기 실패', error);
+ *       },
+ *     });
+ *
+ *     return cleanup;
+ *   }, []);
+ *
+ *   const showAd = useCallback(() => {
+ *     if (GoogleAdMob.showAdMobRewardedAd.isSupported() !== true) {
+ *       return;
+ *     }
+ *
+ *     GoogleAdMob.showAdMobRewardedAd({
+ *       options: {
+ *         adUnitId: AD_UNIT_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         switch (event.type) {
+ *           case 'requested':
+ *             console.log('광고 보여주기 요청 완료');
+ *             setAdLoadStatus('not_loaded');
+ *             break;
+ *         }
+ *       },
+ *       onError: (error) => {
+ *         console.error('광고 보여주기 실패', error);
+ *       },
+ *     });
+ *   }, []);
+ *
+ *   return (
+ *     <View>
+ *       <Text>
+ *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
+ *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
+ *         {adLoadStatus === 'failed' && '광고 로드 실패'}
+ *       </Text>
+ *
+ *       <Button title="Load Ad" onPress={loadAd} />
+ *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export function loadAdMobRewardedAd(params: LoadAdMobRewardedAdParams) {
+  if (!loadAdMobRewardedAd.isSupported()) {
+    params.onError(new Error(UNSUPPORTED_ERROR_MESSAGE));
+    return noop as () => void;
+  }
+
+  const { onEvent, onError, options } = params;
+
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod('loadAdMobRewardedAd', options, {
+    onAdClicked: () => {
+      onEvent({ type: 'clicked' });
+    },
+    onAdDismissed: () => {
+      onEvent({ type: 'dismissed' });
+    },
+    onAdFailedToShow: () => {
+      onEvent({ type: 'failedToShow' });
+    },
+    onAdImpression: () => {
+      onEvent({ type: 'impression' });
+    },
+    onAdShow: () => {
+      onEvent({ type: 'show' });
+    },
+    onUserEarnedReward: () => {
+      onEvent({ type: 'userEarnedReward' });
+    },
+    onSuccess: (result: RewardedAd) => onEvent({ type: 'loaded', data: result }),
+    onError,
+  });
+
+  return unregisterCallbacks;
+}
+
+// MARK: Rewarded AD (show)
+
+export interface ShowAdMobRewardedAdOptions {
+  /**
+   * 광고 단위 ID
+   */
+  adUnitId: string;
+}
+
+/**
+ * @public
+ * @category 광고
+ * @name ShowAdMobRewardedAdEvent
+ * @description 보상형 광고를 보여주는 함수에서 발생하는 이벤트 타입이에요. `requested` 이벤트가 발생하면 광고 노출 요청이 Google AdMob에 성공적으로 전달된 거예요.
+ */
+export type ShowAdMobRewardedAdEvent = { type: 'requested' };
+
+/**
+ * @public
+ * @category 광고
+ * @name ShowAdMobRewardedAdParams
+ * @description 불러온 보상형 광고를 보여주는 함수에 필요한 옵션 객체예요.
+ */
+export type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOptions, ShowAdMobRewardedAdEvent>;
+
+/**
+ * @public
+ * @category 광고
+ * @name showAdMobRewardedAd
+ * @description 사용자가 광고를 끝까지 보면 리워드를 받을 수 있도록, 보상형 광고를 화면에 보여줘요. 이 함수는 `loadAdMobRewardedAd` 로 미리 불러온 광고를 실제로 사용자에게 노출해요.
+ * @param {ShowAdMobRewardedAdParams} params 광고를 보여주기 위해 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
+ * @param {ShowAdMobRewardedAdOptions} params.options 광고를 보여줄 때 전달할 옵션 객체예요.
+ * @param {string} params.options.adUnitId 광고 단위 ID예요. `loadAdMobRewardedAd` 로 불러온 보상형 광고용 ID를 입력해요.
+ * @param {(event: ShowAdMobRewardedAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고 노출을 요청했을 때). 자세한 이벤트 타입은 [ShowAdMobRewardedAdEvent](/react-native/reference/native-modules/광고/ShowAdMobRewardedAdEvent.html)를 참고하세요.
+ * @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
+ * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+ *
+ * @example
+ * ### 버튼 눌러 불러온 보상형 광고 보여주기
+ *
+ * ```tsx
+ * import { GoogleAdMob } from '@apps-in-toss/framework';
+ * import { useCallback, useState } from 'react';
+ * import { Button, Text, View } from 'react-native';
+ *
+ * const AD_UNIT_ID = '<AD_UNIT_ID>';
+ *
+ * export function GoogleAdmobRewardedAdExample() {
+ *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
+ *
+ *   const loadAd = useCallback(() => {
+ *     if (GoogleAdMob.loadAdMobRewardedAd.isSupported() !== true) {
+ *       return;
+ *     }
+ *
+ *     const cleanup = GoogleAdMob.loadAdMobRewardedAd({
+ *       options: {
+ *         adUnitId: AD_UNIT_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         console.log(event.type);
+ *         switch (event.type) {
+ *           case 'loaded':
+ *             console.log('광고 로드 성공', event.data);
+ *             setAdLoadStatus('loaded');
+ *             break;
+ *
+ *           case 'clicked':
+ *             console.log('광고 클릭');
+ *             break;
+ *
+ *           case 'dismissed':
+ *             console.log('광고 닫힘');
+ *             break;
+ *
+ *           case 'failedToShow':
+ *             console.log('광고 보여주기 실패');
+ *             break;
+ *
+ *           case 'impression':
+ *             console.log('광고 노출');
+ *             break;
+ *
+ *           case 'show':
+ *             console.log('광고 컨텐츠 보여졌음');
+ *             break;
+ *
+ *           case 'userEarnedReward':
+ *             console.log('사용자가 광고 시청을 완료했음');
+ *             break;
+ *         }
+ *       },
+ *       onError: (error) => {
+ *         console.error('광고 불러오기 실패', error);
+ *       },
+ *     });
+ *
+ *     return cleanup;
+ *   }, []);
+ *
+ *   const showAd = useCallback(() => {
+ *     if (GoogleAdMob.showAdMobRewardedAd.isSupported() !== true) {
+ *       return;
+ *     }
+ *
+ *     GoogleAdMob.showAdMobRewardedAd({
+ *       options: {
+ *         adUnitId: AD_UNIT_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         switch (event.type) {
+ *           case 'requested':
+ *             console.log('광고 보여주기 요청 완료');
+ *             setAdLoadStatus('not_loaded');
+ *             break;
+ *         }
+ *       },
+ *       onError: (error) => {
+ *         console.error('광고 보여주기 실패', error);
+ *       },
+ *     });
+ *   }, []);
+ *
+ *   return (
+ *     <View>
+ *       <Text>
+ *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
+ *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
+ *         {adLoadStatus === 'failed' && '광고 로드 실패'}
+ *       </Text>
+ *
+ *       <Button title="Load Ad" onPress={loadAd} />
+ *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export function showAdMobRewardedAd(params: ShowAdMobRewardedAdParams) {
+  if (!showAdMobRewardedAd.isSupported()) {
+    params.onError(new Error(UNSUPPORTED_ERROR_MESSAGE));
+    return noop as () => void;
+  }
+
+  const { onEvent, onError, options } = params;
+
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod('showAdMobRewardedAd', options, {
+    onSuccess: () => onEvent({ type: 'requested' }),
+    onError,
+  });
+
+  return unregisterCallbacks;
+}
+
+// MARK: - isSupported
+
+const ANDROID_GOOGLE_AD_MOB_SUPPORTED_VERSION = '5.209.0';
+const IOS_GOOGLE_AD_MOB_SUPPORTED_VERSION = '5.209.0';
+const UNSUPPORTED_ERROR_MESSAGE = 'This feature is not supported in the current environment';
+const ENVIRONMENT = getOperationalEnvironment();
+
+function createIsSupported() {
+  return () => {
+    if (ENVIRONMENT !== 'toss') {
+      return false;
+    }
+
+    return isMinVersionSupported({
+      android: ANDROID_GOOGLE_AD_MOB_SUPPORTED_VERSION,
+      ios: IOS_GOOGLE_AD_MOB_SUPPORTED_VERSION,
+    });
+  };
+}
+
+loadAdMobInterstitialAd.isSupported = createIsSupported();
+loadAdMobRewardedAd.isSupported = createIsSupported();
+showAdMobInterstitialAd.isSupported = createIsSupported();
+showAdMobRewardedAd.isSupported = createIsSupported();