Skip to content

Getting Started

GitHub

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.

만약 Manual Setup을 선호한다면, 플러그인을 설치하기 위해 다음 명령어를 실행하고 아래 플랫폼별 지침을 따르세요:

터미널 창
bun add @capgo/capacitor-admob
bunx cap sync
import { AdMob } from '@capgo/capacitor-admob';

SDK 초기화 및 시작

import { AdMob } from '@capgo/capacitor-admob';
await AdMob.start();

configure

설정 섹션

AdMob 설정 구성

import { AdMob } from '@capgo/capacitor-admob';
await AdMob.configure({
appMuted: false,
appVolume: 0.5
});

configRequest

configRequest

광고 요청 설정을 구성합니다.

import { AdMob } from '@capgo/capacitor-admob';
await AdMob.configRequest({
maxAdContentRating: MaxAdContentRating.PG,
tagForChildDirectedTreatment: true,
testDeviceIds: ['test-device-id']
});

adCreate

adCreate

새로운 광고 인스턴스를 생성합니다.

import { AdMob } from '@capgo/capacitor-admob';
await AdMob.adCreate({
adUnitId: 'ca-app-pub-3940256099942544/1033173712'
});

adIsLoaded

adIsLoaded

광고가 로드되어 표시할 준비가 된지 확인합니다.

import { AdMob } from '@capgo/capacitor-admob';
const isLoaded = await AdMob.adIsLoaded({ id: 1 });
if (isLoaded) {
await AdMob.adShow({ id: 1 });
}

adLoad

adLoad

광고를 로드합니다.

import { AdMob } from '@capgo/capacitor-admob';
await AdMob.adLoad({ id: 1 });

로드된 광고를 표시합니다.

import { AdMob } from '@capgo/capacitor-admob';
await AdMob.adShow({ id: 1 });

현재 표시 중인 광고를 숨깁니다.

import { AdMob } from '@capgo/capacitor-admob';
await AdMob.adHide({ id: 1 });

trackingAuthorizationStatus

trackingAuthorizationStatus 제목

iOS에서만 현재 추적 권한 상태를 가져옵니다.

import { AdMob } from '@capgo/capacitor-admob';
const { status } = await AdMob.trackingAuthorizationStatus();
if (status === TrackingAuthorizationStatus.notDetermined) {
await AdMob.requestTrackingAuthorization();
}

requestTrackingAuthorization

requestTrackingAuthorization 제목

iOS에서만 사용자에게 추적 권한을 요청합니다.

import { AdMob } from '@capgo/capacitor-admob';
const { status } = await AdMob.requestTrackingAuthorization();
console.log('User tracking status:', status);

AdMob 구성 옵션

export type AdMobConfig = {
/** Whether the app should be muted */
appMuted?: boolean;
/** The app volume (0.0 to 1.0) */
appVolume?: number;
};

광고 요청 구성

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[];
};

모바일 광고 기본 옵션

export type MobileAdOptions = {
/** The ad unit ID from AdMob */
adUnitId: string;
};

TrackingAuthorizationStatus

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 = '',
}

Source Of Truth

Source Of Truth

이 페이지는 플러그인의 src/definitions.tspublic API이 upstream에서 변경될 때 다시 싱크를 실행하세요.

Getting Started에서 계속하기

Getting Started에서 계속하기

이 기능을 사용 중이라면 시작하기 대시보드와 API 기능을 계획하고 운영하기 위해 native 기능을 사용하기 위해 @capgo/capacitor-admob Using @capgo/capacitor-admob API 개요 API Overview 소개 소개 API 키 API Keys 기기 장치에 대한 구현 세부 정보.