시작하기

1. 플러그인 설치

   npm

   npm i @capgo/capacitor-admob

   pnpm

   pnpm add @capgo/capacitor-admob

   yarn

   yarn add @capgo/capacitor-admob

   bun

   bun add @capgo/capacitor-admob

2. 네이티브 프로젝트 동기화

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

SDK 초기화

import { AdMob, MaxAdContentRating } from '@capgo/capacitor-admob';

// 애플리케이션 부트스트랩에서 한 번 Mobile Ads SDK 시작
await AdMob.start();

// 선택 사항: 전역 요청 설정 구성
await AdMob.configure({
  appMuted: false,
  appVolume: 1,
});

await AdMob.configRequest({
  maxAdContentRating: MaxAdContentRating.T,
  tagForChildDirectedTreatment: false,
  tagForUnderAgeOfConsent: false,
});

배너 광고 표시

import { BannerAd } from '@capgo/capacitor-admob';

const banner = new BannerAd({
  adUnitId: 'ca-app-pub-xxxxxxxxxxxxxxxx/banner',
  position: 'bottom',
});

await banner.show();

전면 또는 보상형 광고

import { InterstitialAd, RewardedAd } from '@capgo/capacitor-admob';

const interstitial = new InterstitialAd({
  adUnitId: 'ca-app-pub-xxxxxxxxxxxxxxxx/interstitial',
});
await interstitial.load();
await interstitial.show();

const rewarded = new RewardedAd({
  adUnitId: 'ca-app-pub-xxxxxxxxxxxxxxxx/rewarded',
});
await rewarded.load();
await rewarded.show();

광고 이벤트 수신

import { AdMob } from '@capgo/capacitor-admob';

const handle = await AdMob.addListener('adImpression', (event) => {
  console.log('Ad impression', event);
});

// 나중에 정리할 때
await handle.remove();

플랫폼 참고사항

• iOS: Info.plist에 GADApplicationIdentifier 키 아래에 AdMob 앱 ID를 추가하고 의존하는 SKAdNetwork ID를 포함하세요.
• Android: <application> 태그 내에 com.google.android.gms.ads.APPLICATION_ID를 추가하여 AndroidManifest.xml에 AdMob 앱 ID를 선언하세요.
• 동의 및 개인정보: iOS 14+에서 requestTrackingAuthorization()을 사용하고 configRequest() 어린이 대상 플래그를 사용하여 지역 개인정보 보호 규칙을 준수하세요.