Démarrage
Copiez une commande de configuration avec les étapes d'installation et le guide markdown complet pour ce plugin.
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.
Installer
Installationbun add @capgo/capacitor-admobbunx cap syncImporter
Section intitulée « Importer »import { AdMob } from '@capgo/capacitor-admob';API Vue d'ensemble
Section intitulée « API Vue d'ensemble »Initialiser et démarrer l'SDK AdMob.
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.start();configure
Section intitulée « configurer »Configurer les paramètres AdMob.
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.configure({ appMuted: false, appVolume: 0.5});configRequest
Section intitulée « configRequest »Configurer les paramètres de demande publicitaire.
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.configRequest({ maxAdContentRating: MaxAdContentRating.PG, tagForChildDirectedTreatment: true, testDeviceIds: ['test-device-id']});adCreate
Section intitulée « adCreate »Créer une nouvelle instance publicitaire.
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.adCreate({ adUnitId: 'ca-app-pub-3940256099942544/1033173712'});Copier dans le presse-papier
import { AdMob } from '@capgo/capacitor-admob';
const isLoaded = await AdMob.adIsLoaded({ id: 1 });if (isLoaded) { await AdMob.adShow({ id: 1 });}adLoad
Charger une publicité.Copier dans le presse-papier
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.adLoad({ id: 1 });Afficher une publicité chargée.
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.adShow({ id: 1 });Cacher une publicité affichée actuellement.
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.adHide({ id: 1 });trackingAuthorizationStatus
Section intitulée « trackingAuthorizationStatus »Obtenir le statut actuel d'autorisation de suivi (seulement iOS).
import { AdMob } from '@capgo/capacitor-admob';
const { status } = await AdMob.trackingAuthorizationStatus();if (status === TrackingAuthorizationStatus.notDetermined) { await AdMob.requestTrackingAuthorization();}requestTrackingAuthorization
Section intitulée « requestTrackingAuthorization »Demander à l'utilisateur l'autorisation de suivi (seulement iOS).
import { AdMob } from '@capgo/capacitor-admob';
const { status } = await AdMob.requestTrackingAuthorization();console.log('User tracking status:', status);Référence de type
Section intitulée « Référence de type »AdMobConfig
Section intitulée « AdMobConfig »Options de configuration pour AdMob.
export type AdMobConfig = { /** Whether the app should be muted */ appMuted?: boolean; /** The app volume (0.0 to 1.0) */ appVolume?: number;};RequestConfig
Section intitulée « RequestConfig »Configuration pour les requêtes publicitaires.
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
Section intitulée « MobileAdOptions »Options de base pour les publicités mobiles.
export type MobileAdOptions = { /** The ad unit ID from AdMob */ adUnitId: string;};TrackingAuthorizationStatus
Section intitulée “État de l'autorisation de suivi”État d'autorisation de suivi pour l'application iOS de transparence de suivi.
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
Section intitulée “Évaluation maximale du contenu publicitaire”Énumération de l'évaluation maximale du contenu publicitaire utilisée pour restreindre les publicités en fonction de l'évaluation du contenu.
export enum MaxAdContentRating { /** General Audiences */ G = 'G', /** Mature Audiences */ MA = 'MA', /** Parental Guidance */ PG = 'PG', /** Teen */ T = 'T', /** Unspecified rating */ UNSPECIFIED = '',}Source De Vérité
Section intitulée “Source De Vérité”Cette page est générée à partir du plugin's. Re-run la synchronisation lorsque les modifications publiques __CAPGO_KEEP_0__ changent en amont. src/definitions.ts. Re-run the sync when the public API changes upstream.