시작하기
설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 지시를 복사하세요.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-admob`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/admob/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
Capgo의 AI-Assisted Setup을 사용하여 플러그인을 설치할 수 있습니다. AI 도구에 Capgo 스킬을 추가하려면 다음 명령어를 사용하세요.
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins다음 명령어를 사용하여 플러그인을 설치하고 플랫폼에 따라 다음 지침을 따르세요.
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-admob` plugin in my project.복사
bun add @capgo/capacitor-admobbunx cap syncImport
__CAPGO_KEEP_0__을 가져오기import { AdMob } from '@capgo/capacitor-admob';API 개요
API 개요start
__CAPGO_KEEP_0__ 시작SDK를 초기화하고 시작합니다.
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.start();configure
__CAPGO_KEEP_0__ 설정__CAPGO_KEEP_0__ 설정
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.configure({ appMuted: false, appVolume: 0.5});configRequest
__CAPGO_KEEP_0__ 설정 요청__CAPGO_KEEP_0__ 설정을 구성합니다.
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.configRequest({ maxAdContentRating: MaxAdContentRating.PG, tagForChildDirectedTreatment: true, testDeviceIds: ['test-device-id']});adCreate
__CAPGO_KEEP_1__ 섹션__CAPGO_KEEP_2__ 광고 인스턴스를 새로 생성합니다.
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.adCreate({ adUnitId: 'ca-app-pub-3940256099942544/1033173712'});adIsLoaded
__CAPGO_KEEP_3__ 섹션__CAPGO_KEEP_4__이 로드되었는지 확인합니다.
import { AdMob } from '@capgo/capacitor-admob';
const isLoaded = await AdMob.adIsLoaded({ id: 1 });if (isLoaded) { await AdMob.adShow({ id: 1 });}adLoad
__CAPGO_KEEP_5__ 섹션__CAPGO_KEEP_6__을 로드합니다.
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.adLoad({ id: 1 });adShow
__CAPGO_KEEP_7__ 섹션__CAPGO_KEEP_0__을 로드된 광고를 표시합니다.
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.adShow({ id: 1 });adHide
__CAPGO_KEEP_0__ 섹션__CAPGO_KEEP_0__ 현재 표시 중인 광고를 숨깁니다.
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.adHide({ id: 1 });trackingAuthorizationStatus
__CAPGO_KEEP_0__ 섹션__CAPGO_KEEP_0__ (iOS만 지원합니다.)
import { AdMob } from '@capgo/capacitor-admob';
const { status } = await AdMob.trackingAuthorizationStatus();if (status === TrackingAuthorizationStatus.notDetermined) { await AdMob.requestTrackingAuthorization();}requestTrackingAuthorization
__CAPGO_KEEP_0__ 섹션__CAPGO_KEEP_0__ (iOS만 지원합니다.)
import { AdMob } from '@capgo/capacitor-admob';
const { status } = await AdMob.requestTrackingAuthorization();console.log('User tracking status:', status);__CAPGO_KEEP_0__
타입 참조 섹션AdMobConfig
광고 모바일 구성 섹션광고 모바일 구성 옵션
export type AdMobConfig = { /** Whether the app should be muted */ appMuted?: boolean; /** The app volume (0.0 to 1.0) */ appVolume?: number;};RequestConfig
광고 요청 구성 섹션광고 요청 구성
export type RequestConfig = { /** Maximum ad content rating */ maxAdContentRating?: MaxAdContentRating; /** Whether to use the same app key */ sameAppKey?: boolean; /** Tag for child-directed treatment (true, false, or null for unspecified) */ tagForChildDirectedTreatment?: boolean | null; /** Tag for under age of consent (true, false, or null for unspecified) */ tagForUnderAgeOfConsent?: boolean | null; /** Array of test device IDs */ testDeviceIds?: string[];};MobileAdOptions
모바일 광고 옵션 섹션모바일 광고 기본 옵션
export type MobileAdOptions = { /** The ad unit ID from AdMob */ adUnitId: string;};TrackingAuthorizationStatus
앱 추적 허용 상태 섹션iOS 앱 추적 허용 상태
export enum TrackingAuthorizationStatus { /** User has not yet received an authorization request */ notDetermined = 0, /** User restricted, device is unable to provide authorization */ restricted = 1, /** User denied authorization */ denied = 2, /** User authorized access */ authorized = 3,}MaxAdContentRating
MaxAdContentRating 섹션광고 콘텐츠 등급을 기반으로 광고를 제한하는 데 사용되는 최대 광고 콘텐츠 등급 열거형.
export enum MaxAdContentRating { /** General Audiences */ G = 'G', /** Mature Audiences */ MA = 'MA', /** Parental Guidance */ PG = 'PG', /** Teen */ T = 'T', /** Unspecified rating */ UNSPECIFIED = '',}실제 데이터 원
실제 데이터 원 섹션이 페이지는 플러그인의 src/definitions.ts. upstream에서 API가 변경될 때마다 다시 동기화할 수 있습니다.
Getting Started에서 계속
Getting Started에서 계속 섹션Capacitor를 사용 중이라면 Getting Started에서 시작 대시보드와 API 운영을 계획하고 연결하세요. Using @capgo/capacitor-admob Using @capgo/capacitor-admob API 개요 Capacitor API Overview 소개 소개 API 키 Capacitor API Keys 장치 Capacitor Devices