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

package/dist/index.d.cts

@@ -422,6 +422,13 @@ type AdImpression = {
 type AdShow = {
     type: 'show';
 };
+type AdUserEarnedReward = {
+    type: 'userEarnedReward';
+    data: {
+        unitType: string;
+        unitAmount: number;
+    };
+};
 interface AdMobHandlerParams<Options = void, Event = AdMobFullScreenEvent> {
     options: Options;
     onEvent: (event: Event) => void;
@@ -483,6 +490,20 @@ interface RewardedAd {
     adUnitId: string;
     responseInfo: ResponseInfo;
 }
+/**
+ * @public
+ * @category 광고
+ * @name AdMobLoadResult
+ * @description 광고의 ID와 응답 정보를 담고 있는 객체예요. 광고를 로드한 뒤, 관련 정보를 확인할 때 유용해요.
+ * @property {string} adGroupId 광고 그룹 ID예요.
+ * @property {string} adUnitId 광고 ID예요.
+ * @property {ResponseInfo} responseInfo 광고 로드 응답 정보예요. 자세한 내용은 [ResponseInfo](/react-native/reference/framework/광고/ResponseInfo.html)를 참고하세요.
+ */
+interface AdMobLoadResult {
+    adGroupId: string;
+    adUnitId: string;
+    responseInfo: ResponseInfo;
+}
 
 interface LoadAdMobInterstitialAdOptions {
     /**
@@ -511,16 +532,10 @@ type LoadAdMobInterstitialAdParams = AdMobHandlerParams<LoadAdMobInterstitialAdO
  * @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';
@@ -528,20 +543,20 @@ type LoadAdMobInterstitialAdParams = AdMobHandlerParams<LoadAdMobInterstitialAdO
  * 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) {
@@ -549,27 +564,6 @@ type LoadAdMobInterstitialAdParams = AdMobHandlerParams<LoadAdMobInterstitialAdO
  *             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) => {
@@ -581,19 +575,45 @@ type LoadAdMobInterstitialAdParams = AdMobHandlerParams<LoadAdMobInterstitialAdO
  *   }, [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) => {
@@ -648,16 +668,10 @@ type ShowAdMobInterstitialAdParams = AdMobHandlerParams<ShowAdMobInterstitialAdO
  * @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';
@@ -665,20 +679,20 @@ type ShowAdMobInterstitialAdParams = AdMobHandlerParams<ShowAdMobInterstitialAdO
  * 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) {
@@ -686,27 +700,6 @@ type ShowAdMobInterstitialAdParams = AdMobHandlerParams<ShowAdMobInterstitialAdO
  *             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) => {
@@ -718,19 +711,45 @@ type ShowAdMobInterstitialAdParams = AdMobHandlerParams<ShowAdMobInterstitialAdO
  *   }, [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) => {
@@ -788,44 +807,62 @@ type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOptions,
  * @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;
+ *         }
+ *       },
+ *       onError: (error) => {
+ *         console.error('광고 불러오기 실패', error);
+ *       },
+ *     });
+ *
+ *     return cleanup;
+ *   }, [navigation]);
+ *
+ *   const showAd = useCallback(() => {
+ *     if (GoogleAdMob.showAppsInTossAdMob.isSupported() !== true) {
+ *       return;
+ *     }
+ *
+ *     GoogleAdMob.showAppsInTossAdMob({
+ *       options: {
+ *         adGroupId: AD_GROUP_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         switch (event.type) {
+ *           case 'requested':
+ *             console.log('광고 보여주기 요청 완료');
+ *             break;
  *
  *           case 'clicked':
  *             console.log('광고 클릭');
@@ -833,6 +870,7 @@ type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOptions,
  *
  *           case 'dismissed':
  *             console.log('광고 닫힘');
+ *             navigation.navigate('/examples/google-admob-interstitial-ad-landing');
  *             break;
  *
  *           case 'failedToShow':
@@ -843,12 +881,99 @@ type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOptions,
  *             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) => {
+ *         console.error('광고 보여주기 실패', error);
+ *       },
+ *     });
+ *   }, []);
  *
- *           case 'userEarnedReward':
- *             console.log('사용자가 광고 시청을 완료했음');
+ *   useFocusEffect(loadAd);
+ *
+ *   return (
+ *     <View>
+ *       <Text>
+ *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
+ *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
+ *         {adLoadStatus === 'failed' && '광고 로드 실패'}
+ *       </Text>
+ *
+ *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+declare function loadAdMobRewardedAd(params: LoadAdMobRewardedAdParams): () => void;
+declare namespace loadAdMobRewardedAd {
+    var isSupported: () => boolean;
+}
+interface ShowAdMobRewardedAdOptions {
+    /**
+     * 광고 단위 ID
+     */
+    adUnitId: string;
+}
+/**
+ * @public
+ * @category 광고
+ * @name ShowAdMobRewardedAdEvent
+ * @description 보상형 광고를 보여주는 함수에서 발생하는 이벤트 타입이에요. `requested` 이벤트가 발생하면 광고 노출 요청이 Google AdMob에 성공적으로 전달된 거예요.
+ */
+type ShowAdMobRewardedAdEvent = {
+    type: 'requested';
+};
+/**
+ * @public
+ * @category 광고
+ * @name ShowAdMobRewardedAdParams
+ * @description 불러온 보상형 광고를 보여주는 함수에 필요한 옵션 객체예요.
+ */
+type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOptions, ShowAdMobRewardedAdEvent>;
+/**
+ * @public
+ * @category 광고
+ * @name showAdMobRewardedAd
+ * @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_GROUP_ID = '<AD_GROUP_ID>';
+ *
+ * export function GoogleAdmobExample() {
+ *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
+ *   const navigation = useNavigation();
+ *
+ *   const loadAd = useCallback(() => {
+ *     if (GoogleAdMob.loadAppsInTossAdMob.isSupported() !== true) {
+ *       return;
+ *     }
+
+ *     const cleanup = GoogleAdMob.loadAppsInTossAdMob({
+ *       options: {
+ *         adGroupId: AD_GROUP_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         switch (event.type) {
+ *           case 'loaded':
+ *             console.log('광고 로드 성공', event.data);
+ *             setAdLoadStatus('loaded');
  *             break;
  *         }
  *       },
@@ -858,22 +983,47 @@ type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOptions,
  *     });
  *
  *     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;
  *         }
  *       },
@@ -883,6 +1033,8 @@ type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOptions,
  *     });
  *   }, []);
  *
+ *   useFocusEffect(loadAd);
+ *
  *   return (
  *     <View>
  *       <Text>
@@ -891,80 +1043,106 @@ type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOptions,
  *         {adLoadStatus === 'failed' && '광고 로드 실패'}
  *       </Text>
  *
- *       <Button title="Load Ad" onPress={loadAd} />
  *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
  *     </View>
  *   );
  * }
  * ```
  */
-declare function loadAdMobRewardedAd(params: LoadAdMobRewardedAdParams): () => void;
-declare namespace loadAdMobRewardedAd {
+declare function showAdMobRewardedAd(params: ShowAdMobRewardedAdParams): () => void;
+declare namespace showAdMobRewardedAd {
     var isSupported: () => boolean;
 }
-interface ShowAdMobRewardedAdOptions {
+
+interface LoadAdMobOptions {
     /**
-     * 광고 단위 ID
+     * 광고 그룹 단위 ID
      */
-    adUnitId: string;
+    adGroupId: string;
 }
 /**
  * @public
  * @category 광고
- * @name ShowAdMobRewardedAdEvent
- * @description 보상형 광고를 보여주는 함수에서 발생하는 이벤트 타입이에요. `requested` 이벤트가 발생하면 광고 노출 요청이 Google AdMob에 성공적으로 전달된 거예요.
+ * @name LoadAdMobEvent
+ * @description 광고를 불러오는 함수에서 발생하는 이벤트 타입이에요. `loaded` 이벤트가 발생하면 광고를 성공적으로 불러온 거예요. 이때 [AdMobLoadResult](/react-native/reference/framework/광고/AdMobLoadResult.html) 객체가 함께 반환돼요.
  */
-type ShowAdMobRewardedAdEvent = {
-    type: 'requested';
+type LoadAdMobEvent = {
+    type: 'loaded';
+    data: AdMobLoadResult;
 };
 /**
  * @public
  * @category 광고
- * @name ShowAdMobRewardedAdParams
- * @description 불러온 보상형 광고를 보여주는 함수에 필요한 옵션 객체예요.
+ * @name LoadAdMobParams
+ * @description 광고를 불러오는 함수에 필요한 옵션 객체예요.
  */
-type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOptions, ShowAdMobRewardedAdEvent>;
+type LoadAdMobParams = AdMobHandlerParams<LoadAdMobOptions, LoadAdMobEvent>;
 /**
  * @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)를 참고하세요.
+ * @name loadAppsInTossAdMob
+ * @description 광고를 미리 불러와서, 광고가 필요한 시점에 바로 보여줄 수 있도록 준비하는 함수예요.
+ * @param {LoadAdMobParams} params 광고를 불러올 때 사용할 설정 값이에요. 광고 그룹 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
+ * @param {LoadAdMobOptions} params.options 광고를 불러올 때 전달할 옵션 객체예요.
+ * @param {string} params.options.adGroupId 광고 그룹 단위 ID예요. 콘솔에서 발급받은 ID를 입력해요.
+ * @param {(event: LoadAdMobEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고가 닫히거나 클릭됐을 때). 자세한 이벤트 타입은 [LoadAdMobEvent](/react-native/reference/framework/광고/LoadAdMobEvent.html)를 참고하세요.
  * @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
  * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
  *
  * @example
- * ### 버튼 눌러 불러온 보상형 광고 보여주기
- *
+ * ### 버튼 눌러 불러온 광고 보여주기
  * ```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;
+ *         }
+ *       },
+ *       onError: (error) => {
+ *         console.error('광고 불러오기 실패', error);
+ *       },
+ *     });
+ *
+ *     return cleanup;
+ *   }, [navigation]);
+ *
+ *   const showAd = useCallback(() => {
+ *     if (GoogleAdMob.showAppsInTossAdMob.isSupported() !== true) {
+ *       return;
+ *     }
+ *
+ *     GoogleAdMob.showAppsInTossAdMob({
+ *       options: {
+ *         adGroupId: AD_GROUP_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         switch (event.type) {
+ *           case 'requested':
+ *             console.log('광고 보여주기 요청 완료');
+ *             break;
  *
  *           case 'clicked':
  *             console.log('광고 클릭');
@@ -972,6 +1150,7 @@ type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOptions,
  *
  *           case 'dismissed':
  *             console.log('광고 닫힘');
+ *             navigation.navigate('/examples/google-admob-interstitial-ad-landing');
  *             break;
  *
  *           case 'failedToShow':
@@ -982,12 +1161,105 @@ type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOptions,
  *             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) => {
+ *         console.error('광고 보여주기 실패', error);
+ *       },
+ *     });
+ *   }, []);
  *
- *           case 'userEarnedReward':
- *             console.log('사용자가 광고 시청을 완료했음');
+ *   useFocusEffect(loadAd);
+ *
+ *   return (
+ *     <View>
+ *       <Text>
+ *         {adLoadStatus === 'not_loaded' && '광고 로드 하지 않음 '}
+ *         {adLoadStatus === 'loaded' && '광고 로드 완료'}
+ *         {adLoadStatus === 'failed' && '광고 로드 실패'}
+ *       </Text>
+ *
+ *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+declare function loadAppsInTossAdMob(params: LoadAdMobParams): () => void;
+declare namespace loadAppsInTossAdMob {
+    var isSupported: () => boolean;
+}
+interface ShowAdMobOptions {
+    /**
+     * 광고 그룹 단위 ID
+     */
+    adGroupId: string;
+}
+/**
+ * @public
+ * @category 광고
+ * @name ShowAdMobEvent
+ * @description 광고를 보여주는 함수에서 발생하는 이벤트 타입이에요. `requested` 이벤트가 발생하면 광고 노출 요청이 Google AdMob에 성공적으로 전달된 거예요.
+ */
+type ShowAdMobEvent = AdMobFullScreenEvent | AdUserEarnedReward | {
+    type: 'requested';
+};
+/**
+ * @public
+ * @category 광고
+ * @name ShowAdMobParams
+ * @description 불러온 광고를 보여주는 함수에 필요한 옵션 객체예요.
+ */
+type ShowAdMobParams = AdMobHandlerParams<ShowAdMobOptions, ShowAdMobEvent>;
+/**
+ * @public
+ * @category 광고
+ * @name showAppsInTossAdMob
+ * @description 광고를 사용자에게 노출해요. 이 함수는 `loadAppsInTossAdMob` 로 미리 불러온 광고를 실제로 사용자에게 노출해요.
+ * @param {ShowAdMobParams} params 광고를 보여주기 위해 사용할 설정 값이에요. 광고 그룹 ID와과 광고의 동작에 대한 콜백을 설정할 수 있어요.
+ * @param {ShowAdMobOptions} params.options 광고를 보여줄 때 전달할 옵션 객체예요.
+ * @param {string} params.options.adUnitId 광고 그룹 단위 ID예요. `loadAppsInTossAdMob` 로 불러온 광고용 그룹 ID를 입력해요.
+ * @param {(event: ShowAdMobEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고 노출을 요청했을 때). 자세한 이벤트 타입은 [ShowAdMobEvent](/react-native/reference/framework/광고/ShowAdMobEvent.html)를 참고하세요.
+ * @param {(reason: unknown) => void} [params.onError] 광고를 노출하지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
+ * @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
+ *
+ * @example
+ * ### 버튼 눌러 불러온 광고 보여주기
+ * ```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_GROUP_ID = '<AD_GROUP_ID>';
+ *
+ * export function GoogleAdmobExample() {
+ *   const [adLoadStatus, setAdLoadStatus] = useState<'not_loaded' | 'loaded' | 'failed'>('not_loaded');
+ *   const navigation = useNavigation();
+ *
+ *   const loadAd = useCallback(() => {
+ *     if (GoogleAdMob.loadAppsInTossAdMob.isSupported() !== true) {
+ *       return;
+ *     }
+
+ *     const cleanup = GoogleAdMob.loadAppsInTossAdMob({
+ *       options: {
+ *         adGroupId: AD_GROUP_ID,
+ *       },
+ *       onEvent: (event) => {
+ *         switch (event.type) {
+ *           case 'loaded':
+ *             console.log('광고 로드 성공', event.data);
+ *             setAdLoadStatus('loaded');
  *             break;
  *         }
  *       },
@@ -997,22 +1269,47 @@ type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOptions,
  *     });
  *
  *     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;
  *         }
  *       },
@@ -1022,6 +1319,8 @@ type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOptions,
  *     });
  *   }, []);
  *
+ *   useFocusEffect(loadAd);
+ *
  *   return (
  *     <View>
  *       <Text>
@@ -1030,15 +1329,14 @@ type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOptions,
  *         {adLoadStatus === 'failed' && '광고 로드 실패'}
  *       </Text>
  *
- *       <Button title="Load Ad" onPress={loadAd} />
  *       <Button title="Show Ad" onPress={showAd} disabled={adLoadStatus !== 'loaded'} />
  *     </View>
  *   );
  * }
  * ```
  */
-declare function showAdMobRewardedAd(params: ShowAdMobRewardedAdParams): () => void;
-declare namespace showAdMobRewardedAd {
+declare function showAppsInTossAdMob(params: ShowAdMobParams): () => void;
+declare namespace showAppsInTossAdMob {
     var isSupported: () => boolean;
 }
 
@@ -2344,12 +2642,16 @@ declare const TossPay: {
  * @property {typeof showAdMobInterstitialAd} [showAdMobInterstitialAd] 로드한 전면 광고를 보여주는 함수예요. 자세한 내용은 [showAdMobInterstitialAd](/react-native/reference/native-modules/광고/showAdMobInterstitialAd.html)를 참고하세요.
  * @property {typeof loadAdMobRewardedAd} [loadAdMobRewardedAd] 보상형 광고를 로드하는 함수예요. 자세한 내용은 [loadAdMobRewardedAd](/react-native/reference/native-modules/광고/loadAdMobRewardedAd.html)를 참고하세요.
  * @property {typeof showAdMobRewardedAd} [showAdMobRewardedAd] 로드한 보상형 광고를 보여주는 함수예요. 자세한 내용은 [showAdMobRewardedAd](/react-native/reference/native-modules/광고/showAdMobRewardedAd.html)를 참고하세요.
+ * @property {typeof loadAppsInTossAdMob} [loadAppsInTossAdMob] 광고를 로드하는 함수예요. 자세한 내용은 [loadAppsInTossAdMob](/react-native/reference/native-modules/광고/loadAppsInTossAdMob.html)를 참고하세요.
+ * @property {typeof showAppsInTossAdMob} [showAppsInTossAdMob] 로드한 광고를 보여주는 함수예요. 자세한 내용은 [showAppsInTossAdMob](/react-native/reference/native-modules/광고/showAppsInTossAdMob.html)를 참고하세요.
  */
 declare const GoogleAdMob: {
     loadAdMobInterstitialAd: typeof loadAdMobInterstitialAd;
     showAdMobInterstitialAd: typeof showAdMobInterstitialAd;
     loadAdMobRewardedAd: typeof loadAdMobRewardedAd;
     showAdMobRewardedAd: typeof showAdMobRewardedAd;
+    loadAppsInTossAdMob: typeof loadAppsInTossAdMob;
+    showAppsInTossAdMob: typeof showAppsInTossAdMob;
 };
 
 /**
@@ -2817,4 +3119,4 @@ declare const INTERNAL__module: {
     tossCoreEventLog: typeof tossCoreEventLog;
 };
 
-export { Accuracy, AppsInTossModule, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type ContactEntity, type ContactResult, type ContactsViralParams, type EventLogParams, type FetchAlbumPhotosOptions, type GameCenterGameProfileResponse, type GetCurrentLocationOptions, GoogleAdMob, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type ImageResponse, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type Location, type LocationCoords, type NetworkStatus, type OpenCameraOptions, type PermissionAccess, type PermissionName, type PermissionStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, type StartUpdateLocationOptions$1 as StartUpdateLocationOptions, type StartUpdateLocationSubscription, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };
+export { Accuracy, AppsInTossModule, BedrockCoreModule, BedrockModule, type CheckoutPaymentOptions, type CheckoutPaymentResult, type ContactEntity, type ContactResult, type ContactsViralParams, type EventLogParams, type FetchAlbumPhotosOptions, type GameCenterGameProfileResponse, type GetCurrentLocationOptions, GoogleAdMob, type HapticFeedbackType, IAP, AppsInTossModuleInstance as INTERNAL__AppsInTossModule, INTERNAL__module, type IapCreateOneTimePurchaseOrderOptions, type IapCreateOneTimePurchaseOrderResult, type IapProductListItem, type ImageResponse, type LoadAdMobEvent, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobOptions, type LoadAdMobParams, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type Location, type LocationCoords, type NetworkStatus, type OpenCameraOptions, type PermissionAccess, type PermissionName, type PermissionStatus, type Primitive, type SaveBase64DataParams, type ShowAdMobEvent, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobOptions, type ShowAdMobParams, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, type StartUpdateLocationOptions$1 as StartUpdateLocationOptions, type StartUpdateLocationSubscription, Storage, type SubmitGameCenterLeaderBoardScoreResponse, TossPay, type UpdateLocationEventEmitter, appLogin, appsInTossEvent, closeView, contactsViral, eventLog, fetchAlbumPhotos, fetchContacts, generateHapticFeedback, getClipboardText, getCurrentLocation, getDeviceId, getGameCenterGameProfile, getLocale, getNetworkStatus, getOperationalEnvironment, getPlatformOS, getSchemeUri, getTossAppVersion, getTossShareLink, isMinVersionSupported, onVisibilityChangedByTransparentServiceWeb, openCamera, openGameCenterLeaderboard, openURL, saveBase64Data, setClipboardText, setDeviceOrientation, setIosSwipeGestureEnabled, setScreenAwakeMode, setSecureScreen, share, startUpdateLocation, submitGameCenterLeaderBoardScore };