@apps-in-toss/native-modules 1.0.0 → 1.0.2

package/dist/index.js

@@ -433,6 +433,68 @@ loadAdMobRewardedAd.isSupported = createIsSupported();
 showAdMobInterstitialAd.isSupported = createIsSupported();
 showAdMobRewardedAd.isSupported = createIsSupported();
 
+// src/AppsInTossModule/native-modules/ads/googleAdMobV2.ts
+import { noop as noop2 } from "es-toolkit";
+function loadAppsInTossAdMob(params) {
+  if (!loadAppsInTossAdMob.isSupported()) {
+    params.onError(new Error(UNSUPPORTED_ERROR_MESSAGE2));
+    return noop2;
+  }
+  const { onEvent, onError, options } = params;
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod("loadAppsInTossAdmob", options, {
+    onSuccess: (result) => onEvent({ type: "loaded", data: result }),
+    onError
+  });
+  return unregisterCallbacks;
+}
+function showAppsInTossAdMob(params) {
+  if (!showAppsInTossAdMob.isSupported()) {
+    params.onError(new Error(UNSUPPORTED_ERROR_MESSAGE2));
+    return noop2;
+  }
+  const { onEvent, onError, options } = params;
+  const unregisterCallbacks = INTERNAL__appBridgeHandler.invokeAppBridgeMethod("showAppsInTossAdmob", options, {
+    onAdClicked: () => {
+      onEvent({ type: "clicked" });
+    },
+    onAdDismissed: () => {
+      onEvent({ type: "dismissed" });
+    },
+    onAdFailedToShow: () => {
+      onEvent({ type: "failedToShow" });
+    },
+    onAdImpression: () => {
+      onEvent({ type: "impression" });
+    },
+    onAdShow: () => {
+      onEvent({ type: "show" });
+    },
+    onUserEarnedReward: (data) => {
+      onEvent({ type: "userEarnedReward", data });
+    },
+    onSuccess: () => onEvent({ type: "requested" }),
+    onError
+  });
+  return unregisterCallbacks;
+}
+var ANDROID_GOOGLE_AD_MOB_SUPPORTED_VERSION2 = "5.227.0";
+var IOS_GOOGLE_AD_MOB_SUPPORTED_VERSION2 = "5.227.0";
+var UNSUPPORTED_ERROR_MESSAGE2 = "This feature is not supported in the current environment";
+var ENVIRONMENT2 = getOperationalEnvironment();
+function createIsSupported2() {
+  return () => {
+    if (ENVIRONMENT2 !== "toss") {
+      return false;
+    }
+    return isMinVersionSupported({
+      android: ANDROID_GOOGLE_AD_MOB_SUPPORTED_VERSION2,
+      ios: IOS_GOOGLE_AD_MOB_SUPPORTED_VERSION2
+    });
+  };
+}
+loadAppsInTossAdMob.isSupported = createIsSupported2();
+showAppsInTossAdMob.isSupported = createIsSupported2();
+
 // src/AppsInTossModule/native-modules/checkoutPayment.ts
 async function checkoutPayment(options) {
   return AppsInTossModule.checkoutPayment({ params: options });
@@ -683,7 +745,9 @@ var GoogleAdMob = {
   loadAdMobInterstitialAd,
   showAdMobInterstitialAd,
   loadAdMobRewardedAd,
-  showAdMobRewardedAd
+  showAdMobRewardedAd,
+  loadAppsInTossAdMob,
+  showAppsInTossAdMob
 };
 
 // src/BedrockModule/native-modules/natives/BedrockModule.ts

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/native-modules",
   "type": "module",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Native Modules for Apps In Toss",
   "scripts": {
     "prepack": "yarn build",
@@ -30,8 +30,8 @@
   ],
   "devDependencies": {
     "@babel/runtime": "^7",
-    "@granite-js/native": "0.1.20",
-    "@granite-js/react-native": "0.1.20",
+    "@granite-js/native": "0.1.21",
+    "@granite-js/react-native": "0.1.21",
     "@types/react": "18.3.3",
     "dts-bundle-generator": "^9.5.1",
     "esbuild": "0.25.5",
@@ -53,5 +53,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "1cf9898b323a17c789ff9f5d75e8c6ab68fe4a95"
+  "gitHead": "6bcca89699f84625d384052501b8ea0d28cabccc"
 }

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

@@ -41,16 +41,10 @@ export type LoadAdMobInterstitialAdParams = AdMobHandlerParams<
  * @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 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+ * @deprecated 이 함수는 더 이상 사용되지 않습니다. 대신 {@link GoogleAdMob.loadAppsInTossAdMob}를 사용해주세요.
  *
  * @example
- * ### 버튼 눌러 불러온 전면 광고 보여주기
+ * ### 버튼 눌러 불러온 광고 보여주기 (loadAppsInTossAdMob로 변경 예제)
  * ```tsx
  * import { GoogleAdMob } from '@apps-in-toss/framework';
  * import { useFocusEffect } from '@granite-js/native/@react-navigation/native';
@@ -58,20 +52,20 @@ export type LoadAdMobInterstitialAdParams = AdMobHandlerParams<
  * import { useCallback, useState } from 'react';
  * import { Button, Text, View } from 'react-native';
  *
- * const AD_UNIT_ID = '<AD_UNIT_ID>';
+ * const AD_GROUP_ID = '<AD_GROUP_ID>';
  *
- * export function GoogleAdmobInterstitialAdExample() {
+ * export function GoogleAdmobExample() {
  *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
  *   const navigation = useNavigation();
  *
  *   const loadAd = useCallback(() => {
- *     if (GoogleAdMob.loadAdMobInterstitialAd.isSupported() !== true) {
+ *     if (GoogleAdMob.loadAppsInTossAdMob.isSupported() !== true) {
  *       return;
  *     }
 
- *     const cleanup = GoogleAdMob.loadAdMobInterstitialAd({
+ *     const cleanup = GoogleAdMob.loadAppsInTossAdMob({
  *       options: {
- *         adUnitId: AD_UNIT_ID,
+ *         adGroupId: AD_GROUP_ID,
  *       },
  *       onEvent: (event) => {
  *         switch (event.type) {
@@ -79,27 +73,6 @@ export type LoadAdMobInterstitialAdParams = AdMobHandlerParams<
  *             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) => {
@@ -111,19 +84,45 @@ export type LoadAdMobInterstitialAdParams = AdMobHandlerParams<
  *   }, [navigation]);
  *
  *   const showAd = useCallback(() => {
- *     if (GoogleAdMob.showAdMobInterstitialAd.isSupported() !== true) {
+ *     if (GoogleAdMob.showAppsInTossAdMob.isSupported() !== true) {
  *       return;
  *     }
  *
- *     GoogleAdMob.showAdMobInterstitialAd({
+ *     GoogleAdMob.showAppsInTossAdMob({
  *       options: {
- *         adUnitId: AD_UNIT_ID,
+ *         adGroupId: AD_GROUP_ID,
  *       },
  *       onEvent: (event) => {
  *         switch (event.type) {
  *           case 'requested':
  *             console.log('광고 보여주기 요청 완료');
  *             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 'userEarnedReward':
+ *             console.log('광고 보상 획득 unitType:', event.data.unitType);
+ *             console.log('광고 보상 획득 unitAmount:', event.data.unitAmount);
+ *             break;
+ *
+ *           case 'show':
+ *             console.log('광고 컨텐츠 보여졌음');
+ *             break;
  *         }
  *       },
  *       onError: (error) => {
@@ -211,16 +210,10 @@ export type ShowAdMobInterstitialAdParams = AdMobHandlerParams<
  * @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 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+ * @deprecated 이 함수는 더 이상 사용되지 않습니다. 대신 {@link GoogleAdMob.showAppsInTossAdMob}를 사용해주세요.
  *
  * @example
- * ### 버튼 눌러 불러온 전면 광고 보여주기
+ * ### 버튼 눌러 불러온 광고 보여주기 (showAppsInTossAdMob로 변경 예제)
  * ```tsx
  * import { GoogleAdMob } from '@apps-in-toss/framework';
  * import { useFocusEffect } from '@granite-js/native/@react-navigation/native';
@@ -228,20 +221,20 @@ export type ShowAdMobInterstitialAdParams = AdMobHandlerParams<
  * import { useCallback, useState } from 'react';
  * import { Button, Text, View } from 'react-native';
  *
- * const AD_UNIT_ID = '<AD_UNIT_ID>';
+ * const AD_GROUP_ID = '<AD_GROUP_ID>';
  *
- * export function GoogleAdmobInterstitialAdExample() {
+ * export function GoogleAdmobExample() {
  *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
  *   const navigation = useNavigation();
  *
  *   const loadAd = useCallback(() => {
- *     if (GoogleAdMob.loadAdMobInterstitialAd.isSupported() !== true) {
+ *     if (GoogleAdMob.loadAppsInTossAdMob.isSupported() !== true) {
  *       return;
  *     }
 
- *     const cleanup = GoogleAdMob.loadAdMobInterstitialAd({
+ *     const cleanup = GoogleAdMob.loadAppsInTossAdMob({
  *       options: {
- *         adUnitId: AD_UNIT_ID,
+ *         adGroupId: AD_GROUP_ID,
  *       },
  *       onEvent: (event) => {
  *         switch (event.type) {
@@ -249,27 +242,6 @@ export type ShowAdMobInterstitialAdParams = AdMobHandlerParams<
  *             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) => {
@@ -281,19 +253,45 @@ export type ShowAdMobInterstitialAdParams = AdMobHandlerParams<
  *   }, [navigation]);
  *
  *   const showAd = useCallback(() => {
- *     if (GoogleAdMob.showAdMobInterstitialAd.isSupported() !== true) {
+ *     if (GoogleAdMob.showAppsInTossAdMob.isSupported() !== true) {
  *       return;
  *     }
  *
- *     GoogleAdMob.showAdMobInterstitialAd({
+ *     GoogleAdMob.showAppsInTossAdMob({
  *       options: {
- *         adUnitId: AD_UNIT_ID,
+ *         adGroupId: AD_GROUP_ID,
  *       },
  *       onEvent: (event) => {
  *         switch (event.type) {
  *           case 'requested':
  *             console.log('광고 보여주기 요청 완료');
  *             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 'userEarnedReward':
+ *             console.log('광고 보상 획득 unitType:', event.data.unitType);
+ *             console.log('광고 보상 획득 unitAmount:', event.data.unitAmount);
+ *             break;
+ *
+ *           case 'show':
+ *             console.log('광고 컨텐츠 보여졌음');
+ *             break;
  *         }
  *       },
  *       onError: (error) => {
@@ -366,68 +364,38 @@ export type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOp
  * @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 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+ * @deprecated 이 함수는 더 이상 사용되지 않습니다. 대신 {@link GoogleAdMob.loadAppsInTossAdMob}를 사용해주세요.
  *
  * @example
- *
- * ### 버튼 눌러 불러온 보상형 광고 보여주기
- *
+ * ### 버튼 눌러 불러온 광고 보여주기 (loadAppsInTossAdMob로 변경 예제)
  * ```tsx
  * import { GoogleAdMob } from '@apps-in-toss/framework';
+ * import { useFocusEffect } from '@react-native-bedrock/native/@react-navigation/native';
  * import { useCallback, useState } from 'react';
  * import { Button, Text, View } from 'react-native';
+ * import { useNavigation } from 'react-native-bedrock';
  *
- * const AD_UNIT_ID = '<AD_UNIT_ID>';
+ * const AD_GROUP_ID = '<AD_GROUP_ID>';
  *
- * export function GoogleAdmobRewardedAdExample() {
+ * export function GoogleAdmobExample() {
  *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
+ *   const navigation = useNavigation();
  *
  *   const loadAd = useCallback(() => {
- *     if (GoogleAdMob.loadAdMobRewardedAd.isSupported() !== true) {
+ *     if (GoogleAdMob.loadAppsInTossAdMob.isSupported() !== true) {
  *       return;
  *     }
- *
- *     const cleanup = GoogleAdMob.loadAdMobRewardedAd({
+
+ *     const cleanup = GoogleAdMob.loadAppsInTossAdMob({
  *       options: {
- *         adUnitId: AD_UNIT_ID,
+ *         adGroupId: AD_GROUP_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) => {
@@ -436,22 +404,47 @@ export type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOp
  *     });
  *
  *     return cleanup;
- *   }, []);
+ *   }, [navigation]);
  *
  *   const showAd = useCallback(() => {
- *     if (GoogleAdMob.showAdMobRewardedAd.isSupported() !== true) {
+ *     if (GoogleAdMob.showAppsInTossAdMob.isSupported() !== true) {
  *       return;
  *     }
  *
- *     GoogleAdMob.showAdMobRewardedAd({
+ *     GoogleAdMob.showAppsInTossAdMob({
  *       options: {
- *         adUnitId: AD_UNIT_ID,
+ *         adGroupId: AD_GROUP_ID,
  *       },
  *       onEvent: (event) => {
  *         switch (event.type) {
  *           case 'requested':
  *             console.log('광고 보여주기 요청 완료');
- *             setAdLoadStatus('not_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 'userEarnedReward':
+ *             console.log('광고 보상 획득 unitType:', event.data.unitType);
+ *             console.log('광고 보상 획득 unitAmount:', event.data.unitAmount);
+ *             break;
+ *
+ *           case 'show':
+ *             console.log('광고 컨텐츠 보여졌음');
  *             break;
  *         }
  *       },
@@ -461,6 +454,8 @@ export type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOp
  *     });
  *   }, []);
  *
+ *   useFocusEffect(loadAd);
+ *
  *   return (
  *     <View>
  *       <Text>
@@ -469,7 +464,6 @@ export type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOp
  *         {adLoadStatus === 'failed' && '광고 로드 실패'}
  *       </Text>
  *
- *       <Button title="Load Ad" onPress={loadAd} />
  *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
  *     </View>
  *   );
@@ -539,67 +533,38 @@ export type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOp
  * @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 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+ * @deprecated 이 함수는 더 이상 사용되지 않습니다. 대신 {@link GoogleAdMob.showAppsInTossAdMob}를 사용해주세요.
  *
  * @example
- * ### 버튼 눌러 불러온 보상형 광고 보여주기
- *
+ * ### 버튼 눌러 불러온 광고 보여주기 (showAppsInTossAdMob로 변경 예제)
  * ```tsx
  * import { GoogleAdMob } from '@apps-in-toss/framework';
+ * import { useFocusEffect } from '@react-native-bedrock/native/@react-navigation/native';
  * import { useCallback, useState } from 'react';
  * import { Button, Text, View } from 'react-native';
+ * import { useNavigation } from 'react-native-bedrock';
  *
- * const AD_UNIT_ID = '<AD_UNIT_ID>';
+ * const AD_GROUP_ID = '<AD_GROUP_ID>';
  *
- * export function GoogleAdmobRewardedAdExample() {
+ * export function GoogleAdmobExample() {
  *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
+ *   const navigation = useNavigation();
  *
  *   const loadAd = useCallback(() => {
- *     if (GoogleAdMob.loadAdMobRewardedAd.isSupported() !== true) {
+ *     if (GoogleAdMob.loadAppsInTossAdMob.isSupported() !== true) {
  *       return;
  *     }
- *
- *     const cleanup = GoogleAdMob.loadAdMobRewardedAd({
+
+ *     const cleanup = GoogleAdMob.loadAppsInTossAdMob({
  *       options: {
- *         adUnitId: AD_UNIT_ID,
+ *         adGroupId: AD_GROUP_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) => {
@@ -608,22 +573,47 @@ export type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOp
  *     });
  *
  *     return cleanup;
- *   }, []);
+ *   }, [navigation]);
  *
  *   const showAd = useCallback(() => {
- *     if (GoogleAdMob.showAdMobRewardedAd.isSupported() !== true) {
+ *     if (GoogleAdMob.showAppsInTossAdMob.isSupported() !== true) {
  *       return;
  *     }
  *
- *     GoogleAdMob.showAdMobRewardedAd({
+ *     GoogleAdMob.showAppsInTossAdMob({
  *       options: {
- *         adUnitId: AD_UNIT_ID,
+ *         adGroupId: AD_GROUP_ID,
  *       },
  *       onEvent: (event) => {
  *         switch (event.type) {
  *           case 'requested':
  *             console.log('광고 보여주기 요청 완료');
- *             setAdLoadStatus('not_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 'userEarnedReward':
+ *             console.log('광고 보상 획득 unitType:', event.data.unitType);
+ *             console.log('광고 보상 획득 unitAmount:', event.data.unitAmount);
+ *             break;
+ *
+ *           case 'show':
+ *             console.log('광고 컨텐츠 보여졌음');
  *             break;
  *         }
  *       },
@@ -633,6 +623,8 @@ export type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOp
  *     });
  *   }, []);
  *
+ *   useFocusEffect(loadAd);
+ *
  *   return (
  *     <View>
  *       <Text>
@@ -641,7 +633,6 @@ export type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOp
  *         {adLoadStatus === 'failed' && '광고 로드 실패'}
  *       </Text>
  *
- *       <Button title="Load Ad" onPress={loadAd} />
  *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
  *     </View>
  *   );